Notion MCP サーバー
このプロジェクトは、Notion API用のMCP サーバーを実装します。
インストール
1. Notionでの統合の設定:
https://www.notion.so/profile/integrationsにアクセスし、新しい内部統合を作成するか、既存の統合を選択します。
Notion APIの公開範囲は限定されています（例えば、MCP経由でデータベースを削除することはできません）。しかし、ワークスペースデータをLLMに公開することで、データへのリスクはゼロではありません。セキュリティを重視するユーザーは、統合機能をさらに設定することをお勧めします。
たとえば、「構成」タブから「コンテンツの読み取り」アクセス権のみを付与することで、読み取り専用の統合トークンを作成できます。
2. コンテンツを統合に接続する:
関連するページとデータベースが統合に接続されていることを確認します。
これを行うには、そのページにアクセスし、3 つのドットをクリックして、「統合に接続」を選択する必要があります。
3. クライアントに 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 を使用して MCP サーバーを実行するには、次の 2 つのオプションがあります。
オプション 1: 公式 Docker Hub イメージを使用する:
.cursor/mcp.jsonまたはclaude_desktop_config.jsonに以下を追加します。
{
"mcpServers": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "OPENAPI_MCP_HEADERS",
"mcp/notion"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}
}このアプローチ:
公式Docker Hubイメージを使用
環境変数を介してJSONエスケープを適切に処理します
より信頼性の高い構成方法を提供します
オプション 2: ローカルで Docker イメージをビルドする:
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"
]
}
}
}ntn_****統合シークレットに置き換えることを忘れないでください。統合設定タブから確認することができます。
例
次の命令を使用して
Comment "Hello MCP" on page "Getting started"AIはタスクを達成するために、 v1/searchとv1/comments 2つのAPI呼び出しを正しく計画します。
同様に、次の命令を実行すると、「Notion MCP」という名前の新しいページが親ページ「Development」に追加されます。
Add a page titled "Notion MCP" to page "Development"コンテンツIDを直接参照することもできます
Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2発達
建てる
npm run build実行する
npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server公開
npm publish --access public