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

MCPとは何か:AIエディタと外部ツールをつなぐプロトコル
室谷代表取締役MCP、知ってます?Model Context Protocol。AIエディタが外部のツールやデータとやりとりするための共通規格です。
Cursorも対応してます。
Cursorも対応してます。
テキトー教師.AI認定講師そうなんですよ。要は、エディタのAIが直接NotionやGitHubにアクセスできるようになるプロトコル。
いちいちコピペしなくて済む。
いちいちコピペしなくて済む。
室谷代表取締役これ、効率に直結しますね。Cursorでコード書きながらNotionのPRDを参照したい。
その「ながら」ができるかどうかで生産性が変わる。
その「ながら」ができるかどうかで生産性が変わる。
CursorでのNotion MCP実現イメージ
室谷代表取締役実際、コミュニティでいくつかMCPサーバーが公開されてます。Cursorの公式フォーラムでも紹介されてるやつが。
テキトー教師.AI認定講師例えば、GitHubで公開されてるmcp-notion-serverっていうのを使うと、CursorからNotionのページを検索したり読んだりできるようになる。
室谷代表取締役さらに、Apifyでホストされてるクラウド版もある。ローカルでサーバー立ち上げなくていい。
Bearer認証でセキュアに。
Bearer認証でセキュアに。
テキトー教師.AI認定講師なるほど。ローカルとクラウド、選べるんですね。
環境によって使い分けられそうです。
環境によって使い分けられそうです。
なぜ今Notion MCPなのか:開発効率向上の具体例
室谷代表取締役たとえば、新しい機能の実装時にPRDを参照する。今まではNotionを開いて確認して戻る、の往復。
これ、めちゃくちゃ時間食うんですよね。
これ、めちゃくちゃ時間食うんですよね。
テキトー教師.AI認定講師現場でよく聞くのは、要件の解釈違いが発生するって話。Cursorが直接PRDを読んでコード生成してくれれば、そのズレが減る。
室谷代表取締役時間単価で換算すると、この往復コストって塵積もって月何時間分かになる。ROIで見れば導入しない理由がない。
テキトー教師.AI認定講師まだ「お試し中」のフェーズのチームも多いですけど、実際に使い始めると戻れなくなりますよ。
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認証でセキュアですし。
SSEで転送するので、PUTやGETの待ち時間も気になりません。Bear認証でセキュアですし。
テキトー教師.AI認定講師デプロイはApifyのページからワンクリックです。設定はSSEのURLとBearerトークンをメモしておくだけ。
慣れれば5分かからないと思います。
慣れれば5分かからないと思います。
CursorのMCP設定画面への追加方法
室谷代表取締役で、どちらの方法にせよ、最後にCursor側の設定が必要です。
テキトー教師.AI認定講師Cursorの設定 → Features → MCP Servers で設定画面を開きます。JSONを直接編集するか、GUIで追加します。
室谷代表取締役ローカルの場合はcommandをnode、argsにビルド後のパスを指定。クラウドの場合はurlとheadersを書くだけ。
この辺りはドキュメント通りで問題ないですね。
この辺りはドキュメント通りで問題ないですね。
室谷代表取締役設定後、リロードするとツール一覧にNotionが表示されるはずです。表示されなければログを確認して、トークンかパスが間違ってないかチェックですね。
実践ワークフロー:PRDや議事録をCursorに取り込む
- 1PRD文書を読み込んでコードに反映Notion MCPでPRDのテキストや画像を参照し、Cursorに読み込ませる。要件解釈の齟齬が減る。
- 2会議メモからToDoを自動生成会議後のNotionメモをCursorに読ませ、ToDoリストを自動生成。手動のタスク整理が5秒で完了。
- 3タスクデータベースをCursorで操作コード書きながらNotionのタスクDBを直接更新。バグレポートの追加やタスク管理をCursor上で実行。
PRD文書を読み込んでコードに反映
室谷代表取締役シリコンバレーだと、PRDを直接Cursorに読み込ませてコードを書くのが当たり前になりつつあります。Notion MCPでPRDのテキストや画像をそのまま参照できる。
テキトー教師.AI認定講師最初に「どうやってPRDの内容をコードに反映するの?」と現場でよく聞かれます。でもMCPの設定さえ終われば、Cursorに「このNotionページを読んで」と言うだけでコンテキストに入る。
室谷代表取締役MYUUUでも新機能の開発時にPRDを読ませてます。要件解釈の齟齬が減るのが一番のメリット。
時給換算で考えると、1回のミーティング削減で月額20ドルなんてすぐペイします。
時給換算で考えると、1回のミーティング削減で月額20ドルなんてすぐペイします。
テキトー教師.AI認定講師たしかに、PRDとコードの行き来が減るのは大きいですね。初心者でも「/notion read ページURL」のように呼び出せば即座に内容を展開してくれる。
会議メモからToDoを自動生成
テキトー教師.AI認定講師よくあるのが、会議後にNotionに書いたメモをCursorに読ませて、ToDoリストを自動生成するワークフロー。手動でタスクを起こす手間が省けます。
室谷代表取締役あれ、時間対効果が半端ない。うちの現場だと、ミーティング後のタスク整理が5分かかってたのが5秒で終わる。
ROIで言うと一日あたりの節約時間がかなり大きい。
ROIで言うと一日あたりの節約時間がかなり大きい。
テキトー教師.AI認定講師ただ、Notionのデータベース構造がきれいになってないとうまく動かないことも。例えば「タスク」データベースに必須カラムがあると、それに合わせたプロンプトが必要です。
室谷代表取締役そこはプロンプトテンプレートを用意しておくといいですね。「この会議メモからタスクを抽出して、Tasks DBの該当プロパティにマッピングして」みたいな。
タスクデータベースをCursorで操作
室谷代表取締役タスク管理のNotion DBをCursorから直接更新できるのは、開発フローを止めない点で大きい。コード書きながら「あ、バグ見つけた」と思ったらその場でDBに追加できる。
テキトー教師.AI認定講師「新しいバグレポートをTasksデータベースに作成して」と伝えるだけで、タイトルや優先度を自動で設定してくれます。最初は感動しますね。
室谷代表取締役チームで使うなら権限周りだけ注意。Notion Integrationトークンを使ってアクセスするので、読み取り専用と書き込み可能を分けて管理したほうがいい。
テキトー教師.AI認定講師そこは環境変数で切り替えられるので、個人開発ならFull Accessでも問題ないです。まずは自分用に試してみるのがおすすめです。
よくあるトラブルと解決策:OAuthエラーやツール読み込み停止
ローカル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 foundやSaving 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認証+クラウドホスティングの組み合わせが実用的です。
ただしCursorのバージョンによってはOAuth後のツール読み込みに不具合がある(sourceで2.2.43での問題報告あり)ので、現時点ではBearer認証+クラウドホスティングの組み合わせが実用的です。
テキトー教師.AI認定講師どちらにせよ、.cursor/mcp.jsonをGitリポジトリにコミットしないように注意喚起するのがチーム導入の第一歩ですね。
まとめ:Notion MCPで変わる開発現場の生産性
他のナレッジツールとの比較
テキトー教師.AI認定講師この連載でNotion MCPの使い方はだいぶ掴めたと思います。ただ「他にも似たツールあるけど、何が違うの?」という声はよく聞きますね。
室谷代表取締役そうですね。ConfluenceとかBacklog、esaとか…でもCursorで直接Notionを読めるという体験は別物です。
PRDをタブで開いてコピペする手間が完全に消える。
PRDをタブで開いてコピペする手間が完全に消える。
テキトー教師.AI認定講師そこですよね。普段の開発フローで「仕様書確認のためのコンテキストスイッチ」って意外と大きい。
Notion MCPを使うと、Agentが自動で引っ張ってきてくれる。
Notion MCPを使うと、Agentが自動で引っ張ってきてくれる。
室谷代表取締役実際のところ、導入コストも低い。MCPサーバーはデフォルトのが用意されてるし、カスタムのもある。
ROIで見れば三日も使えば元が取れる計算です。
ROIで見れば三日も使えば元が取れる計算です。
ROI試算:週どれだけ時間節約できるか
室谷代表取締役ざっくり試算してみましょうか。開発者が1日1回、仕様確認で5分ロスしてるとする。
週5日で25分。月で100分、年間で約20時間。
週5日で25分。月で100分、年間で約20時間。
テキトー教師.AI認定講師それって結構な数字ですね。しかも「確認のためにタブを開く」だけでなく「MCPで直接読める」となると、集中力の維持にも効く。
室谷代表取締役MYUUUの現場で計測したわけじゃないですが、実際に使ってるチームだと「週1〜2時間は浮いてる」と聞きます。時給換算で月数百ドル相当。
テキトー教師.AI認定講師実感としては、一回のPRD参照が数秒で終わるので、日々のストレスが全然違います。導入判断の大きな材料ですね。
導入判断のチェックリスト
テキトー教師.AI認定講師最後に、導入するかどうかのポイントを整理しておきましょう。まずNotionをメインのドキュメント基盤として使っているかどうか。
室谷代表取締役そこが大前提ですね。あとはチームで利用する場合、OAuth認証の設定やトークン管理がちゃんとできるか。
ソースにもあったように、OAuthがうまく動かないケースもある。
ソースにもあったように、OAuthがうまく動かないケースもある。
テキトー教師.AI認定講師そう。でも導入自体はMCPサーバーの追加とOAuth連携だけなので、30分あれば終わります。
もしトラブったら、ChatGPTのMCP対応状況や公式フォーラムの情報を確認すれば解決できる。
もしトラブったら、ChatGPTのMCP対応状況や公式フォーラムの情報を確認すれば解決できる。
室谷代表取締役結論、Notionを日常的に使っていてCursorで開発しているなら、導入しない理由はほぼない。ROIが明確に出る機能です。
まずは1週間、試してみる価値は十分あります。
まずは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に取り込んで、コードレビューコメントに反映するだけでも違いますよ。