# MCP trong Claude Desktop

Claude Desktop là ứng dụng desktop của Anthropic cho macOS và Windows. Với
Synapse MCP server được cấu hình, Claude có quyền truy cập native đến tất cả 79
công cụ Synapse — nó có thể lưu bộ nhớ, thu hồi chúng, quản lý tác vụ, chat với
bạn và hơn thế nữa.

## Điều kiện tiên quyết

- Ứng dụng Claude Desktop (macOS hoặc Windows)
- Node.js 18+ đã cài đặt (`node --version`)
- Synapse Mind Key của bạn

## Bước 1: Mở tệp cấu hình

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Nếu tệp không tồn tại, tạo nó.

## Bước 2: Thêm Synapse MCP Server

```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]
> Nếu bạn đã có các MCP server khác được cấu hình, chỉ cần thêm block
> `"synapse"` vào trong object `"mcpServers"` hiện có.

## Bước 3: Khởi động lại Claude Desktop

1. Thoát hoàn toàn Claude Desktop (Cmd+Q trên macOS, không chỉ đóng cửa sổ)
2. Mở lại Claude Desktop
3. Bắt đầu chat mới
4. Tìm biểu tượng phích cắm 🔌 ở dưới cùng bên trái — nó nên hiển thị "79 tools"

## Bước 4: Kiểm tra nó

Trong chat mới, gõ:

```
memory_recall aufrufen
```

Claude sẽ gọi công cụ `memory_recall` và phản hồi với tóm tắt bộ nhớ đã lưu của
bạn (hoặc "No memories yet" nếu mind của bạn trống).

## Công cụ khả dụng (Lựa chọn)

| Công cụ | Mô tả |
|------|-------------|
| `memory_recall` | Thu hồi tất cả bộ nhớ |
| `memory_store` | Lưu bộ nhớ mới |
| `memory_search` | Tìm kiếm bộ nhớ |
| `task_list` | Liệt kê tác vụ |
| `task_create` | Tạo tác vụ |
| `chat_poll` | Kiểm tra tin nhắn mới |
| `chat_reply` | Trả lời tin nhắn |
| `browser_new` | Mở tab trình duyệt |
| `computer_list` | Liệt kê máy tính đã đăng ký |

Danh sách đầy đủ: [MCP là gì?](/docs/mcp/what-is-mcp)

## Khắc phục sự cố

### Không có công cụ xuất hiện trong Claude Desktop

1. Xác minh phiên bản Node.js: `node --version` (phải ≥ 18)
2. Kiểm tra tệp cấu hình là JSON hợp lệ (không có dấu phẩy cuối)
3. Khởi động lại Claude Desktop hoàn toàn (Cmd+Q, không chỉ đóng)
4. Kiểm tra nhật ký Claude Desktop: `~/Library/Logs/Claude/mcp.log` (macOS)

### Lỗi "Mind Key invalid"

- Xác minh `SYNAPSE_MIND_KEY` bắt đầu bằng `mk_`
- Lấy key mới qua `POST /minds` (yêu cầu JWT từ `/login`)
- Không có dấu ngoặc kép quanh key trong JSON

### npx không tìm thấy

- Cài đặt Node.js 18+: <https://nodejs.org/>
- Khởi động lại terminal sau khi cài đặt
- Trên macOS với Homebrew: `brew install node`

### Công cụ hiển thị nhưng lệnh gọi thất bại

- Kiểm tra `SYNAPSE_URL` có thể truy cập: `curl https://synapse.schaefer.zone/health`
- Xác minh Mind Key của bạn hoạt động: `curl -H "Authorization: Bearer mk_..." https://synapse.schaefer.zone/memory/recall`
- Xem [Khắc phục sự cố MCP](/docs/mcp/troubleshooting)

## Tool Profile (Tiết kiệm Token)

Nếu bạn đang sử dụng LLM nhỏ hơn hoặc muốn tiết kiệm token ngữ cảnh, đặt tool
profile:

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

Profile: `minimal` (8 công cụ), `standard` (25), `full` (119, mặc định).

## Bước tiếp theo

- [Thiết lập Claude Code](/docs/mcp/claude-code)
- [Thiết lập Cursor](/docs/mcp/cursor)
- [Khắc phục sự cố MCP](/docs/mcp/troubleshooting)