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. このサーバーの設定

リポジトリをダウンロードする

オプションA: ZIP形式でダウンロード（初心者に推奨）

1. GitHub リポジトリに移動します: https://github.com/Sjotie/notionMCP/
2. 右上の緑色の「コード」ボタンをクリックします
3. 「ZIPをダウンロード」を選択
4. ダウンロードしたら、ZIPファイルをコンピュータ上の場所に解凍します。
   • Windows: ZIPファイルを右クリックし、「すべて展開」を選択します。
   • Mac: ZIPファイルをダブルクリックして解凍します

オプション B: Git でクローンする (Git に慣れているユーザー向け)

1. コマンドプロンプトまたはターミナルを開きます
   • Windows: Win+Rを押して、 cmdと入力し、Enter を押します。
   • Mac: アプリケーション > ユーティリティからターミナルを開きます
2. リポジトリを保存する場所に移動します
   cd path/to/desired/location
3. リポジトリをクローンする
   git clone https://github.com/Sjotie/notionMCP/

プロジェクトディレクトリに移動する

ダウンロードまたはクローン作成後、 cd (ディレクトリ変更) コマンドを使用してプロジェクト フォルダーに移動する必要があります。

ZIP をダウンロードした場合 (オプション A):

1. コマンドプロンプトまたはターミナルを開きます
2. cdコマンドを使用して、ZIP ファイルを抽出した場所に移動します。
   cd path/to/extracted/folder/notionMCP
   例えば：
   • Windowsの場合: cd C:\Users\YourName\Downloads\notionMCP
   • Macの場合: cd /Users/YourName/Downloads/notionMCP

Git でクローンした場合 (オプション B):

1. リポジトリは「notionMCP」という名前のフォルダにクローンされているはずです。
2. クローン作成後も同じターミナル ウィンドウにいる場合は、次のように入力します。
   cd notionMCP

正しいディレクトリにいるかどうかを確認する方法:

• cdコマンドを使用した後、現在の場所を確認できます。
  • Windowsの場合: dirと入力してEnterキーを押すと、 server.jsのようなファイルが表示されます。
  • Macの場合: lsと入力してEnterキーを押すと、 server.jsのようなファイルが表示されます。

依存関係をインストールする

notionMCP ディレクトリに移動したら、必要な依存関係をインストールします。

これで必要なNode.jsパッケージがすべてインストールされます。プログレスバーが表示され、インストールが完了したことを示すメッセージが表示されます。「Xパッケージが資金を探しています」といったメッセージが表示される場合もありますが、これは全く正常な動作であり、正常にインストールされたことを意味します。

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キーが有効であることを確認してください
• 統合がページ/データベースにアクセスできることを確認する

ライセンス

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