はじめに
Claude Code から Notion を直接操作できる Notion MCP の設定方法をまとめます。
従来の設定方法では Notion のインテグレーションページで Secret Key（インテグレーショントークン）を発行する必要がありましたが、リモート Notion MCP（OAuth 認証方式） を使うことで、Secret Key なしでブラウザ認証だけで連携できます。
⚠️ リモート Notion MCP は Beta 版 です。安定性や機能については注意してください。
参考にした記事: https://zenn.dev/woo_noo/articles/a1502e0e88fcfa
こんな人におすすめ
- Notion MCP の Secret Key（インテグレーショントークン）を発行できなかった方
- 組織のセキュリティポリシーやワークスペースの権限制限により、インテグレーションを作成できないケースが該当します
- Claude Code で Notion を活用したい方
- Notion MCP の設定方法を確認したい方
設定方法
step0: Claude Code をインストールする
npm install -g @anthropic-ai/claude-code
ステップ1: MCP を登録する
ターミナルで以下のコマンドを実行します。
claude mcp add --transport http notion https://mcp.notion.com/mcp
-
--transport httpを指定することで、Secret Key 不要のリモート MCP として登録されます - 従来のローカル MCP（
npx @notionhq/notion-mcp-server）とは異なる方式です
ステップ2: Claude Code で認証する
-
Claude Code を起動する（ターミナルで
claudeコマンドを実行） -
/mcpコマンドを入力する -
MCP 一覧から notion を選択して Enter キーを押す
-
ブラウザが自動で起動し、Notion の認証画面に遷移する
-
連携するページ・データベースを選択し、アクセスを許可する
-
Claude Code に戻り、ステータスが connected になれば完了
動作確認
/mcp
notion のステータスが connected と表示されれば正常に接続されています。
接続後は、Notion のページやデータベースの読み取り・書き込みを Claude Code から自然言語で操作できます。
よくある質問
Q. 既存のローカル MCP 設定と共存できますか？
A. できます。ただし、同じ名前（notion）で登録している場合は上書きされます。事前に既存の設定を確認してください。
Q. 認証はどのくらいの頻度で必要ですか？
A. セッションが切れた場合は、再度 /mcp から認証が必要になることがあります。
Q. どのページにアクセスできますか？
A. 認証時に選択したワークスペースのみアクセス可能です。後から追加する場合は再認証が必要です。
まとめ
Secret Key の発行が難しい環境でも、OAuth 認証方式のリモート Notion MCP を使えば、ブラウザ認証だけで Claude Code と Notion を連携できます。まだ Beta 版なので、今後の安定版リリースにも注目したいです。