Skip to main content

MCP とは?

Model Context Protocol は LLM が外部ツールを呼び出すことを可能にします。Synapse は公式 MCP サーバーで 79 ツールを公開。


MCP とは?

Model Context Protocol(MCP) は Anthropic(2024)によるオープン標準で、LLM が構造化された方法で外部ツールを呼び出せるようにします。プロンプトに API ドキュメントを貼り付ける代わりに、MCP サーバーにツールを登録し、LLM が必要に応じて呼び出します — 関数呼び出しのようなものですが、標準化されクライアント非依存です。

Synapse MCP サーバー

Synapse は公式 MCP サーバー(npm の synapse-mcp-api)を同梱し、Synapse のすべての機能をカバーする 79 ツール を公開します:

カテゴリ ツール
Memory recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export 22
Chat poll, reply, status, history, unread, send, upload 7
Scheduler cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete 8
Tasks task_list, task_get, task_create, task_update 4
Scripts script_list, script_get, script_info, script_store, script_delete 5
Computers computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete 9
Push vapid_public_key, subscribe, unsubscribe, test 4
User/Mind register, login, minds_list, mind_create, mind_delete 5
Utility time, calc, random 3
Visualization graph, tags, compact 3
Sharing share, list, revoke 3
Webhooks register, list, get, update, delete 5
Browser new, navigate, click, type, screenshot, close 6
合計 79+

仕組み

┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
  1. LLM クライアント(Claude Desktop、Cursor など)を設定して Synapse MCP サーバーを使用します
  2. クライアントが MCP サーバーを起動します(npx -y synapse-mcp-api@latest 経由)
  3. MCP サーバーは Mind Key を使用して Synapse API に接続します
  4. LLM は 79 個すべてのツールを呼び出し可能なネイティブ関数として見ます
  5. LLM が何かを記憶する必要があるとき、memory_store を呼び出します — MCP サーバーはこれを Synapse の POST /memory に変換します

トランスポート

Synapse MCP サーバーは 3 つのトランスポートをサポートします:

stdio(ローカル、デスクトップに推奨)

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-mcp-api@latest"],
      "env": {
        "SYNAPSE_MIND_KEY": "mk_...",
        "SYNAPSE_URL": "https://synapse.schaefer.zone"
      }
    }
  }
}

HTTP/SSE(リモート、マルチテナント)

MCP クライアントを次に接続:

URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY

WebSocket(モバイル、高頻度)

URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

ツールプロファイル(v1.4.0)

より小さい LLM のトークンオーバーヘッドを減らすため、MCP サーバーは 3 つのツールプロファイルをサポートします:

プロファイル ツール トークン 最適な用途
minimal 8(コンポジットディスパッチ) ~500 ≤8k コンテキストのセルフホスト LLM
standard 25(名前付き) ~2,500 中規模 LLM(Claude Haiku、GPT-3.5)
full 119(すべて) ~8,250 大規模 LLM(Claude Sonnet/Opus、GPT-4) — デフォルト

制御方法:

  • 環境変数:MCP_PROFILE=minimal|standard|full
  • ヘッダー:Mcp-Tool-Profile: minimal|standard|full

サポートされるクライアント

  • Claude Desktop — Anthropic のデスクトップアプリ
  • Claude Code — ターミナルコーディングエージェント
  • Cursor — AI 駆動 IDE
  • Continue.dev — オープンソース AI コーディングアシスタント
  • Cline — VS Code 拡張機能
  • MCP 互換の任意のクライアント

直接 API ではなく MCP を使う理由は?

アプローチ 長所 短所
直接 API シンプル、追加レイヤーなし LLM が URL、ヘッダー、認証を知る必要
MCP LLM はネイティブツールを認識、URL 暗記不要 追加の MCP サーバープロセス

ほとんどの LLM エージェントユースケースでは、MCP がより良い選択肢です — LLM は API パスや認証パターンを記憶する必要がありません。

次のステップ