FAQ MCP

Các câu hỏi phổ biến về Synapse MCP server.

MCP là gì?

MCP (Model Context Protocol) là tiêu chuẩn mở của Anthropic cho tích hợp LLM-công cụ. Thay vì dán tài liệu API vào prompt, bạn đăng ký công cụ với một MCP server, và LLM gọi chúng như các hàm native.

Xem MCP là gì?.

Synapse MCP cung cấp bao nhiêu công cụ?

79 công cụ trong 12 danh mục: memory, chat, scheduler, tasks, scripts, computers, push, user, utility, visualization, sharing, webhooks, browser.

Xem MCP là gì? cho danh sách đầy đủ.

Client MCP nào được hỗ trợ?

• Claude Desktop (macOS, Windows)
• Claude Code (terminal)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Bất kỳ client tương thích MCP nào

Xem Thiết lập Claude Desktop cho ví dụ cấu hình.

Transport nào được hỗ trợ?

1. stdio (cục bộ, khuyến nghị cho desktop)
2. HTTP/SSE (từ xa, multi-tenant)
3. WebSocket (di động, khối lượng lớn)

Làm thế nào để cấu hình Claude Desktop?

Chỉnh sửa 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"
      }
    }
  }
}

Xem Thiết lập Claude Desktop.

Tại sao công cụ không xuất hiện trong Claude Desktop?

1. Khởi động lại Claude Desktop hoàn toàn (Cmd+Q trên macOS)
2. Kiểm tra tệp cấu hình là JSON hợp lệ
3. Xác minh Node.js 18+ đã cài đặt
4. Kiểm tra nhật ký MCP: ~/Library/Logs/Claude/mcp.log

Xem Khắc phục sự cố MCP.

Làm thế nào để sử dụng một mind khác?

Thay đổi SYNAPSE_MIND_KEY trong cấu hình MCP và khởi động lại client.

Cho nhiều mind, chạy nhiều thể hiện MCP server với các Mind Key khác nhau.

Tôi có thể giới hạn công cụ nào được lộ không?

Có, sử dụng Tool Profile:

• minimal: 8 công cụ tổng hợp (~500 token)
• standard: 25 công cụ (~2.500 token)
• full: 119 công cụ (~8.250 token, mặc định)

Đặt qua biến môi trường MCP_PROFILE hoặc header Mcp-Tool-Profile.

Làm thế nào để gỡ lỗi vấn đề MCP?

1. Chạy MCP server thủ công: npx -y synapse-mcp-api@latest
2. Kiểm tra nhật ký client (khác nhau tùy client)
3. Xác minh Mind Key hoạt động: curl -H "Authorization: Bearer mk_..." .../memory/recall
4. Kiểm tra sức khỏe Synapse: curl https://synapse.schaefer.zone/health

Xem Khắc phục sự cố MCP.

MCP server có miễn phí không?

Có. Gói npm synapse-mcp-api là mã nguồn mở. MCP server được lưu trữ tại synapse-mcp.schaefer.zone miễn phí cho sử dụng công khai.

Tôi có thể tự lưu trữ MCP server không?

Có:

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

MCP khác với lệnh gọi API trực tiếp như thế nào?

Khía cạnh	API trực tiếp	MCP
LLM cần biết	URL, header, xác thực	Chỉ tên công cụ
Xử lý xác thực	Thủ công	Tự động (biến môi trường)
Khám phá công cụ	Đọc /endpoints	Tự động qua giao thức MCP
Xử lý lỗi	Thủ công	Chuẩn hóa
Tốt nhất cho	Tích hợp tùy chỉnh	LLM agent

Tôi có thể xây dựng client MCP riêng không?

Có. Sử dụng SDK MCP chính thức:

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

Xem Client MCP tùy chỉnh.

Làm thế nào để báo cáo bug MCP?

Mở issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Bao gồm:

• Phiên bản MCP server
• Tên và phiên bản client
• Hệ điều hành
• Nhật ký liên quan
• Các bước tái hiện

Bước tiếp theo

• MCP là gì?
• Thiết lập Claude Desktop
• Khắc phục sự cố MCP