Claude CodeとNotion MCPの安全な連携方法

【結論】解決策 / 実行コマンド

Notion連携は、Notionが提供する公式MCPまたは公式APIを最小権限で利用します。

APIトークンを.claude.jsonへ直書きせず、OAuthまたは環境変数・シークレットストアを使います。

最初は検索と読み取りだけを許可し、ページ作成、更新、削除は別承認にします。

# ターミナルで実行：登録済みMCPを確認
claude mcp list
# ターミナルで実行：MCP管理コマンドを確認
claude mcp --help
# 起動後のセッション内で実行：接続と認証状態を確認
/mcp

具体的な手順・設定方法

1. Notion側でインテグレーションまたはOAuth接続を作成します。

2. 対象ページやデータベースだけを共有し、不要なワークスペース権限を与えません。

3. Claude Codeで接続確認後、1件の読み取り、1件のテスト作成、更新前レビューの順で検証します。

実践プロンプト / 活用テクニック

# 起動後のセッション内で入力
Notion MCPを読み取り専用で使用してください。
データベース「バグトラッカー」から未対応項目を最大10件取得し、タイトル、優先度、URLだけを表示してください。
ページ更新、コメント、ステータス変更、ローカルファイル編集は行わないでください。

注意点・よくあるエラーと対処法

非公式MCPパッケージ名を公式実装として固定しないでください。

Notionの親ページを共有していない場合、APIからデータベースが見えません。

顧客情報、人事情報、秘密情報を取得する場合は、組織のデータ取り扱い規程を確認してください。