Notion MCPサーバーの使い方 — Claude Codeへの接続手順とコネクタとの違い
NotionはClaude Codeなどのエージェント向けにMCPサーバーをmcp.notion.comで公式提供しています。接続手順とツールの範囲、Notionコネクタとの使い分けをまとめます。
Notionは、Claude CodeのようなMCPクライアントから直接つなげるMCPサーバーをhttps://mcp.notion.com/mcpで公式提供しています。ローカルにサーバーを立てる必要はなく、claude mcp addの1行とOAuth認証だけでワークスペースの検索・作成・更新をClaude Codeのセッションから任せられます。似た名前の仕組みにclaude.aiの「Notionコネクタ」がありますが、これは管理画面から有効にする別の経路です。この記事ではClaude Code側のMCP接続に絞り、手順とツールの範囲、コネクタとの使い分けを確認します。MCP自体の仕組みから知りたい場合はMCPとは — AIと外部ツールをつなぐ標準プロトコルが対応します。
Notion MCPサーバーとは — mcp.notion.comへのリモート接続
Notion MCPサーバーはNotionがホストするリモートMCPサーバーです。OAuthで認証したあと、MCPクライアントは接続したアカウントがアクセスできる範囲でNotionのコンテンツを読み書きできます。Codex・Cursor・VS Code・Claude Codeなど複数のMCPクライアントが、Notion自身のドキュメントで接続先として案内されています。
推奨される接続方式はStreamable HTTPで、SSEはクライアントがStreamable HTTPに未対応の場合のフォールバックです。ローカルで動かすオープンソース版のMCPサーバー(notion-mcp-server)も配布されていますが、こちらは開発が止まっています。今つなぐならmcp.notion.comが第一選択です。
Claude CodeでNotion MCPサーバーに接続する手順
接続はコマンド1行で終わります。
claude mcp add --transport http notion https://mcp.notion.com/mcp登録後は/mcpを実行し、notionを選んでOAuth認証を進めます。ブラウザで接続したいNotionワークスペースにサインインし、アクセス範囲を確認して許可すれば接続完了です。claude mcp listで✔ Connectedになっていれば準備は済んでいます。
接続の範囲は--scopeで切り替えられます。既定の--scope localは今のプロジェクトの自分だけに閉じた接続です。チームで設定を共有したいときは--scope projectを付けると.mcp.jsonに書き出され、複数プロジェクトで使い回したいときは--scope userを選びます。スコープごとの細かい挙動はClaude Code MCP設定ガイドにまとめています。セッション内でMCPサーバーがどれだけのトークンを消費しているかは/contextで確認できます。
接続後にできること — 検索・作成・更新の主要ツール
Notion MCPサーバーには20種類前後のツールが用意されていますが、中心になるのは検索・取得・作成・更新の4系統です。
| カテゴリ | 代表ツール | できること |
|---|---|---|
| 検索・取得 | 代表ツールnotion-search / notion-fetch | できることページ・データベースを横断検索し、URLやIDから本文・スキーマを取得する |
| 作成・更新 | 代表ツールnotion-create-pages / notion-update-page | できることデータベーステンプレートを適用した新規ページ作成、ステータス・アイコンなどプロパティの更新 |
| データベース操作 | 代表ツールnotion-create-database / notion-create-view | できること新規データベースとビューの作成、既存データソースのプロパティ更新 |
| ファイル・添付 | 代表ツールnotion-create-file-upload / notion-create-attachment | できることローカルファイルのアップロード(20MiBまで)、URLからの添付作成 |
| コラボレーション | 代表ツールnotion-create-comment / notion-get-comments | できることページへのコメント追加・取得、ワークスペースのメンバー情報の確認 |
1回の依頼の中で複数のツールを組み合わせて呼べる設計です。「関連ページを検索して、その内容をまとめた新規ページを作る」といった一連の作業も、Claude Codeが検索と作成のツールを順番に呼び出して完結させます。ページ更新では、本文中の特定の文字列だけを狙って書き換える検索置換の操作も使えます。
検索の絞り込み精度はプランで変わる
notion-search自体はどのプランでも使えますが、絞り込みの細かさはプランで差があります。
| 絞り込み・並べ替え | 全プランで利用可 | Business/EnterpriseのFull Notion MCPが必要 |
|---|---|---|
| 対象範囲 | 全プランで利用可単一の場所・チームスペースでの絞り込み | Business/EnterpriseのFull Notion MCPが必要複数チームスペースをまたぐ絞り込み |
| 作成者・更新者 | 全プランで利用可作成者での絞り込み | Business/EnterpriseのFull Notion MCPが必要更新者(editor)での絞り込み |
| 日付 | 全プランで利用可通常の日付指定 | Business/EnterpriseのFull Notion MCPが必要更新日時での絞り込み、日付順の並べ替え |
| タイトル・ステータス | 全プランで利用可タイトルを含む検索 | Business/EnterpriseのFull Notion MCPが必要タイトルのみを対象にした検索、コンテンツステータスでの絞り込み |
無料・Plusプランでもページ検索そのものは動きますが、更新者や複数チームスペースをまたいだ絞り込みは上位プランが前提です。判断に迷ったらnotion-fetchでselfを取得します。接続中のワークスペース・ユーザー情報に加えて、各ツールが今のプランでどこまで使えるかを示すcurrent_tool_accessが一緒に返ってきます。ツールの状態がupgrade_requiredと表示されていれば、動かないのはエラーではなくプランの壁だと判断できます。
Notion Skillsをこの接続から呼び出す・作る
Notion MCPサーバーには「Notion Skills」という独自の仕組みがあります。手順を書いたNotionページを、そのまま再利用できるワークフローの定義として使う機能です。
notion-create-pagesでis_skill: trueを指定すればSkillとして新規作成でき、既存ページを後からSkill化したいときはnotion-convert-page-to-skillを使います。呼び出す側はnotion-search-skillsにタスク名や短い説明を渡してSkillを検索し、notion-fetchで内容を取得してから実行する流れです。Skillを書くときはnotion://docs/skillsというMCPリソースに、どんな粒度で書けば他のエージェントも実行できるかの指針が用意されています。
社内のオンボーディング手順やレビューのチェックリストをNotionページで管理しているなら、それをそのままSkillとして呼び出せる形に変えられます。「よく使う手順書をNotionに書いておけば、Claude Codeがそれを読んで同じ手順を再現できる」という関係です。
Notion公式のClaude Codeプラグインでまとめて導入する
Notionは、MCPサーバーとSkills・スラッシュコマンドを1つにまとめたClaude Code用プラグインを公式リポジトリ(makenotion/claude-code-notion-plugin)で配布しています。個別にclaude mcp addを打つ代わりに、次の2行で導入できます。
/plugin marketplace add makenotion/claude-code-notion-plugin
/plugin install notion-workspace-plugin@notion-plugin-marketplaceプラグインには「Knowledge Capture」「Meeting Intelligence」「Research Documentation」「Spec to Implementation」という4つのSkillsと、/Notion:searchや/Notion:create-task、/Notion:database-queryといったスラッシュコマンドが含まれます。MCPサーバー単体の接続と違い、こちらは議事録の構造化やタスク化といった具体的な使い方がコマンドとしてすでに組まれている点が特徴です。導入後はClaude Codeの再起動が必要で、認証はMCPサーバー単体の接続と同じくOAuthです。
セキュリティで気をつけること — 権限範囲とプロンプトインジェクション
Notion MCPサーバーが使える範囲は、接続したアカウント自身のNotionの権限と同じです。接続したクライアントは、自分がアクセスできる内容すべてに触れられます。業務用の広い権限を持つアカウントで無条件に接続するのは避けたいところです。Notion自身も、個人の作業に閉じた使い方から始めることを推奨しています。
もう1つ気をつけたいのが、間接的なプロンプトインジェクションです。ツールが返す検索結果やページ本文には、悪意のある指示文が紛れている可能性があります。Claudeがその指示にそのまま従うと、意図しないデータの開示や書き換えにつながりかねません。
ワークスペース側でも制御できます。Settings→Connectionsから接続中のMCPクライアントを一覧・解除でき、Enterpriseプランでは管理者がMCP Governanceで接続を承認制に絞ることもできます。Okta等のIDプロバイダーで一括管理する「エンタープライズ管理接続」も用意されており、この場合はメンバー個別のOAuth操作なしに管理者側で接続を設定できます。
Notion MCPサーバーとNotionコネクタはどう違うか
同じNotion連携でも、設定の作り方が2つあります。
| 経路 | 何を設定するか | 主な用途 | 対応記事 |
|---|---|---|---|
| Notion MCPサーバー(本記事) | 何を設定するかClaude Code側でclaude mcp addによりMCPサーバーを個別登録 | 主な用途Claude Codeのセッション内でNotionを検索・更新しながら開発を進める | 対応記事本記事 |
| Notionコネクタ | 何を設定するかclaude.aiの管理画面でオン/オフする公式コネクタ。有効にするとClaude Web・Desktop・モバイル・Claude Code・APIから共通して使える | 主な用途会話の中でNotionのページを参照・更新する、Coworkの自動実行タスクに組み込む | 対応記事Claude Notion連携の設定方法とできること / Cowork Notion連携でワークスペースを検索・更新する |
技術的な違いは接続の作り方です。Notion MCPサーバーは、MCPクライアント自身がmcp.notion.comに直接つなぐ経路で、Claude Codeのプロジェクトやユーザー単位でオン/オフを管理します。一方Notionコネクタは、claude.aiの管理画面で有効にする公式の統合で、一度有効にすればアカウントに紐づいた1つの接続をどの利用形態からも使い回せます。どちらも最終的にはNotion API経由でワークスペースにアクセスする点は共通していますが、プロジェクトごとに接続を切り替えたいならMCPサーバー、アカウント全体で1つの接続を使い回したいならコネクタが向いています。MCPのOAuth実装そのものの仕組みはリモートMCPのOAuth認証で扱っています。
よくあるつまずき
- 自動化ワークフローから使えない: Notion MCPサーバーは対話的なOAuth認証が前提で、サービスアカウントによる非対話的な認証にはまだ対応していません。cronなどでの定期実行を組みたい場合は、この制約を先に確認します
- 「共有していません」と返ってくる: MCPクライアントが見えるのは、接続したアカウント自身がNotionでアクセスできる範囲だけです。対象のページ・データベースがそのアカウントと共有されているかを確認します
- 検索の絞り込みオプションが効かない: 更新者や複数チームスペースをまたぐ絞り込みはBusiness/Enterpriseプランの機能です。エラーではなくプランの壁である可能性を先に疑います
- 社内で接続の選択肢自体が出ない: EnterpriseプランでMCP Governanceが有効になっている場合、管理者が承認したAIアプリ以外は接続できません。Settings→ConnectionsのPermissionsタブで承認状況を確認します
よくある質問
オープンソース版のNotion MCPサーバーとどちらを使うべきですか
公式ホスト版のNotion MCPサーバー(https://mcp.notion.com/mcp)を推奨します。OAuth認証に対応し、インフラの用意も不要です。オープンソース版(notion-mcp-server)はメンテナンスが終了しており、ベアラートークン認証と旧v1 APIを使う自動化向けの選択肢として残っているだけです。
自動化ワークフローからNotion MCPサーバーを呼べますか
接続には対話的なOAuth認証が必須で、サービスアカウントによる非対話的な認証にはまだ対応していません。Notion側は対応を進めていると案内していますが、時期は明らかにされていません。
まとめ
Notion MCPサーバーはclaude mcp add --transport http notion https://mcp.notion.com/mcpの1行と/mcpでのOAuth認証だけで使い始められます。検索・作成・更新の主要ツールに加えて、手順書をそのまま再利用できるNotion Skillsという独自の仕組みも使えます。接続したアカウントの権限がそのまま反映されるため、まずは個人の作業範囲で試し、書き込み系のツールは実行前に内容を確認する運用にしておくと安全です。プロジェクトごとに接続先を切り替えたいなら本記事のMCP接続、アカウント全体で1つの接続を使い回したいならNotionコネクタと、目的で選び分けます。