{"title":"MCP FAQ","slug":"mcp-faq","category":"faq","summary":"MCP 連携に関するよくある質問 — ツール、トランスポート、トラブルシューティング。","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":259,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# MCP FAQ\n\nSynapse MCP サーバーに関するよくある質問です。\n\n## MCP とは何ですか？\n\nMCP（Model Context Protocol）は LLM とツールの連携のための Anthropic によるオープン標準です。プロンプトに API ドキュメントを貼り付ける代わりに、MCP サーバーにツールを登録し、LLM がネイティブ関数として呼び出します。\n\n[What is MCP?](/docs/mcp/what-is-mcp) を参照。\n\n## Synapse MCP はいくつのツールを公開していますか？\n\n12 カテゴリにわたり **79 ツール**：memory、chat、scheduler、tasks、scripts、computers、push、user、utility、visualization、sharing、webhooks、browser。\n\n完全なリストは [What is MCP?](/docs/mcp/what-is-mcp) を参照。\n\n## どの MCP クライアントがサポートされていますか？\n\n- Claude Desktop（macOS、Windows）\n- Claude Code（ターミナル）\n- Cursor（IDE）\n- Continue.dev（VS Code、JetBrains）\n- Cline（VS Code）\n- MCP 互換の任意のクライアント\n\n設定例は [Claude Desktop Setup](/docs/mcp/claude-desktop) を参照。\n\n## どのトランスポートがサポートされていますか？\n\n1. **stdio**（ローカル、デスクトップに推奨）\n2. **HTTP/SSE**（リモート、マルチテナント）\n3. **WebSocket**（モバイル、高頻度）\n\n## Claude Desktop での設定方法は？\n\n`claude_desktop_config.json` を編集します。\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_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n[Claude Desktop Setup](/docs/mcp/claude-desktop) を参照。\n\n## Claude Desktop にツールが表示されないのはなぜですか？\n\n1. **Claude Desktop を完全に再起動**（macOS では Cmd+Q）\n2. **設定ファイルが有効な JSON か確認**\n3. **Node.js 18+ がインストールされているか確認**\n4. **MCP ログを確認**：`~/Library/Logs/Claude/mcp.log`\n\n[MCP Troubleshooting](/docs/mcp/troubleshooting) を参照。\n\n## 別の mind を使うには？\n\nMCP 設定の `SYNAPSE_MIND_KEY` を変更し、クライアントを再起動してください。\n\n複数の mind を使用するには、異なる Mind Key で複数の MCP サーバーインスタンスを動かします。\n\n## 公開するツールを制限できますか？\n\nはい、**Tool Profiles** を使用します。\n\n- `minimal`：8 コンポジットツール（約 500 トークン）\n- `standard`：25 ツール（約 2,500 トークン）\n- `full`：119 ツール（約 8,250 トークン、デフォルト）\n\n`MCP_PROFILE` 環境変数または `Mcp-Tool-Profile` ヘッダーで設定します。\n\n## MCP の問題をデバッグするには？\n\n1. **MCP サーバーを手動で実行**：`npx -y synapse-mcp-api@latest`\n2. **クライアントログを確認**（クライアントにより異なります）\n3. **Mind Key が動作するか確認**：`curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Synapse のヘルスを確認**：`curl https://synapse.schaefer.zone/health`\n\n[MCP Troubleshooting](/docs/mcp/troubleshooting) を参照。\n\n## MCP サーバーは無料ですか？\n\nはい。npm パッケージ `synapse-mcp-api` はオープンソースです。`synapse-mcp.schaefer.zone` のホスト版 MCP サーバーは公開利用が無料です。\n\n## MCP サーバーをセルフホストできますか？\n\nはい。\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## MCP と直接 API 呼び出しの違いは？\n\n| 側面 | 直接 API | MCP |\n|--------|-----------|-----|\n| LLM が知る必要があるもの | URL、ヘッダー、認証 | ツール名のみ |\n| 認証処理 | 手動 | 自動（環境変数） |\n| ツール探索 | /endpoints を読む | MCP プロトコルで自動 |\n| エラー処理 | 手動 | 標準化 |\n| 最適な用途 | カスタム連携 | LLM エージェント |\n\n## 独自の MCP クライアントを構築できますか？\n\nはい。公式 MCP SDK を使用してください。\n\n- TypeScript：`@modelcontextprotocol/sdk`\n- Python：`mcp`\n\n[Custom MCP Client](/docs/mcp/custom-client) を参照。\n\n## MCP のバグを報告するには？\n\nIssue を開いてください：\n\n含めるもの：\n\n- MCP サーバーのバージョン\n- クライアント名とバージョン\n- オペレーティングシステム\n- 関連ログ\n- 再現手順\n\n## 次のステップ\n\n- [What is MCP?](/docs/mcp/what-is-mcp)\n- [Claude Desktop Setup](/docs/mcp/claude-desktop)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

MCP FAQ

\n

Synapse MCP サーバーに関するよくある質問です。

\n

MCP とは何ですか？

\n

MCP（Model Context Protocol）は LLM とツールの連携のための Anthropic によるオープン標準です。プロンプトに API ドキュメントを貼り付ける代わりに、MCP サーバーにツールを登録し、LLM がネイティブ関数として呼び出します。

\n

What is MCP? を参照。

\n

Synapse MCP はいくつのツールを公開していますか？

\n

12 カテゴリにわたり 79 ツール：memory、chat、scheduler、tasks、scripts、computers、push、user、utility、visualization、sharing、webhooks、browser。

\n

完全なリストは What is MCP? を参照。

\n

どの MCP クライアントがサポートされていますか？

\n\n

設定例は Claude Desktop Setup を参照。

\n

どのトランスポートがサポートされていますか？

\n
    \n
  1. stdio（ローカル、デスクトップに推奨）
    2. \n
  2. HTTP/SSE（リモート、マルチテナント）
    3. \n
  3. WebSocket（モバイル、高頻度）
    4. \n
\n

Claude Desktop での設定方法は？

\n

claude_desktop_config.json を編集します。

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

Claude Desktop Setup を参照。

\n

Claude Desktop にツールが表示されないのはなぜですか？

\n
    \n
  1. Claude Desktop を完全に再起動（macOS では Cmd+Q）
    2. \n
  2. 設定ファイルが有効な JSON か確認
    3. \n
  3. Node.js 18+ がインストールされているか確認
    4. \n
  4. MCP ログを確認：~/Library/Logs/Claude/mcp.log
    5. \n
\n

MCP Troubleshooting を参照。

\n

別の mind を使うには？

\n

MCP 設定の SYNAPSE_MIND_KEY を変更し、クライアントを再起動してください。

\n

複数の mind を使用するには、異なる Mind Key で複数の MCP サーバーインスタンスを動かします。

\n

公開するツールを制限できますか？

\n

はい、Tool Profiles を使用します。

\n\n

MCP_PROFILE 環境変数または Mcp-Tool-Profile ヘッダーで設定します。

\n

MCP の問題をデバッグするには？

\n
    \n
  1. MCP サーバーを手動で実行：npx -y synapse-mcp-api@latest
    2. \n
  2. クライアントログを確認（クライアントにより異なります）
    3. \n
  3. Mind Key が動作するか確認：curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Synapse のヘルスを確認：curl https://synapse.schaefer.zone/health
    5. \n
\n

MCP Troubleshooting を参照。

\n

MCP サーバーは無料ですか？

\n

はい。npm パッケージ synapse-mcp-api はオープンソースです。synapse-mcp.schaefer.zone のホスト版 MCP サーバーは公開利用が無料です。

\n

MCP サーバーをセルフホストできますか？

\n

はい。

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

MCP と直接 API 呼び出しの違いは？

\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
側面直接 APIMCP
LLM が知る必要があるものURL、ヘッダー、認証ツール名のみ
認証処理手動自動（環境変数）
ツール探索/endpoints を読むMCP プロトコルで自動
エラー処理手動標準化
最適な用途カスタム連携LLM エージェント
\n

独自の MCP クライアントを構築できますか？

\n

はい。公式 MCP SDK を使用してください。

\n\n

Custom MCP Client を参照。

\n

MCP のバグを報告するには？

\n

Issue を開いてください：https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

含めるもの：

\n\n

次のステップ

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