# MCP FAQ

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

## MCP とは何ですか？

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

[What is MCP?](/docs/mcp/what-is-mcp) を参照。

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

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

完全なリストは [What is MCP?](/docs/mcp/what-is-mcp) を参照。

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

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

設定例は [Claude Desktop Setup](/docs/mcp/claude-desktop) を参照。

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

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

## Claude Desktop での設定方法は？

`claude_desktop_config.json` を編集します。

```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](/docs/mcp/claude-desktop) を参照。

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

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

[MCP Troubleshooting](/docs/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](/docs/mcp/troubleshooting) を参照。

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

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

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

はい。

```bash
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](/docs/mcp/custom-client) を参照。

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

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

含めるもの：

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

## 次のステップ

- [What is MCP?](/docs/mcp/what-is-mcp)
- [Claude Desktop Setup](/docs/mcp/claude-desktop)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)