notion-mcp-server

Name: notion-mcp-server
Availability: InStock
Author: Notion

Notion MCP Serverは、Notion APIを利用したリモートMCPサーバーで、簡単なOAuthによるインストールが可能です。AIエージェント向けに最適化されたツールを提供し、トークン消費を効率化しています。これにより、開発者は複雑な設定なしに、強力な機能を活用できます。

GitHub

GitHubスター

3,142

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

289

イシュー

インストール方法

難易度

中級

推定所要時間

10-20 分

必要な環境

Node.js: 18.0.0以上

npm: 8.0.0以上

+1 more

インストール方法

前提条件

必要なソフトウェアとバージョンを明記してください。

Node.js: 18.0.0以上

npm: 8.0.0以上

Claude Desktop: 最新版

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/makenotion/notion-mcp-server.git
cd notion-mcp-server

2. 依存関係のインストール

bash
npm install

3. Claude Desktop設定

claude_desktop_config.jsonを編集してMCPサーバーを追加：

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

4. サーバーの起動

bash
npm start

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Node.jsのバージョンを確認し、依存関係を再インストールしてください。問題: Claude Desktopで認識されない 解決策: 設定ファイルのパスと構文を確認してください。

設定方法

基本設定

Claude Desktop設定

~/.config/claude-desktop/claude_desktop_config.json（macOS/Linux）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集：

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

環境変数

必要に応じて以下の環境変数を設定：

bash
export OPENAPI_MCP_HEADERS="{\"Authorization\": \"Bearer ntn_\", \"Notion-Version\": \"2022-06-28\" }"

詳細設定

セキュリティ設定

APIキーは環境変数または安全な設定ファイルに保存

ファイルアクセス権限の適切な設定

ログレベルの調整

パフォーマンス調整

タイムアウト値の設定

同時実行数の制限

キャッシュ設定

設定例

基本的な設定

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

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します：

Claude Desktopでの使用

1MCPサーバーの起動確認

Claude Desktopを開き、設定が正しく読み込まれていることを確認してください。

2基本コマンドの実行


   Available tools from this MCP server:
   - tool1: Description of tool1
   - tool2: Description of tool2

プログラムでの使用

javascript
// JavaScript例（Node.js）
const { MCPClient } = require('@modelcontextprotocol/client');

const client = new MCPClient();
await client.connect();

// ツールの実行
const result = await client.callTool('toolName', {
  parameter1: 'value1',
  parameter2: 'value2'
});

console.log(result);

応用例

自動化スクリプト

bash
#!/bin/bash
バッチ処理の例

for file in *.txt; do
  mcp-tool process "$file"
done

API統合

python
Python例
import requests
import json

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

使用例
result = call_mcp_tool('analyze', {
    'input': 'sample data',
    'options': {'format': 'json'}
})