Notion MCP サーバー

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

これは何ですか？

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

• Notionデータベースの表示と検索

• ページの作成と更新

• コンテンツブロックを管理する

• その他にも多数あります!

Related MCP server: Notion MCP Server

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

前提条件

• 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 ディレクトリに移動したら、必要な依存関係をインストールします。

npm install

これで必要な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キーが有効であることを確認してください

• 統合がページ/データベースにアクセスできることを確認する

ライセンス

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