Claude Desktop での MCP

Claude Desktop は macOS と Windows 向けの Anthropic のデスクトップアプリです。Synapse MCP サーバーを設定すると、Claude は 79 個すべての Synapse ツールにネイティブアクセスします — メモリの保存、リコール、タスク管理、チャットなどが可能です。

前提条件

• Claude Desktop アプリ（macOS または Windows）
• Node.js 18+ がインストール済み（node --version）
• Synapse Mind Key

ステップ 1：設定ファイルを開く

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

ファイルが存在しない場合は作成してください。

ステップ 2：Synapse MCP サーバーを追加

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

ステップ 3：Claude Desktop を再起動

1. Claude Desktop を完全に終了（macOS では Cmd+Q、ウィンドウを閉じるだけではありません）
2. Claude Desktop を再度開く
3. 新しいチャットを開始
4. 左下の 🔌 プラグアイコンを探します —「79 tools」と表示されるはずです

ステップ 4：テスト

新しいチャットで次のように入力します：

memory_recall aufrufen

Claude は memory_recall ツールを呼び出し、保存されたメモリのサマリーで応答するはずです（mind が空の場合は「No memories yet」）。

利用可能なツール（抜粋）

完全なリスト：What is MCP?

トラブルシューティング

Claude Desktop にツールが表示されない

1. Node.js バージョンを確認：node --version（≥ 18 であること）
2. 設定ファイルが有効な JSON か確認（末尾のカンマなし）
3. Claude Desktop を完全に再起動（Cmd+Q、閉じるだけではない）
4. Claude Desktop ログを確認：~/Library/Logs/Claude/mcp.log（macOS）

「Mind Key invalid」エラー

• SYNAPSE_MIND_KEY が mk_ で始まることを確認
• POST /minds で新しいキーを取得（/login の JWT が必要）
• JSON 内のキーに引用符なし

npx が見つからない

• Node.js 18+ をインストール：https://nodejs.org/
• インストール後にターミナルを再起動
• Homebrew を使う macOS の場合：brew install node

ツールは表示されるが呼び出しが失敗

• SYNAPSE_URL に到達できるか確認：curl https://synapse.schaefer.zone/health
• Mind Key が動作するか確認：curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall
• MCP Troubleshooting を参照

ツールプロファイル（トークンを節約）

より小さい LLM を使用する場合やコンテキストトークンを節約したい場合は、ツールプロファイルを設定します：

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

プロファイル：minimal（8 ツール）、standard（25）、full（119、デフォルト）。

次のステップ

• Claude Code Setup
• Cursor Setup
• MCP Troubleshooting