リモート MCP 接続ガイド

Claude Code（CLI）

ターミナルから1コマンドで追加します。

claude mcp add seisakudb \
  --transport http \
  --url https://seisakudb.jp/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

または .claude/settings.local.json に直接記述します。

{
  "mcpServers": {
    "seisakudb": {
      "type": "http",
      "url": "https://seisakudb.jp/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop

mcp-remote パッケージ経由で接続します（Node.js 18 以上が必要）。

{
  "mcpServers": {
    "seisakudb": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://seisakudb.jp/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加します。

{
  "mcpServers": {
    "seisakudb": {
      "url": "https://seisakudb.jp/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

その他（curl / 直接接続）

標準的な MCP Streamable HTTP リクエストです。

# 1. initialize（要 API キー・レート制限の対象外）
curl -X POST https://seisakudb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-03-26",
                 "capabilities":{},
                 "clientInfo":{"name":"my-app","version":"1.0"}}}'

# 2. tools/call（要 API キー。Mcp-Session-Id は initialize 応答ヘッダから）
curl -X POST https://seisakudb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Mcp-Session-Id: <session-id>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_top_listed","arguments":{"limit":10}}}'