Notion MCP サーバー

Claude やその他の AI アシスタントを Notion ワークスペースに接続する Model Context Protocol (MCP) サーバー。この統合により、AI アシスタントは Notion のデータベース、ページ、ブロックとやり取りできるようになります。

これは何ですか？

このツールは、AIアシスタント（Claudeなど）とNotionワークスペースをつなぐ橋渡しとして機能します。AIは以下のことが可能になります。

• Notionデータベースの表示と検索
• ページの作成と更新
• コンテンツブロックを管理する
• その他にも多数あります!

ステップバイステップのセットアップガイド

前提条件

• Node.js (バージョン 14 以上)
• Notionアカウント
• Claude デスクトップ アプリ (Claude と併用する場合)

1. Notion APIキーの取得

1. https://www.notion.so/my-integrationsにアクセスしてください。
2. 青い**「+新しい統合」**ボタンをクリックします
3. 詳細を入力してください:
   • 名前: 「Claude Assistant」や「AI Helper」などの名前を選択します
   • ロゴ: オプション
   • 関連ワークスペース: Notionワークスペースを選択してください
4. **「送信」**をクリック
5. 次のページで、 **「内部統合トークン」**セクションを見つけます
6. **「表示」**をクリックしてトークンをコピーします（ secret_で始まります）。

2. このサーバーの設定

1. このリポジトリをコンピュータにダウンロードします
   • Gitをお持ちの場合: git clone [repository-url]
   • またはZIPファイルをダウンロードして解凍してください
2. コマンドプロンプトまたはターミナルを開きます
   • Windows: Win+Rを押して、 cmdと入力し、Enter を押します。
   • Mac: アプリケーション > ユーティリティからターミナルを開きます
3. このリポジトリをダウンロードしたフォルダに移動します。
   cd path/to/notion-mcp-server
4. 必要な依存関係をインストールします。
   npm install
5. 設定ファイルを作成します。
   • .env.exampleのコピーを作成し、 .envという名前を付けます。
   • テキストエディタで.envファイルを開きます
   • your_notion_api_key_here先ほどコピーしたトークンに置き換えます
   • ファイルを保存する

3. Notionページへの接続

セキュリティ上の理由から、Notion では各ページまたはデータベースへのアクセスを明示的に許可する必要があります。

1. Notionを開き、AIにアクセスさせたいページまたはデータベースに移動します
2. 右上隅の**「•••」** （3つの点）をクリックします
3. **「接続を追加」**を選択
4. 先ほど作成した統合を見つけて選択します
5. アクセス可能にしたい他のページやデータベースについても繰り返します

4. Claude Desktopへの接続

1. Claude Desktop 構成ファイルを見つけます。
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (このパスをファイルエクスプローラーのアドレスバーに入力してください)
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (Finder で、Cmd+Shift+G を押してこのパスを貼り付けます)
2. テキストエディタでファイルを開きます。ファイルが存在しない場合は、以下の内容で作成してください。
   { "mcpServers": { "notion": { "command": "node", "args": [ "C:\\path\\to\\notion-mcp-server\\server.js" ], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
3. 交換する：
   • C:\\path\\to\\notion-mcp-server\\server.js server.js ファイルへの実際のパスに置き換えます。
     • Windows: パスに二重のバックスラッシュ (\\) を使用します
     • Mac: スラッシュ (/) を使用する
   • your_notion_api_key_hereに Notion API キーを入力します
4. ファイルを保存し、Claude Desktopを再起動します。

5. 接続のテスト

1. クロードで新しい会話を始める
2. Claude に Notion ワークスペースを操作するように依頼します。例:
   • 「Notionデータベースのリストを表示」
   • 「タスクデータベースに「テストタスク」というタイトルの新しいページを作成します」

利用可能なツール

サーバーは AI アシスタントに次のツールを提供します。

• list-databases : アクセス可能なすべてのデータベースを表示する
• query-database : データベースからエントリを取得する
• create-page : データベースに新しいページを追加する
• update-page : 既存のページを変更する
• create-database : 新しいデータベースを作成する
• update-database : データベース構造を変更する
• get-page : 特定のページを表示する
• get-block-children : コンテンツブロックを表示する
• append-block-children : ページにコンテンツを追加する
• update-block : コンテンツブロックを編集する
• get-block : 特定のブロックを表示する
• 検索: ワークスペース全体のコンテンツを検索

トラブルシューティング

よくある問題:

1. クロードの「接続に失敗しました」
   • claude_desktop_config.json のサーバーパスが正しいことを確認してください
   • Notion APIキーが有効であることを確認してください
   • Node.jsが正しくインストールされていることを確認する
2. Notionコンテンツにアクセスすると「アクセスが拒否されました」
   • ページ/データベースを統合で共有していることを確認してください
   • APIキーに必要な権限があることを確認してください
3. サーバーが起動しません
   • すべての依存関係がインストールされていることを確認する（ npm install ）
   • APIキーを含む.envファイルが存在することを確認してください

ヘルプの取得

ここに記載されていない問題が発生した場合は、次の手順に従ってください。

• コンソール出力でエラーメッセージを確認します
• Notion APIキーが有効であることを確認してください
• 統合がページ/データベースにアクセスできることを確認します

ライセンス

マサチューセッツ工科大学