{"title":"FAQ MCP","slug":"mcp-faq","category":"faq","summary":"Câu hỏi phổ biến về tích hợp MCP — công cụ, transport, khắc phục sự cố.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":573,"read_minutes":3,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# FAQ MCP\n\nCác câu hỏi phổ biến về Synapse MCP server.\n\n## MCP là gì?\n\nMCP (Model Context Protocol) là tiêu chuẩn mở của Anthropic cho tích hợp\nLLM-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\nMCP server, và LLM gọi chúng như các hàm native.\n\nXem [MCP là gì?](/docs/mcp/what-is-mcp).\n\n## Synapse MCP cung cấp bao nhiêu công cụ?\n\n**79 công cụ** trong 12 danh mục: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nXem [MCP là gì?](/docs/mcp/what-is-mcp) cho danh sách đầy đủ.\n\n## Client MCP nào được hỗ trợ?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Bất kỳ client tương thích MCP nào\n\nXem [Thiết lập Claude Desktop](/docs/mcp/claude-desktop) cho ví dụ cấu hình.\n\n## Transport nào được hỗ trợ?\n\n1. **stdio** (cục bộ, khuyến nghị cho desktop)\n2. **HTTP/SSE** (từ xa, multi-tenant)\n3. **WebSocket** (di động, khối lượng lớn)\n\n## Làm thế nào để cấu hình Claude Desktop?\n\nChỉnh sửa `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nXem [Thiết lập Claude Desktop](/docs/mcp/claude-desktop).\n\n## Tại sao công cụ không xuất hiện trong Claude Desktop?\n\n1. **Khởi động lại Claude Desktop hoàn toàn** (Cmd+Q trên macOS)\n2. **Kiểm tra tệp cấu hình là JSON hợp lệ**\n3. **Xác minh Node.js 18+** đã cài đặt\n4. **Kiểm tra nhật ký MCP**: `~/Library/Logs/Claude/mcp.log`\n\nXem [Khắc phục sự cố MCP](/docs/mcp/troubleshooting).\n\n## Làm thế nào để sử dụng một mind khác?\n\nThay đổi `SYNAPSE_MIND_KEY` trong cấu hình MCP và khởi động lại client.\n\nCho nhiều mind, chạy nhiều thể hiện MCP server với các Mind Key khác nhau.\n\n## Tôi có thể giới hạn công cụ nào được lộ không?\n\nCó, sử dụng **Tool Profile**:\n\n- `minimal`: 8 công cụ tổng hợp (~500 token)\n- `standard`: 25 công cụ (~2.500 token)\n- `full`: 119 công cụ (~8.250 token, mặc định)\n\nĐặt qua biến môi trường `MCP_PROFILE` hoặc header `Mcp-Tool-Profile`.\n\n## Làm thế nào để gỡ lỗi vấn đề MCP?\n\n1. **Chạy MCP server thủ công**: `npx -y synapse-mcp-api@latest`\n2. **Kiểm tra nhật ký client** (khác nhau tùy client)\n3. **Xác minh Mind Key hoạt động**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Kiểm tra sức khỏe Synapse**: `curl https://synapse.schaefer.zone/health`\n\nXem [Khắc phục sự cố MCP](/docs/mcp/troubleshooting).\n\n## MCP server có miễn phí không?\n\nCó. Gói npm `synapse-mcp-api` là mã nguồn mở. MCP server được lưu trữ tại\n`synapse-mcp.schaefer.zone` miễn phí cho sử dụng công khai.\n\n## Tôi có thể tự lưu trữ MCP server không?\n\nCó:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## MCP khác với lệnh gọi API trực tiếp như thế nào?\n\n| Khía cạnh | API trực tiếp | MCP |\n|--------|-----------|-----|\n| LLM cần biết | URL, header, xác thực | Chỉ tên công cụ |\n| Xử lý xác thực | Thủ công | Tự động (biến môi trường) |\n| Khám phá công cụ | Đọc /endpoints | Tự động qua giao thức MCP |\n| Xử lý lỗi | Thủ công | Chuẩn hóa |\n| Tốt nhất cho | Tích hợp tùy chỉnh | LLM agent |\n\n## Tôi có thể xây dựng client MCP riêng không?\n\nCó. Sử dụng SDK MCP chính thức:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nXem [Client MCP tùy chỉnh](/docs/mcp/custom-client).\n\n## Làm thế nào để báo cáo bug MCP?\n\nMở issue: \n\nBao gồm:\n\n- Phiên bản MCP server\n- Tên và phiên bản client\n- Hệ điều hành\n- Nhật ký liên quan\n- Các bước tái hiện\n\n## Bước tiếp theo\n\n- [MCP là gì?](/docs/mcp/what-is-mcp)\n- [Thiết lập Claude Desktop](/docs/mcp/claude-desktop)\n- [Khắc phục sự cố MCP](/docs/mcp/troubleshooting)\n","content_html":"

FAQ MCP

\n

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

\n

MCP là gì?

\n

MCP (Model Context Protocol) là tiêu chuẩn mở của Anthropic cho tích hợp\nLLM-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\nMCP server, và LLM gọi chúng như các hàm native.

\n

Xem MCP là gì?.

\n

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

\n

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

\n

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

\n

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

\n\n

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

\n

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

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

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

\n

Chỉnh sửa claude_desktop_config.json:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Xem Thiết lập Claude Desktop.

\n

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

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

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

\n

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

\n

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

\n

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

\n

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

\n

Có, sử dụng Tool Profile:

\n\n

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

\n

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

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

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

\n

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

\n

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

\n

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

\n

Có:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Khía cạnhAPI trực tiếpMCP
LLM cần biếtURL, header, xác thựcChỉ tên công cụ
Xử lý xác thựcThủ côngTự động (biến môi trường)
Khám phá công cụĐọc /endpointsTự động qua giao thức MCP
Xử lý lỗiThủ côngChuẩn hóa
Tốt nhất choTích hợp tùy chỉnhLLM agent
\n

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

\n

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

\n\n

Xem Client MCP tùy chỉnh.

\n

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

\n

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

\n

Bao gồm:

\n\n

Bước tiếp theo

\n\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}