{"title":"Claude Desktop での MCP","slug":"claude-desktop","category":"mcp","summary":"Synapse を Claude Desktop に 2 分で接続。Claude は Synapse の 79 ツールをネイティブに取得。","audience":["human","llm"],"tags":["mcp","claude","desktop","integration"],"difficulty":"beginner","updated":"2026-06-27","word_count":215,"read_minutes":1,"llm_context":"Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n %APPDATA%\\Claude\\claude_desktop_config.json (Windows)\nMCP server command: npx -y synapse-mcp-api@latest\nEnv vars: SYNAPSE_MIND_KEY (required), SYNAPSE_URL (optional, default https://synapse.schaefer.zone)\nAfter config: restart Claude Desktop, check for 🔌 icon with \"79 tools\"\nTest: type \"memory_recall aufrufen\" in a new chat\nTroubleshooting: Node.js ≥ 18, check Mind Key, see /docs/mcp/troubleshooting\n","lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# Claude Desktop での MCP\n\nClaude Desktop は macOS と Windows 向けの Anthropic のデスクトップアプリです。Synapse MCP サーバーを設定すると、Claude は 79 個すべての Synapse ツールにネイティブアクセスします — メモリの保存、リコール、タスク管理、チャットなどが可能です。\n\n## 前提条件\n\n- Claude Desktop アプリ（macOS または Windows）\n- Node.js 18+ がインストール済み（`node --version`）\n- Synapse Mind Key\n\n## ステップ 1：設定ファイルを開く\n\n- **macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows：** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nファイルが存在しない場合は作成してください。\n\n## ステップ 2：Synapse MCP サーバーを追加\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n> [!TIP]\n> 既に他の MCP サーバーを設定している場合は、既存の `\"mcpServers\"` オブジェクト内に `\"synapse\"` ブロックを追加するだけです。\n\n## ステップ 3：Claude Desktop を再起動\n\n1. Claude Desktop を完全に終了（macOS では Cmd+Q、ウィンドウを閉じるだけではありません）\n2. Claude Desktop を再度開く\n3. 新しいチャットを開始\n4. 左下の 🔌 プラグアイコンを探します —「79 tools」と表示されるはずです\n\n## ステップ 4：テスト\n\n新しいチャットで次のように入力します：\n\n```\nmemory_recall aufrufen\n```\n\nClaude は `memory_recall` ツールを呼び出し、保存されたメモリのサマリーで応答するはずです（mind が空の場合は「No memories yet」）。\n\n## 利用可能なツール（抜粋）\n\n| ツール | 説明 |\n|------|-------------|\n| `memory_recall` | すべてのメモリをリコール |\n| `memory_store` | 新しいメモリを保存 |\n| `memory_search` | メモリを検索 |\n| `task_list` | タスクを一覧 |\n| `task_create` | タスクを作成 |\n| `chat_poll` | 新着メッセージを確認 |\n| `chat_reply` | メッセージに返信 |\n| `browser_new` | ブラウザタブを開く |\n| `computer_list` | 登録されたコンピュータを一覧 |\n\n完全なリスト：[What is MCP?](/docs/mcp/what-is-mcp)\n\n## トラブルシューティング\n\n### Claude Desktop にツールが表示されない\n\n1. Node.js バージョンを確認：`node --version`（≥ 18 であること）\n2. 設定ファイルが有効な JSON か確認（末尾のカンマなし）\n3. Claude Desktop を完全に再起動（Cmd+Q、閉じるだけではない）\n4. Claude Desktop ログを確認：`~/Library/Logs/Claude/mcp.log`（macOS）\n\n### 「Mind Key invalid」エラー\n\n- `SYNAPSE_MIND_KEY` が `mk_` で始まることを確認\n- `POST /minds` で新しいキーを取得（`/login` の JWT が必要）\n- JSON 内のキーに引用符なし\n\n### npx が見つからない\n\n- Node.js 18+ をインストール：\n- インストール後にターミナルを再起動\n- Homebrew を使う macOS の場合：`brew install node`\n\n### ツールは表示されるが呼び出しが失敗\n\n- `SYNAPSE_URL` に到達できるか確認：`curl https://synapse.schaefer.zone/health`\n- Mind Key が動作するか確認：`curl -H \"Authorization: Bearer mk_...\" https://synapse.schaefer.zone/memory/recall`\n- [MCP Troubleshooting](/docs/mcp/troubleshooting) を参照\n\n## ツールプロファイル（トークンを節約）\n\nより小さい LLM を使用する場合やコンテキストトークンを節約したい場合は、ツールプロファイルを設定します：\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n \"MCP_PROFILE\": \"standard\"\n }\n }\n }\n}\n```\n\nプロファイル：`minimal`（8 ツール）、`standard`（25）、`full`（119、デフォルト）。\n\n## 次のステップ\n\n- [Claude Code Setup](/docs/mcp/claude-code)\n- [Cursor Setup](/docs/mcp/cursor)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

Claude Desktop での MCP

\n

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

\n

前提条件

\n\n

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

\n\n

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

\n

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

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}
既に他の MCP サーバーを設定している場合は、既存の `\"mcpServers\"` オブジェクト内に `\"synapse\"` ブロックを追加するだけです。

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

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

ステップ 4：テスト

\n

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

\n
memory_recall aufrufen

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

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ツール説明
memory_recallすべてのメモリをリコール
memory_store新しいメモリを保存
memory_searchメモリを検索
task_listタスクを一覧
task_createタスクを作成
chat_poll新着メッセージを確認
chat_replyメッセージに返信
browser_newブラウザタブを開く
computer_list登録されたコンピュータを一覧
\n

完全なリスト：What is MCP?

\n

トラブルシューティング

\n

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

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

「Mind Key invalid」エラー

\n\n

npx が見つからない

\n\n

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

\n\n

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

\n

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

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

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

\n

次のステップ

\n\n","urls":{"html":"/docs/mcp/claude-desktop","text":"/docs/mcp/claude-desktop?format=text","json":"/docs/mcp/claude-desktop?format=json","llm":"/docs/mcp/claude-desktop?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}