2026年7月27日

CursorとNotionをMCPで連携!セットアップから実践ワークフローまで

CursorでNotionの情報を直接参照?MCP連携の基本と価値

公式画面

MCPとは何か:AIエディタと外部ツールをつなぐプロトコル

室谷室谷代表取締役
MCP、知ってます?Model Context Protocol。AIエディタが外部のツールやデータとやりとりするための共通規格です。

Cursorも対応してます。
テキトー教師テキトー教師.AI認定講師
そうなんですよ。要は、エディタのAIが直接NotionやGitHubにアクセスできるようになるプロトコル。

いちいちコピペしなくて済む。
室谷室谷代表取締役
これ、効率に直結しますね。Cursorでコード書きながらNotionのPRDを参照したい。

その「ながら」ができるかどうかで生産性が変わる。

CursorでのNotion MCP実現イメージ

室谷室谷代表取締役
実際、コミュニティでいくつかMCPサーバーが公開されてます。Cursorの公式フォーラムでも紹介されてるやつが。
テキトー教師テキトー教師.AI認定講師
例えば、GitHubで公開されてるmcp-notion-serverっていうのを使うと、CursorからNotionのページを検索したり読んだりできるようになる。
室谷室谷代表取締役
さらに、Apifyでホストされてるクラウド版もある。ローカルでサーバー立ち上げなくていい。

Bearer認証でセキュアに。
テキトー教師テキトー教師.AI認定講師
なるほど。ローカルとクラウド、選べるんですね。

環境によって使い分けられそうです。

なぜ今Notion MCPなのか:開発効率向上の具体例

室谷室谷代表取締役
たとえば、新しい機能の実装時にPRDを参照する。今まではNotionを開いて確認して戻る、の往復。

これ、めちゃくちゃ時間食うんですよね。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのは、要件の解釈違いが発生するって話。Cursorが直接PRDを読んでコード生成してくれれば、そのズレが減る。
室谷室谷代表取締役
時間単価で換算すると、この往復コストって塵積もって月何時間分かになる。ROIで見れば導入しない理由がない。
テキトー教師テキトー教師.AI認定講師
まだ「お試し中」のフェーズのチームも多いですけど、実際に使い始めると戻れなくなりますよ。

Notion MCPのセットアップ手順:ローカルサーバーとクラウドホスティング

Notion MCPのセットアップ方法比較
ローカルサーバー
  • プロジェクトをクローンしてnpmビルド
  • Integration Tokenを発行し環境変数に設定
  • ターミナルを毎回起動する必要あり
  • 手間がかかるが安定して動作
  • 開発チームで共有する場合はトークン管理が必要
クラウドホスティング(Apify)
  • Apifyでワンクリックデプロイ
  • SSE URLとBearer Tokenをメモするだけ
  • ターミナル不要で手軽
  • Free tierで個人利用十分
  • 5分以内でセットアップ完了

ローカルで動かす:npmビルドとIntegration Token設定

室谷室谷代表取締役
まずローカルで動かす方法です。GitHubからクローンしてnpm install → npm run build。

つまずきやすいのはトークンの発行ですね。
テキトー教師テキトー教師.AI認定講師
そこは最初に戸惑うポイントです。Notionのインテグレーションページから新規作成して、読み書き権限をつけてトークンをコピーする。

それを環境変数に設定する流れです。
室谷室谷代表取締役
これ、一見手間ですけど一度設定すれば安定します。開発チームで共有する場合、トークンの管理方法だけ決めておけば問題ないですね。

クラウド版を使う:ApifyでホスティングされたSSEサーバー

テキトー教師テキトー教師.AI認定講師
ローカルで動かすのは手軽ですが、毎回ターミナルを立ち上げるのが面倒という人にはApifyのホスティング版があります。
室谷室谷代表取締役
そうそう、これが便利。ApifyのFree tierで個人利用なら十分。

SSEで転送するので、PUTやGETの待ち時間も気になりません。Bear認証でセキュアですし。
テキトー教師テキトー教師.AI認定講師
デプロイはApifyのページからワンクリックです。設定はSSEのURLとBearerトークンをメモしておくだけ。

慣れれば5分かからないと思います。

CursorのMCP設定画面への追加方法

室谷室谷代表取締役
で、どちらの方法にせよ、最後にCursor側の設定が必要です。
テキトー教師テキトー教師.AI認定講師
Cursorの設定 → Features → MCP Servers で設定画面を開きます。JSONを直接編集するか、GUIで追加します。
室谷室谷代表取締役
ローカルの場合はcommandをnode、argsにビルド後のパスを指定。クラウドの場合はurlとheadersを書くだけ。

この辺りはドキュメント通りで問題ないですね。
室谷室谷代表取締役
設定後、リロードするとツール一覧にNotionが表示されるはずです。表示されなければログを確認して、トークンかパスが間違ってないかチェックですね。

実践ワークフロー:PRDや議事録をCursorに取り込む

実践ワークフロー:PRDや議事録をCursorに取り込む
  1. 1
    PRD文書を読み込んでコードに反映
    Notion MCPでPRDのテキストや画像を参照し、Cursorに読み込ませる。要件解釈の齟齬が減る。
  2. 2
    会議メモからToDoを自動生成
    会議後のNotionメモをCursorに読ませ、ToDoリストを自動生成。手動のタスク整理が5秒で完了。
  3. 3
    タスクデータベースをCursorで操作
    コード書きながらNotionのタスクDBを直接更新。バグレポートの追加やタスク管理をCursor上で実行。

PRD文書を読み込んでコードに反映

室谷室谷代表取締役
シリコンバレーだと、PRDを直接Cursorに読み込ませてコードを書くのが当たり前になりつつあります。Notion MCPでPRDのテキストや画像をそのまま参照できる。
テキトー教師テキトー教師.AI認定講師
最初に「どうやってPRDの内容をコードに反映するの?」と現場でよく聞かれます。でもMCPの設定さえ終われば、Cursorに「このNotionページを読んで」と言うだけでコンテキストに入る。
室谷室谷代表取締役
MYUUUでも新機能の開発時にPRDを読ませてます。要件解釈の齟齬が減るのが一番のメリット。

時給換算で考えると、1回のミーティング削減で月額20ドルなんてすぐペイします。
テキトー教師テキトー教師.AI認定講師
たしかに、PRDとコードの行き来が減るのは大きいですね。初心者でも「/notion read ページURL」のように呼び出せば即座に内容を展開してくれる。

会議メモからToDoを自動生成

テキトー教師テキトー教師.AI認定講師
よくあるのが、会議後にNotionに書いたメモをCursorに読ませて、ToDoリストを自動生成するワークフロー。手動でタスクを起こす手間が省けます。
室谷室谷代表取締役
あれ、時間対効果が半端ない。うちの現場だと、ミーティング後のタスク整理が5分かかってたのが5秒で終わる。

ROIで言うと一日あたりの節約時間がかなり大きい。
テキトー教師テキトー教師.AI認定講師
ただ、Notionのデータベース構造がきれいになってないとうまく動かないことも。例えば「タスク」データベースに必須カラムがあると、それに合わせたプロンプトが必要です。
室谷室谷代表取締役
そこはプロンプトテンプレートを用意しておくといいですね。「この会議メモからタスクを抽出して、Tasks DBの該当プロパティにマッピングして」みたいな。

タスクデータベースをCursorで操作

室谷室谷代表取締役
タスク管理のNotion DBをCursorから直接更新できるのは、開発フローを止めない点で大きい。コード書きながら「あ、バグ見つけた」と思ったらその場でDBに追加できる。
テキトー教師テキトー教師.AI認定講師
「新しいバグレポートをTasksデータベースに作成して」と伝えるだけで、タイトルや優先度を自動で設定してくれます。最初は感動しますね。
室谷室谷代表取締役
チームで使うなら権限周りだけ注意。Notion Integrationトークンを使ってアクセスするので、読み取り専用と書き込み可能を分けて管理したほうがいい。
テキトー教師テキトー教師.AI認定講師
そこは環境変数で切り替えられるので、個人開発ならFull Accessでも問題ないです。まずは自分用に試してみるのがおすすめです。

よくあるトラブルと解決策:OAuthエラーやツール読み込み停止

代替MCPサーバーの比較
ローカルnpmベース
  • OAuth不要で直接トークン認証
  • 読み込み停止問題が起きにくい
  • サーバーを立ち上げ続ける必要あり
  • Notion Integration Tokenを発行
  • claude_desktop_config.jsonに設定
Apifyクラウド版
  • SSE通信、Bearer認証付き
  • 常時接続不要
  • ターミナルを開かなくてよい
  • チームで共有しやすい
  • 公式MCPより安定との声

OAuth完了後に0ツールとなる問題

室谷室谷代表取締役
これ、フォーラムでも報告が相次いでいるんですが、Notion MCPのOAuth flow自体は通るのに、Cursor側でツールが0個になって読み込みが止まる現象ですね。
テキトー教師テキトー教師.AI認定講師
そうなんです。初めて触る人ほど「何か間違えたかな」って思うポイントなんですが、ログを見るとNo server info foundSaving tokensがループしてるんですよね。
室谷室谷代表取締役
僕もMYUUUの現場で試したんですが、OAuth後に”loading tools”のまま進まない。VS Code + Copilotでは普通に動くので、Cursor 2.2.43でのMCP transportの実装に問題があると踏んでます。
テキトー教師テキトー教師.AI認定講師
たしかに、他のMCPサーバーでは起きないケースも多いので、Notionの公式MCP特有の相性かもしれません。

Cursorバージョン2.2.43での不具合

室谷室谷代表取締役
このバグ、macOSだけでなくWindowsでも確認されているんですよ。報告によると、OAuth完了後にtransportエラーが連発して、ツールの一覧取得ができない状態ですね。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのは「バージョンアップしたら動かなくなった」という話。2.2.43で何か変わった可能性があります。
室谷室谷代表取締役
運営には報告済みですが、すぐに修正が来るかは分からない。個人的にはこのバージョンでNotion MCPに依存するのはリスクだと思っています。
テキトー教師テキトー教師.AI認定講師
当面は別の実装を試すか、アップデートを待つか、ですね。

代替手段:別のMCPサーバーを試す

室谷室谷代表取締役
じゃあ、実際に動く代替案を2つ。1つはローカルで動かすnpmベースのサーバー。

github.com/arre-ankit/notion-mcp-serverからクローンして、npm installしてnpm run build。設定はNotionのIntegration Tokenを発行して、claude_desktop_config.jsonに書くだけ。
テキトー教師テキトー教師.AI認定講師
これ、OAuth不要で直接トークン認証なので、先ほどのような読み込み停止問題は起きにくいです。ただしローカルでサーバーを立ち上げ続ける必要があります。
室谷室谷代表取締役
もう1つは、Apify上でホストされたクラウド版。SSE通信で、Bearer認証付き。

設定もmcpServersにURLとヘッダーを書くだけで、ターミナルを開かなくていい。
テキトー教師テキトー教師.AI認定講師
クラウド版だと「常時接続」が不要で、チームで共有もしやすい。どちらも公式MCPより安定しているという声を聞きますね。

}

応用編:カスタムMCPツールで業務特化型ワークフロー

Notion MCPサーバーに独自ツールを追加

室谷室谷代表取締役
標準のNotion MCPでも結構使えるんですけど、現場で「これもできたらな」って要望が出てくるんですよね。社内フォーマットの議事録を自動生成するツールとか。
テキトー教師テキトー教師.AI認定講師
たしかに。コミュニティ製のサーバーをforkしてツールを追加するだけで、けっこう柔軟に対応できます。

例えば、特定のデータベースからステータスを集計するツールを作れば、週次レポートが一発で取れます。
室谷室谷代表取締役
MYUUUでも似たようなことをやってて、月数時間の工数削減になりました。カスタムツール追加の価値は、時給換算するとすぐペイするんですよ。

複数MCPサーバー連携で情報統合

テキトー教師テキトー教師.AI認定講師
次に、Notion MCPだけじゃなくてGitHub MCPとかJira MCPと組み合わせると、さらに強力ですよね。
室谷室谷代表取締役
そう。PRDをNotionで管理、タスクをGitHub Issuesで管理、その両方をCursorが横断して扱えると、開発のコンテキストスイッチが減る。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのは「NotionのPRDを参照しながらコードを書いて、そのままIssueを作りたい」という声です。これ、MCP連携で実現できます。
室谷室谷代表取締役
情報が散らばってる状態は結局コストなんですよね。連携のROIを試算すると、導入を後押ししやすいです。

大量データ処理のパフォーマンス最適化

室谷室谷代表取締役
エンタープライズだとNotionのページ数が万単位になることもあるんですけど、Cursorでそのまま全件取得しようとするとタイムアウトします。
テキトー教師テキトー教師.AI認定講師
そうなんですよ。最初に戸惑うのがそこです。

検索クエリで必要なページだけに絞るか、ツール側でページネーションを実装するのがポイントです。
室谷室谷代表取締役
あと、キャッシュ戦略も重要ですね。差分更新で前回からの変更だけ取得するようにすれば、パフォーマンスが安定します。
テキトー教師テキトー教師.AI認定講師
普段使う分には標準ツールで十分ですが、大量データを扱うときはカスタムツールかクラウドホスト版(ApifyのSSEなど)を検討するといいです。

セキュリティとチーム管理:エンタープライズ導入のポイント

セキュリティとチーム管理のポイント
Bearer認証とトークン管理
URLにトークン露出なし、.env管理。トークン有効期限1時間+リフレッシュ。チーム共有時は定期ローテーションか個別Integration。公開リポジトリへのプッシュ厳禁。
読み取り専用と書き込みの分離
Integration作成時にRead/Write権限を個別選択。基本はRead Only運用。書き込みは必要なワークフローのみ許可。トークン漏洩時も被害を読み取りに限定。Notion側でアクセス可能なページ制限も可能。
チーム共有:サーバー一元管理
クラウドホスティングで統一SSEエンドポイント、Bearer認証。全員が同じURL/トークンで設定可能。OAuthは権限細分化可能だがCursorのバグあり。.cursor/mcp.jsonをGitにコミットしないよう注意。

Bearer認証とトークン管理のベストプラクティス

室谷室谷代表取締役
実際の運用でまず気になるのがトークンの扱いです。Apifyで公開されているNotion MCPサーバーはBearer認証を採用していて、URLにトークンが露出しない設計になってます。

これはセキュリティ的に正しいですよね。
テキトー教師テキトー教師.AI認定講師
たしかに、ローカルサーバーだと.envファイルに書いて管理するのが一般的ですが、チームで共有するとなると漏洩リスクが一気に上がります。NotionのIntegration Token自体も、NotionのMy Integrationsから発行したらすぐにコピーして安全に保管するのが鉄則です。
室谷室谷代表取締役
トークンの有効期限が1時間でリフレッシュトークンが発行される仕組み(sourceログにexpiresIn:3600とrefreshPresent:true)があるので、そのライフサイクルを理解した上で管理しないと、突然認証が切れてツールが使えなくなります。
テキトー教師テキトー教師.AI認定講師
特にチーム全員が同じトークンを使う場合、誰かが誤ってトークンを公開リポジトリにプッシュすると全員が影響を受けます。定期的なローテーションか、ユーザーごとに個別のIntegrationを発行する設計が必要ですね。

権限設定:読み取り専用と書き込みの分離

室谷室谷代表取締役
Notion Integrationを作るときに「Read」と「Write」の権限を個別に選べます(sourceの設定手順に明記)。この権限分離が想像以上に重要で、読み取り専用トークンでほとんどの作業を済ませ、書き込みは必要な場合だけ別トークンを使うのが原則です。
テキトー教師テキトー教師.AI認定講師
現場でよく聞くのが、「AIに『このデータベースを更新して』と言ったら、意図しない変更が入ってしまった」というケース。最初はRead Onlyで運用し、書き込みが必要なワークフローだけ厳選してWrite権限を追加するのが安全です。
室谷室谷代表取締役
権限を分けることで、万が一トークンが漏洇しても被害を読み取りに限定できます。コスト面でも、書き込みツールを限定すればAPIコールの監視が楽になりますしね。
テキトー教師テキトー教師.AI認定講師
さらにNotion側でIntegrationにアクセスできるページを制限できるので、特定のデータベースだけに絞って権限を与えると、より堅牢な構成になります。

チーム共有:サーバー一元管理の設計

室谷室谷代表取締役
チーム全員が個別にローカルサーバーを立ち上げると、トークン管理が煩雑になります。ApifyのようなクラウドホスティングでSSEエンドポイントを一つ用意し、Bearer認証でアクセス制御する方法が、運用コストの面で現実的です。
テキトー教師テキトー教師.AI認定講師
全員が同じURLとトークンをCursorのMCP設定に書けばすぐ使えるので、初期設定が楽なのは大きいです。ただ、そのトークンが漏れたら全員に影響するので、トークンのローテーションルールをあらかじめ決めておく必要があります。
室谷室谷代表取締役
さらにセキュアにしたいならOAuthを使う方法もあります。ユーザーごとに個別の認可ができるので、権限管理がより細かくなります。

ただしCursorのバージョンによってはOAuth後のツール読み込みに不具合がある(sourceで2.2.43での問題報告あり)ので、現時点ではBearer認証+クラウドホスティングの組み合わせが実用的です。
テキトー教師テキトー教師.AI認定講師
どちらにせよ、.cursor/mcp.jsonをGitリポジトリにコミットしないように注意喚起するのがチーム導入の第一歩ですね。

まとめ:Notion MCPで変わる開発現場の生産性

他のナレッジツールとの比較

テキトー教師テキトー教師.AI認定講師
この連載でNotion MCPの使い方はだいぶ掴めたと思います。ただ「他にも似たツールあるけど、何が違うの?」という声はよく聞きますね。
室谷室谷代表取締役
そうですね。ConfluenceとかBacklog、esaとか…でもCursorで直接Notionを読めるという体験は別物です。

PRDをタブで開いてコピペする手間が完全に消える。
テキトー教師テキトー教師.AI認定講師
そこですよね。普段の開発フローで「仕様書確認のためのコンテキストスイッチ」って意外と大きい。

Notion MCPを使うと、Agentが自動で引っ張ってきてくれる。
室谷室谷代表取締役
実際のところ、導入コストも低い。MCPサーバーはデフォルトのが用意されてるし、カスタムのもある。

ROIで見れば三日も使えば元が取れる計算です。

ROI試算:週どれだけ時間節約できるか

室谷室谷代表取締役
ざっくり試算してみましょうか。開発者が1日1回、仕様確認で5分ロスしてるとする。

週5日で25分。月で100分、年間で約20時間。
テキトー教師テキトー教師.AI認定講師
それって結構な数字ですね。しかも「確認のためにタブを開く」だけでなく「MCPで直接読める」となると、集中力の維持にも効く。
室谷室谷代表取締役
MYUUUの現場で計測したわけじゃないですが、実際に使ってるチームだと「週1〜2時間は浮いてる」と聞きます。時給換算で月数百ドル相当。
テキトー教師テキトー教師.AI認定講師
実感としては、一回のPRD参照が数秒で終わるので、日々のストレスが全然違います。導入判断の大きな材料ですね。

導入判断のチェックリスト

テキトー教師テキトー教師.AI認定講師
最後に、導入するかどうかのポイントを整理しておきましょう。まずNotionをメインのドキュメント基盤として使っているかどうか。
室谷室谷代表取締役
そこが大前提ですね。あとはチームで利用する場合、OAuth認証の設定やトークン管理がちゃんとできるか。

ソースにもあったように、OAuthがうまく動かないケースもある。
テキトー教師テキトー教師.AI認定講師
そう。でも導入自体はMCPサーバーの追加とOAuth連携だけなので、30分あれば終わります。

もしトラブったら、ChatGPTのMCP対応状況や公式フォーラムの情報を確認すれば解決できる。
室谷室谷代表取締役
結論、Notionを日常的に使っていてCursorで開発しているなら、導入しない理由はほぼない。ROIが明確に出る機能です。

まずは1週間、試してみる価値は十分あります。
code
## よくある質問

### Q1. Notion MCP以外に、Cursorと連携できる人気のMCPツールはありますか?

**室谷**: いくつかありますね。たとえばGitHub MCPやSlack MCP、PostgreSQL MCPとか。でもNotion MCPはドキュメント参照のニーズが一番強い。USのスタートアップだと、プロジェクト管理をNotionでやってるチームはほぼ入れてますよ。

**テキトー教師**: 現場でよく聞かれるのは「どのMCPを最初に入れるべきか」ですね。自分はNotion MCPを優先して勧めます。PRDや議事録にCursorからアクセスできるだけで、コンテキストスイッチが激減します。

### Q2. 大量のNotionデータベースがある環境だと、パフォーマンスは落ちますか?

**テキトー教師**: 実はそうなんですよ。データベースが数百単位だと、初期読み込みが重くなるケースがあります。ただしCursor側で参照するページを絞る設定ができるので、全件取得は避けたほうが無難です。

**室谷**: MYUUUの現場でも、最初は全データベースを開いてしまって遅くなりました。結局、ワークフローで使うデータベースだけ指定するようにしたらスムーズになりました。ROIで考えると設定コストは無視できるレベルです。

### Q3. Cursorの無料プランでもNotion MCPは使えますか?

**室谷**: 使えますよ。ただし無料プランだと月間のAIクエリ数に制限があるので、MCP経由の呼び出しもその枠を消費します。ヘビーに使うなら有料プランが現実的ですね。

**テキトー教師**: 最初に戸惑うのが「MCPのツール呼び出しがカウントされる」という点です。無料で試すなら、まずは軽い参照から始めると良いでしょう。

### Q4. Notionのリレーションやロールアップといった高度なデータ構造も扱えますか?

**テキトー教師**: 現時点では、リレーション先のデータは直接参照できないケースが多いです。ロールアップの結果はテキストとして取得できますが、計算式の詳細までは取れません。

**室谷**: 構造としては、あくまでNotion APIの範囲内です。リレーションを辿りたい場合は、カスタムMCPツールで対応する企業も出てきています。Anthropicのエコシステムでも同様の課題がありますね。

### Q5. Notion MCPで変更履歴やバージョン管理は可能ですか?

**テキトー教師**: 現状のNotion APIでは、ページの履歴を直接取得するエンドポイントがないんです。なのでMCP経由でも過去の変更を追うことは難しいです。

**室谷**: どうしても必要な場合は、Notionの「アクティビティログ」を別途スクレイピングするか、Git連携のラッパーを自作するしかありません。ただ実務上は、更新日時を見て差分を手動で確認する運用で回していますね。
code
## まとめ

**室谷**: CursorとNotionをMCPでつなぐ話、だいぶイメージ掴めましたかね。自分の肌感では、この連携が開発現場の生産性を一番底上げしてる。特に要件定義の段階でNotionのPRDを直接Codeベースに落とし込めるのがでかい。

**テキトー教師**: たしかに。最初に戸惑うのはセットアップの手順かもしれないけど、一度動けば継続的なメリットが得られます。現場感覚で言うと、「Notionを開かずに動ける」という体験が一番の衝撃でした。

**室谷**: エンタープライズだとセキュリティの壁もあるけど、スコープを絞ったMCPサーバーを立てれば回避可能。コスト対効果で言えば、導入に踏み切らない理由はほとんどないですね。

**テキトー教師**: まずは小さなワークフローから試してみるのがおすすめです。議事録をCursorに取り込んで、コードレビューコメントに反映するだけでも違いますよ。

関連記事

新着記事

関連記事

.AI TIMES一覧に戻る