一覧へ戻る

Notion MCPをCursorとCodexで使ってみる

2025-05-10 公開 2026-02-08 更新 GitHub
目次

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に以下を追加する。

~/.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でしかできないような作業を任せていきたい。

この記事を共有