NotionをほかのAIとつなぐ手順（その1）：Notion MCPをClaude Code・Cursor・Codex・VS Code・Claudeにつなぐ、Notion Agentに外のMCPサーバーを足す。設定する画面、ファイルの書き方、渡るデータ、外し方まで

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はNotionを入れていますが、使い心地はこの記事には書いていません。設定例には、公式ページの例を要約から写したものと、公式の記載に合わせてこの記事で組んだもの（動作は確かめていません）があり、そのつど区別します。公式ページは要約の形で取得したため、設定ファイルは、実際に写す前に、必ず原文で確かめてください。

先に結論

• まず「どちら向きか」を決める。 外のAIがNotionを読み書きする（Notion MCP）のか、Notionの中のAIが外を見に行く（AIコネクタ、08）のか、Notionの中から外のAIを呼ぶ（外部エージェント、MCP servers）のか。画面も、権限も、データの行き先も違います。
• Notion MCPの接続は、ふつう「URLを入れる→ブラウザで許可する」の2段。 公式の例は、4つのクライアントとも、URLを書く（コマンドかファイル）、そのあとOAuthを完了する、という作りです。
• 渡るのは「ツールの結果」。 AIアプリが、Notionのページ、データベース、コメントなどを、ツール（search、fetch、create-pages など）を通して受け取ります。そのあとAIアプリが外へ送れば、データはNotionの外へ出ます（公式の安全の資料の警告）。
• 外すのは2か所。 AIアプリ側の設定を消す。Notion側の許可を取り消す。後者の、一般のメンバー向けの画面は、読んだ範囲では記載が見つかりません。
• 書き込みの確認は、AIアプリ側に頼る。 公式は、内容を変える操作の確認を有効にするよう勧めています。Notion側で確認を強制するのは、削除のツール（user_confirmed: true が必要）などに限られる、と読めます。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIアプリと外のサービスをつなぐ共通の決まり。「サーバー」はサービス側、「クライアント」はAIアプリ側。
• 遠隔（remote）MCPサーバー：インターネット上のURLで動いているサーバー。Notion MCPはこれ。以前の、手元で動かす型（STDIO）とは別です。
• Streamable HTTP／SSE：遠隔サーバーとの通信の型。公式は、前者を recommended、後者を、前者に対応しないクライアント向けの予備、と書いています。
• OAuth：パスワードを渡さずに、ブラウザで「このアプリにここまで許可する」と本人が承認する方式。
• MCPトークン：ブラウザの承認を使わず、クライアントが、決まった文字列（ベアラートークン）を送って認証する方式。BusinessとEnterpriseだけ、と書かれています。
• mcp-remote：遠隔に対応しないクライアントを、ローカルのSTDIOから橋渡しする、公式の例に出てくるコマンド。
• ワークスペースのオーナー／メンバー／ゲスト：Notionの立場。Notion MCPに接続できるのはメンバーまで。ゲストは接続できません。

全体の地図

手順の前に：Notion側で確かめること

公式の資料に書かれた、接続の前提です。

1. 立場。 ワークスペースのメンバーであること。ゲストが接続しようとすると、接続できない旨のメッセージが出て、認可が拒否される、と開発者向け資料に書かれています。
2. プラン。 公式の開発者向け資料は、Notion MCP自体は全プランで使える、と書いています。ただし、接続した外のソースの検索（notion-connector-search）や、複数のデータベースにまたがる検索は、Notion AIつきのBusinessかEnterpriseが要ります。検索の絞り込み（最終編集者、最終編集日など）も、BusinessかEnterpriseです。
3. 管理者の制限。 Enterpriseでは、管理者が、メンバーが接続できるAIアプリを承認済みの一覧に絞れる場合があります（下の「外し方」）。接続できないときは、管理者に聞きます。
4. 使う前の整理。 公式のヘルプは、一人で使う使い方から始め、ページの題名を分かりやすくするよう書いています。

手順A：Claude CodeにNotion MCPをつなぐ

公式の「Get started with MCP」の手順です（確認日2026-10-25）。

1. ターミナルで、次のコマンドを実行する。これは公式ページに書かれたコマンドです（公式の原文で確かめてください）。

claude mcp add --transport http notion https://mcp.notion.com/mcp

1. Claude Codeの中で /mcp を実行し、ブラウザの表示に従ってOAuthを完了する。
2. 期待される結果：/mcp の一覧に、notion が出て、認証が済んだ状態になる（一覧の見え方は、Claude Code側の表示によります）。

保存先の範囲（--scope）。 公式のNotion資料と、Claude Codeの公式資料が、次のように書いています。

ファイルに書く場合（この記事で組んだ例。動作は確かめていません）。 Claude Codeの公式資料は、遠隔のHTTPサーバーを .mcp.json に、"type": "http" と url で書く形を示しています。Notionの接続先をそこに当てはめると、次のようになります。

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

.mcp.json に書いた場合、Claude Codeは、対話の中でそのサーバーを使う前に承認を求める、と公式の資料にあります。

管理のコマンド（Claude Codeの公式資料より。実行前に原文で確かめてください）。

claude mcp list
claude mcp get notion
claude mcp remove notion

公式のNotion資料には、/context で、有効なMCPサーバーごとのトークンの使用量を見られる、と書かれています。

手順B：CursorにNotion MCPをつなぐ

公式の「Get started with MCP」の例です。

1. プロジェクトに .cursor/mcp.json を作り、次を書く（公式の例の写し。原文で確かめてください）。全プロジェクトで使うなら、同じ内容を ~/.cursor/mcp.json に書く、と書かれています。

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

1. Cursorのサイドバーで「Customize」を開き、Notionを有効にして、OAuthを完了する。
2. 期待される結果：Customizeの一覧で、Notionのスイッチがオンになる。

Cursorの公式資料には、次のことが書かれています。

• サーバーのオンとオフは、「Customize」のスイッチで切り替えられる。オフにしたサーバーは読み込まれず、設定は消えない。
• MCPのツールを実行する前に、承認を求めるのが既定。ツール名の横の矢印で、引数を見られる。
• 管理者が共有のサーバーを設定する場所は、「Dashboard > Plugins & MCPs」。

手順C：CodexにNotion MCPをつなぐ

1. ~/.codex/config.toml に、次を足す（公式の例）。プロジェクトごとにするなら、プロジェクトのルートの .codex/config.toml に同じ内容を書く、と書かれています。

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

1. 次のコマンドを実行し、OAuthを完了する。

codex mcp login notion

1. 期待される結果：ブラウザで許可の画面が出て、許可すると、Codexからnotionのサーバーが使える状態になる（公式のNotion資料は、ここまでしか書いていません）。

手順D：VS Code（GitHub Copilot）にNotion MCPをつなぐ

1. ワークスペースに .vscode/mcp.json を作り、次を書く（公式の例）。

{
  "servers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

ほかのクライアントが mcpServers と書くのに対し、VS Codeの例は servers です。ほかの例からコピーするときは、キー名の違いに注意してください。

1. コマンドパレット（Cmd+Shift+P、またはCtrl+Shift+P）で「MCP: List Servers」を実行する。
2. Notionのサーバーを起動し、求められたらOAuthを完了する。
3. 自分の全プロジェクトで使うなら、「MCP: Open User Configuration」を実行し、そこに足す、と書かれています。

手順E：Claude（claude.ai、Claude Desktop）につなぐ

公式で確認できたこと。 Notionのヘルプ（Notion MCP）は、Claude Desktop、Claude.ai、Cursor、ChatGPT Proを名前で挙げ、MCPに対応するAIアプリならつなげる、と書いています。ただし、開発者向け資料の「Get started with MCP」には、Claude DesktopとClaude.aiの手順は書かれていませんでした。Notionのヘルプは、設定は各アプリの「settings or integrations menu」にある、と書くだけで、メニュー名は書いていません。ヘルプは、ワンクリックで接続できる「Notion MCP Gallery」にも触れていますが、その中身は読めていません。

Claude側の公式の手順（Anthropicのヘルプ「Get started with custom connectors using remote MCP」より）。 次は、Claudeの画面の手順です。

Pro、Maxの場合：

1. 「Customize > Connectors」を開く。
2. 「+ Add」→「Add custom connector」。
3. 名前を入れる。
4. 遠隔MCPサーバーのURLを入れ、「Continue」。
5. 検出された認証の設定を確かめ、「Continue」。
6. 「Authentication」で、「Sign in now」「Sign in when needed」「No sign in」から選ぶ。
7. 「OAuth client」で、Claudeがサーバーに名乗る方法（「Use Claude's published identity (Recommended)」、「Register automatically」、「Use your own OAuth client」）を選ぶ。「Recommended」はAnthropicのヘルプの表記です。
8. 「Add」を押す。

TeamとEnterpriseは、オーナーが「Organization settings > Connectors」から「Add」→「Custom」→「Web」で足し、メンバーは「Customize > Connectors」で「Connect」を押して認証する、と書かれています。会話の中では、左下の「+」→「Connectors」で、使うコネクタをオンにします。

この記事の案（動作は確かめていません）。 上のClaude側の手順の「URL」の欄に、Notionの公式資料にある https://mcp.notion.com/mcp を入れる、という組み合わせです。Notionの資料が、Claude側のこの手順を指示しているわけではありません。Claude側のヘルプは、遠隔サーバーへはAnthropicのクラウドから接続する、と書いています。Notion MCPは公開のURLなので、IPアドレスの許可の話は出てきませんが、これは僕らの読みです。

Claude側の注意（同じヘルプより）。 権限（スコープ）を見て、不要なものは断る。信頼するサーバーにだけつなぐ。「Search and tools」のメニューで、要らないツールを無効にできる。Researchは、コネクタのツールを、追加の確認なしに呼べるので、外部のアプリに書き込めるツールは無効にする。外すには、Claudeの設定でコネクタを切るか、相手サービス側のセキュリティの設定で取り消す。

手順F：ChatGPTにつなぐ

• Notionのヘルプは、ChatGPT Proを、つなげるAIアプリの例として挙げています。開発者向け資料の「Supported tools」は、ChatGPTの接続では結果の形が違う、とだけ書いています。
• 「Get started with MCP」と「Common MCP clients」のページには、ChatGPTは出てきません。
• OpenAI側の、MCPコネクタを足す手順のヘルプは、2つの記事を試しましたが、どちらも取得できませんでした。

そのため、この記事は、ChatGPTの画面の手順を書きません。つなぐ場合は、OpenAIの公式ヘルプで手順と対応プランを確かめ、Notion側の接続先としては、公式の https://mcp.notion.com/mcp を使う、という順になります（組み合わせは、この記事の案で、読んだ範囲では確かめられていません）。

手順G：そのほかのクライアント

公式の「Get started with MCP」の、一般の案内です。

橋渡しの設定の例です（公式の例。原文で確かめてください）。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}

「Common MCP clients」のページには、クライアントとして、Codex、Claude Code、Cursor、fx、Hermes、Devin、Pi、VS Code、Antigravity が並び、それぞれの設定は、各クライアントの案内へのリンク先にある、と読めました。なお、別のページ「Get started with MCP」には、Antigravityについて、ギャラリーにある設定済みの「Notion」コネクタではなく、カスタムのサーバーとして接続することを、公式が recommend と書いています（ギャラリーのコネクタは、非推奨の notion-mcp-server を使うため）。

認証の方法

MCPトークンは、ブラウザの承認なしに動く固定の文字列です。漏れると、そのトークンの権限の範囲で使われます。環境変数に入れる、バージョン管理に入れない、というのが公式の一般的な書き方（08のAPIの節）です。MCPトークンの権限の範囲や期限は、読んだページに書かれていません。

渡るデータと、AIにできること

ツールの一覧（公式の「Supported tools」より）

AIアプリには、次のようなツールが渡されます。名前は公式の表記です。

接続ごとに、渡るツールの一覧は同じとは限りません。公式は、ワークスペース所有の接続は、管理者が選んだツールだけを一覧に出し、カレンダーのツールは出ない、などと書いています。ツールのアクセス状況は、notion-get-tool-access で調べられます。読み取り専用の接続モードがあるかどうかは、読んだ範囲では記載が見つかりませんでした。

権限の考え方（公式のヘルプとセキュリティの資料）

• 接続したAIは、本人がアクセスできるものすべてにアクセスできる。Notionの既存の権限は飛び越えない。
• ツールが返す内容は、信頼できないものとして扱う。読んだページに、AIを操る隠れた指示が入っていることがある。
• 接続したクライアントが、Notionの内容を外のシステムへ送ることがある。
• 内容を変える操作は、クライアント側で確認が出るようにする。
• 公式の「Security best practices」は、次の順で書いています：公式のURLを使う、クライアントを選ぶ、第三者のマーケットプレイスのクライアントはURLを確かめる、プロンプトインジェクションに備える、権限を見直す、提案された操作を確かめる、変更の確認を要求する、管理者の機能を使う、接続を監査して取り消す。

制限

• 呼び出しは、標準のAPIのリクエスト制限に数えられる、と書かれています。制限の数字は、08のAPIの節に書きます。
• 制限にかかったとき、Notion MCPは、待ち時間が2秒以下なら1度だけ再試行し、長ければ、rate_limited のコードと待ち時間（retry_after_seconds）を含むエラーをすぐ返す、と書かれています。LLMのツール側に、並列の操作を減らす、または少し待つ、と案内しています。

動いたかの確かめ方（この記事の案）

公式にこの名前の手順があるわけではありません。ツール名は公式のものです。

1. AIアプリで、Notionのコネクタ（サーバー）が、有効の状態になっているか確かめる（Claude Codeは /mcp、Cursorは Customize、VS Codeは「MCP: List Servers」）。
2. 次のような指示を出す（この記事の例）。

Notionの、自分の最近のページを、題名だけ5件、一覧にして。

1. 期待される結果：notion-list-recent-pages や notion-search などのツールが呼ばれ、承認を求められたら、内容を見て許可する。題名の一覧が返る。
2. 接続先を確かめるには、notion-get-self（接続しているワークスペースとユーザーを返す、と書かれています）を呼ぶ指示を出すとよいです（この記事の案）。
3. 書き込みを試すなら、まず練習用のページだけに限る。「練習用ページに、1行追加して」のように、範囲を言う（この記事の例）。

外し方

AIアプリ側（AIアプリごとの公式の手順）

Notion側

2つの資料（開発者向け資料とヘルプ）で、管理者の画面の名前が違います（「Notion MCP → Manage workspace clients」と「Connections → Permissions → AI apps」）。どちらが現行かは、確認できていません。手元の画面で探してください。

手順H：Notionの中から、外のMCPサーバーを呼ぶ（Notion Agent）

公式の「Notion Agent」のヘルプの順です。向きが逆（Notion→外）です。

1. Notion Agentを開く（顔のアイコン、またはサイドバーの「Notion AI」）。
2. 次のどれかの道で、MCPサーバーを足す。
3. チャットで、Agentに頼む。
4. 「All sources」→「MCP servers」→「Add MCP server」。
5. 「Settings」→「Connections」→「Discover」。
6. 足したあと、そのアプリの認証をする。
7. 期待される結果：「All sources」の「MCP servers」の下に、つないだサーバーが出る。

注意：モバイルでは、新しいMCPサーバーをつなげない、と書かれています。どの「MCPサーバー」を足せるか（一覧）、書き込みの確認の出方は、読んだページには書かれていません。Custom Agentsのヘルプ（作り方）には、MCPの記述が見つかりませんでした。

渡るデータ：Agentが、つないだMCPサーバーへ、依頼の内容（と、そのために必要なNotionの内容）を送る、という形になります。送られる範囲の詳細は、読んだ資料に記載がなく、接続先の会社の扱いによります（見立て）。

うまくいかないとき

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者はNotionを入れていますが、使い心地はこの記事には書いていません。公式の資料を読んだ範囲です。
• 読めなかったページ：OpenAIのヘルプ（ChatGPTのコネクタ、2記事）、NotionのMCPギャラリーの中身、「Set up enterprise-managed connections for Notion MCP」の設定ガイド、「Personal access tokens」の開発者向けページは、取得できませんでした。そのため、ChatGPTの画面手順、ギャラリーの手順、MCPトークンの権限と期限は書いていません。Claude Codeの資料は、末尾の一部（14,427字ぶん）を読めていません。
• 設定ファイルは、公式ページを要約の形で取得したものです。キー名の違い（mcpServers と servers）など、小さな違いで動かなくなります。写す前に、公式ページの原文で確かめてください。
• 公式ページ同士で、画面の名前が違うところ（管理者の画面、「Agent」と「Agents」）は、併記しました。
• 接続は、渡す範囲を決めてから行います。公式は、読み取りの確認と書き込みの確認を、AIアプリ側で有効にするよう書いています。読み取り専用の接続モードは、読んだ範囲では記載が見つかりませんでした。

出典

• Notion MCP（Notion Help Center、Notion、確認日 2026-10-25）
• Notion MCP（Notion Docs、Notion、確認日 2026-10-25）
• Get started with Notion MCP（Notion Docs、Notion、確認日 2026-10-25）
• Common MCP clients（Notion Docs、Notion、確認日 2026-10-25）
• Supported tools（Notion Docs、Notion、確認日 2026-10-25）
• Security best practices（Notion Docs、Notion、確認日 2026-10-25）
• MCP overview（Notion Docs、Notion、確認日 2026-10-25）
• Notion Agent（Notion Help Center、Notion、確認日 2026-10-25）
• Custom Agents in Notion（Notion Help Center、Notion、確認日 2026-10-25）
• Connect to MCP servers（Claude Code Docs、Anthropic、確認日 2026-10-25）
• Get started with custom connectors using remote MCP（Claude Help Center、Anthropic、確認日 2026-10-25）
• Model Context Protocol（Cursor Docs、Cursor、確認日 2026-10-25）