Skip to main content

MCP FAQ

beginner 🤖 LLM対応 1 分 · 259 語 更新日: 2026-06-27 日本語

MCP 連携に関するよくある質問 — ツール、トランスポート、トラブルシューティング。

この記事を読む形式: 📄 プレーンテキスト ⚡ JSON 🤖 LLM形式
言語: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

MCP FAQ

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

MCP とは何ですか？

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

What is MCP? を参照。

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

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

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

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

  • Claude Desktop（macOS、Windows）
  • Claude Code（ターミナル）
  • Cursor（IDE）
  • Continue.dev（VS Code、JetBrains）
  • Cline（VS Code）
  • MCP 互換の任意のクライアント

設定例は Claude Desktop Setup を参照。

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

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

Claude Desktop での設定方法は？

claude_desktop_config.json を編集します。

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

Claude Desktop Setup を参照。

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

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

MCP Troubleshooting を参照。

別の mind を使うには？

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

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

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

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

  • minimal：8 コンポジットツール（約 500 トークン）
  • standard：25 ツール（約 2,500 トークン）
  • full：119 ツール（約 8,250 トークン、デフォルト）

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

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

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

MCP Troubleshooting を参照。

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

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

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

はい。

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

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

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

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

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

  • TypeScript：@modelcontextprotocol/sdk
  • Python：mcp

Custom MCP Client を参照。

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

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

含めるもの：

  • MCP サーバーのバージョン
  • クライアント名とバージョン
  • オペレーティングシステム
  • 関連ログ
  • 再現手順

次のステップ

← よくある質問 に戻る