NotionとClaude Codeを連携する方法｜MCP設定と使い方

NotionとClaude Codeは、Notion公式のリモートMCPサーバー「Notion MCP」を使って連携できます。接続はコマンド1行＋ワンクリックのOAuth認可だけで、Notionに置いた仕様書・タスクデータベース・議事録をClaude Codeが直接読み書きできるようになります。

開発の実務では、仕様やタスクの「正」がNotionにあるのに、実装のたびに内容をコピペしてAIに渡している——この二度手間が連携で消えます。仕様書を読ませて実装させる、実装完了をタスクDBに書き戻させる、議事録から今日のTODOを起こさせる、といった流れが一続きになります。

この記事では、Notion公式ドキュメント・公式ブログ・公式GitHubリポジトリ（いずれも2026年7月確認）だけを根拠に、接続手順から開発ワークフローへの組み込み方、権限とレート制限の注意点、OSS版との使い分けまでを整理します。

Notion MCPとは

Notion MCPとは、Notionが公式にホストするリモートMCPサーバーです。Notion公式ブログ（2025年7月15日）によると、エンドポイントは https://mcp.notion.com/mcp で提供され、各ユーザーはワンクリックのOAuth認可フローで接続します。トークンはサーバー側がセッション管理するため、APIキーを自分で発行・保管する必要はありません。

特徴は、Notion REST APIの単純な写しではなく、AIエージェント向けにツールを再設計している点です。公式ブログでは、create-pages等のツールをAIファーストに再設計し、セマンティック検索を搭載したと説明されています。ユーザー数1億人超（Notion公式ブログ・2024年9月3日）のワークスペースを、そのままAIの読み書き対象にできる公式ルートです。MCPそのものの仕組みはClaude CodeのMCP・Hooks・Skills活用ガイドで解説しています。

開発ワークフローでできること

Notion公式ドキュメント（2026年7月確認）によると、ホスト型Notion MCPはAI向けに最適化された18個のツールを提供します。開発ワークフローに直結するのは次の表のツールです。

ツール名	できること	開発での使いどころ
notion-search	ワークスペースのセマンティック検索	「◯◯機能の仕様書を探して」
notion-fetch	ページ・データベースの取得	仕様書・議事録を実装コンテキストに読み込む
notion-create-pages	ページの新規作成	実装メモ・リリースノートの起票
notion-update-page	既存ページの更新	タスクのステータス書き戻し
notion-query-data-sources	データベースのクエリ	「今スプリントの未完了タスクを一覧して」
notion-create-comment / notion-get-comments	コメントの追加・取得	レビュー依頼・進捗報告をページ上に残す

注意点として、一部機能はプランとNotion AIの有無に依存します。公式ドキュメント（2026年7月確認）によると、Notion AIなしの場合notion-searchはワークスペース内検索のみ（Slack・Google Drive・Jira等の横断検索にはNotion AIが必要）、複数データソースへの一括クエリはEnterprise＋Notion AI、議事録専用クエリはBusiness以上＋Notion AIが条件です。

事前準備：権限とプランの確認

準備の中心は「何が見えるか」の把握です。Notionヘルプセンター（2026年7月確認）は「MCPツールは接続ユーザーのNotion権限で動作し、そのユーザーがアクセスできるものすべてにアクセスできる」と明記しています。つまり接続した瞬間から、あなたに見えるページはAIにも見えます。確認しておくことは次の3点です。

接続するNotionアカウントのアクセス範囲（人事情報など見せたくないページが共有されていないか）
使いたい機能のプラン条件（横断検索・複数ソースクエリ・議事録クエリはNotion AIやプラン上位が条件）
Enterpriseの場合、管理者がMCPクライアント接続を許可制で管理しているか（管理者への確認）

Notion自体をこれから触る方は、Notionの使い方入門で基本操作とページ・データベースの概念を先に押さえておくと、この後のワークフロー設計がスムーズです。

接続手順：コマンド1行＋OAuth認可

Notion公式ドキュメント（2026年7月確認）に記載されたClaude Code向けの手順は次の2ステップです。

# 1. HTTPトランスポートで登録（通常のターミナルで実行）
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 2. Claude Code内で認証
/mcp
# → notionを選び、ブラウザでワークスペースを認可（ワンクリックOAuth）

全プロジェクトで使いたい場合は –scope user、チームで設定を共有したい場合は –scope project（.mcp.jsonに保存）を付けます。認可後はClaude Code起動のたびに自動で再接続されるので、認証作業は基本的に初回のみです（トークン失効時のみ再認証が必要になります）。

実践ワークフロー：仕様書・タスク・議事録を開発コンテキストにする

開発での使い方は「読む」「書き戻す」「起こす」の3パターンに整理できます。

読む：仕様書ページを検索・取得して、その内容を前提に実装させる
書き戻す：実装・テスト完了後、タスクDBのステータスや実装メモを更新させる
起こす：議事録ページから決定事項を抽出し、タスクやTODOページとして作成させる

「読む」パターンのプロンプト例です。仕様の正本がNotionにあることを明示し、実装前に要約させて認識合わせをするのがポイントです。

Notionで「会員登録フォーム 仕様」のページを検索して読み込み、
実装前に要件を箇条書きで要約してください。

- 要約に抜けがないか私が確認してから実装に入ること
- 実装完了後、タスクDB「開発タスク」の該当行のステータスを
  「レビュー待ち」に更新し、実装内容の要約をコメントで残すこと

FigmaのMCP連携（デザインの正本）と組み合わせると、「仕様はNotion・デザインはFigma・実装はClaude Code」という正本の分担がそのままAIワークフローになります。デザイン側はFigmaとClaude Codeを連携する方法を参照してください。

精度と安全のコツ

運用で押さえておきたいポイントは3つです。

権限は「見えるもの全部」前提で設計する：接続ユーザーの権限がそのまま適用されるため、開発用ワークスペース（またはアクセス範囲を絞ったアカウント）で接続するのが安全
検索は回数を意識する：notion-searchには毎分30リクエストのレート制限がある。広く浅く何度も検索させるより、対象ページのURLを直接渡す方が速くて確実
書き込みの境界を決める：更新してよいDB・ページをプロンプトやCLAUDE.mdで明示し、それ以外は読み取り専用として扱わせる

チーム利用でガバナンスが必要な場合、Enterpriseプランでは管理者が接続可能なMCPクライアントを許可制で管理できます（Notionヘルプセンター・2026年7月確認）。

OSS版notion-mcp-serverとの使い分け

Notionには、公式GitHubで公開されているローカル実行型のOSS版（makenotion/notion-mcp-server）もあります。こちらはインテグレーショントークン認証で動きますが、リポジトリ自身が「リモートのNotion MCPを優先・サポートし、本ローカル版は将来sunset（終了）の可能性がある」と明記しています（2026年7月確認・最新v2.1.0）。

結論として、これから導入するならリモート版（mcp.notion.com＋OAuth）一択です。古い解説記事にあるインテグレーショントークンの発行手順は旧ルートなので、「トークンを発行して環境変数に設定」から始まる手順を見たら、リモート版の手順（本記事の2ステップ）に読み替えてください。

NotionとClaude Codeの連携に関するFAQ

Q. Notion MCPは無料プランでも使えますか？

接続自体のプラン条件は公式に明記されていません。確定しているのは機能ごとの条件で、Notion AIなしでは検索がワークスペース内のみ、複数データソースの一括クエリはEnterprise＋Notion AI、議事録クエリはBusiness以上＋Notion AIが必要です。まず自分のプランで接続し、使いたい機能が動くかを確認するのが確実です。

Q. Claude CodeからNotionのどこまで見えますか？

接続したユーザーがアクセスできる範囲すべてです。公式ヘルプが「MCPツールは接続ユーザーのNotion権限で動作する」と明記しており、権限を超えた閲覧はできない一方、あなたに見えるものはAIにも見える前提で接続アカウントを選ぶ必要があります。

Q. OSS版のnotion-mcp-serverとどちらを使うべきですか？

新規導入ならリモート版（mcp.notion.com＋OAuth）が推奨です。OSS版は公式リポジトリ自身が「リモート版を優先サポートし、将来終了の可能性がある」と告知しているため、既存運用がある場合を除いて選ぶ理由はほぼありません。

Q. データベースの集計や横断検索もできますか？

単一データベースへのクエリはnotion-query-data-sourcesで可能です。複数データソースをまたぐ一括クエリはEnterprise＋Notion AI、Slack・Google Drive等を含む横断検索はNotion AIが条件になるため、チームのプラン構成にあわせて設計してください。

Q. レート制限はありますか？

公式に明記されているのはnotion-searchの毎分30リクエストです。検索を多用するワークフローでは、対象ページのURLを直接渡して取得系ツールを使う構成にすると制限に当たりにくくなります。

まとめ

NotionとClaude Codeの連携は、開発情報の正本をコピペせずにAIワークフローへ組み込む公式ルートです。要点をまとめます。

接続は claude mcp add –transport http notion https://mcp.notion.com/mcp ＋ /mcp のOAuth認可だけ
使い方は「読む（仕様書）・書き戻す（タスクDB）・起こす（議事録→TODO）」の3パターン
AIには接続ユーザーの見えるものが全部見える。接続アカウントの権限設計が安全の要
横断検索・複数ソースクエリ等はプランとNotion AIに依存。無料プラン可否は断定情報なし
OSS版（トークン認証）は旧ルート。新規はリモート版一択

まずは仕様書1ページを読み込ませて実装させる「読む」パターンから始めると、効果が最短で体感できます。

NotionとClaude Codeを連携する方法｜公式MCPで仕様書・タスクを開発コンテキスト化する