Notion MCPをCursorとCodexで使ってみる
MCPとは
アプリケーションがLLMにコンテキストを提供する方法を標準化するオープンプロトコル
モデルコンテキストプロトコル(MCP)- Anthropic
MCPはアプリケーションごとの異なるデータソース、ツールに接続するための標準的な方法の提供を行う
ざっくりと、様々なアプリケーションとAIをつなぐための標準的な規格がMCPなんだと捉えている(ドキュメント内ではUSB-Cで例えられている)。
MCPクライアントとNotion MCP Server
MCPはあくまで規格なのでそれで何かをするというわけではない。
MCPが搭載されているクライアントを使用して、MCPサーバーで実際にアプリケーションとの統合を行う必要がある。
もっと具体的に言うと、 MCPクライアント(Cursor、Claudeなど)がMCPという規定に沿ってJSONを生成し、MCP Serverが各種アプリケーションのAPIに変換・実行をする
というざっくりとこんな感じの解釈をしている。
要するに、MCPクライアントとMCPサーバーがあれば、アプリケーションごとのAPI仕様とかをクライアント側が意識せずとも自然言語で指示を出すだけでアプリケーションの操作がLLMを通して可能になるということ。
ローカルでMCP Serverを使用する
MCPクライアントはCursor、mcp-severはOSSをクローンして使用する形でNotion MCPを体感してみる。
WARNING
現状は積極的なメンテナンスはされていないため公式のmcp-serverを利用することを推奨
構築の流れは以下のNotion MCP ServerリポジトリのREADMEの内容の繰り返しになってしまうのでざっくりとしたものにする。
前提:
- Notionアカウントを持っている
- Cursorをダウンロード済み(課金有無はおそらく関係ない)
1. Notion Developerでインテグレーションの追加
MCP Serverにどんな権限を許可するかなどを設定
以下のページからインテグレーションを追加
2. 作成したインテグレーションをNotionに接続
Notionで右上3点リーダから「接続」→ 検索ボックスにさきほど作成したインテグレーションを検索して接続
3. MCPクライアント側の設定
Cursorなら基本設定 > Cursor Settings > MCPからmcp.jsonを作成。(mcp.jsonの中身はREADME参照)
envプロパティにはインテグレーション作成時に生成されたシークレットを貼り付ける
これだけで完了
公式のリモートMCP Serverを使用する
2026-02-08追記:
どうやら昨年度に公式のリモートMCP Serverがリリースされていたようなのでそれも使ってみる。
ローカルMCPと比べると、認証がOAuthになってインテグレーション作成が不要になったり、検索がより広範囲に可能になったりなどでよりよい形になっているよう。
MCPクライアントはCodexの前提で行う。
まずは~/.codex/config.tomlに以下を追加する。
[mcp_servers.notion]url = "https://mcp.notion.com/mcp"次に、ターミナルで以下を実行してログインする。
codex mcp login notionログインしたら以下コマンドでMCPの確認
codex mcp listこれだけでCodexを起動してNotionに対する更新や追加、削除、検索などが可能になる。
使ってみた感想
ローカルMCPに関しては正直、読み取りも記述も手作業のほうが早いと感じるほどにはあまり良い印象はなかったが、 公式のリモートMCP Serverの読み取り範囲の大きさやDB構築などは難なく行えて、日常的に使えそうな気がする。
ただ、Notion AIの代わりになりそうかといえばそうでもなく、細かいDB設定(ソートやフィルタなど)はMCPでは限界があるため、万能ではない。
また、読み取りに関してもChatGPTのコネクトで可能ではあるのでMCPが必須というわけでもなさそう。
上手い使い方を模索してMCPでしかできないような作業を任せていきたい。