Makenotion Notion MCP Server

🚀 Notion MCP サーバー

このプロジェクトは、Notion インターフェースに対する MCP サーバー を実装しています。

🚀 クイックスタート

このセクションでは、Notion MCP サーバーのセットアップと使用方法について説明します。

📦 インストール

1. Notion での統合設定

https://www.notion.so/profile/integrations にアクセスし、新しい 内部 統合を作成するか、既存の統合を選択します。

Notion インターフェースの公開範囲を制限していますが（例えば、MCP を通じてデータベースを削除することはできません）、データを LLM に公開することには非ゼロのリスクがあります。セキュリティを重視するユーザーは、統合の 機能 をさらに設定することをお勧めします。

例えば、「コンテンツの読み取り」アクセス権のみを付与する読み取り専用の統合トークンを作成できます（「設定」タブから）：

2. クライアントへの MCP 設定の追加

npm を使用する場合

以下の内容を .cursor/mcp.json または claude_desktop_config.json（MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Docker を使用する場合

まず、Docker イメージをビルドします。

docker-compose build

次に、以下の内容を .cursor/mcp.json または claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server-notion-mcp-server"
      ]
    }
  }
}

ntn_**** をあなたの統合シークレットトークンに置き換えることを忘れないでください。このトークンは、統合設定タブから取得できます。

3. データベースへの接続

Notion で無料アカウントを作成し、いくつかのデータベースを作成します。

💻 使用例

基本的な使用法

コマンドラインでの使用例

echo "{
  \"messages\": [
    {
      \"role\": \"user\",
      \"content\": \"人工知能について教えて。\"
    }
  ],
  \"model\": \"gpt-3.5-turbo\",
  \"temperature\": 0.7
}" | curl -X POST http://localhost:1234/v1/chat/completions

Python での使用例

import requests

url = "http://localhost:1234/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
}
data = {
    "messages": [
        {"role": "user", "content": "人工知能について教えて。"}
    ],
    "model": "gpt-3.5-turbo",
    "temperature": 0.7
}

response = requests.post(url, json=data)
print(response.json())

🔧 技術詳細

開発

依存関係のインストール

npm install

テストの実行

npm test

プロジェクトのビルド

npm run build

サーバーの実行

npm start

📄 注意事項

⚠️ 重要提示

• Notion 統合トークンが適切な権限を持っていることを確認してください。
• テスト時には、より確定的な結果を得るために小さい温度値を使用してください。