# 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 サーバーを追加

```json
{
  "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"
      }
    }
  }
}
```

> [!TIP]
> 既に他の MCP サーバーを設定している場合は、既存の `"mcpServers"` オブジェクト内に `"synapse"` ブロックを追加するだけです。

## ステップ 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」）。

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

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

完全なリスト：[What is MCP?](/docs/mcp/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](/docs/mcp/troubleshooting) を参照

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

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

```json
{
  "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](/docs/mcp/claude-code)
- [Cursor Setup](/docs/mcp/cursor)
- [MCP Troubleshooting](/docs/mcp/troubleshooting)