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

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

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)

Danh sách đầy đủ: MCP là gì?

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

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:

{
  "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
• Thiết lập Cursor
• Khắc phục sự cố MCP