# 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ì?](/docs/mcp/what-is-mcp).

## 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ì?](/docs/mcp/what-is-mcp) 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](/docs/mcp/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`:

```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](/docs/mcp/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](/docs/mcp/troubleshooting).

## 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](/docs/mcp/troubleshooting).

## 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ó:

```bash
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](/docs/mcp/custom-client).

## 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ì?](/docs/mcp/what-is-mcp)
- [Thiết lập Claude Desktop](/docs/mcp/claude-desktop)
- [Khắc phục sự cố MCP](/docs/mcp/troubleshooting)