{"title":"MCP là gì?","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol cho phép LLM gọi công cụ bên ngoài. Synapse lộ 79 công cụ qua MCP server chính thức.","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":652,"read_minutes":3,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# MCP là gì?\n\n**Model Context Protocol (MCP)** là tiêu chuẩn mở của Anthropic (2024) cho phép\nLLM gọi công cụ bên ngoài theo cách có cấu trúc. Thay vì dán tài liệu API vào\nprompt, bạn đăng ký công cụ với MCP server, và LLM gọi chúng khi cần — giống\nfunction calling, nhưng được chuẩn hóa và không phụ thuộc client.\n\n## Synapse MCP Server\n\nSynapse đi kèm với MCP server chính thức (`synapse-mcp-api` trên npm) lộ **79\ncông cụ** bao phủ tất cả tính năng Synapse:\n\n| Danh mục | Công cụ | Số lượng |\n|----------|-------|-------|\n| Memory | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tasks | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utility | time, calc, random | 3 |\n| Visualization | graph, tags, compact | 3 |\n| Sharing | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Browser | new, navigate, click, type, screenshot, close | 6 |\n| **Tổng** | | **79+** |\n\n## Cách hoạt động\n\n```\n┌──────────────────┐ MCP protocol ┌──────────────────┐ HTTP ┌──────────┐\n│ LLM Client │ ◀─────────────────▶│ Synapse MCP │ ─────────▶ │ Synapse │\n│ (Claude/Cursor) │ (stdio/SSE/WS) │ Server │ │ API │\n└──────────────────┘ └──────────────────┘ └──────────┘\n```\n\n1. Bạn cấu hình LLM client của mình (Claude Desktop, Cursor, v.v.) để sử dụng Synapse MCP server\n2. Client khởi động MCP server (qua `npx -y synapse-mcp-api@latest`)\n3. MCP server kết nối đến Synapse API sử dụng Mind Key của bạn\n4. LLM thấy tất cả 79 công cụ dưới dạng hàm native nó có thể gọi\n5. Khi LLM cần nhớ điều gì, nó gọi `memory_store` — MCP server dịch điều này thành `POST /memory` trên Synapse\n\n## Transport\n\nSynapse MCP server hỗ trợ ba transport:\n\n### stdio (cục bộ, khuyến nghị cho desktop)\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_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### HTTP/SSE (từ xa, multi-tenant)\n\nKết nối MCP client của bạn đến:\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket (di động, khối lượng lớn)\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## Tool Profile (v1.4.0)\n\nĐể giảm chi phí token cho LLM nhỏ hơn, MCP server hỗ trợ ba tool profile:\n\n| Profile | Công cụ | Token | Tốt nhất cho |\n|---------|-------|--------|----------|\n| `minimal` | 8 (composite dispatch) | ~500 | LLM tự lưu trữ với ngữ cảnh ≤8k |\n| `standard` | 25 (named) | ~2,500 | LLM kích thước trung bình (Claude Haiku, GPT-3.5) |\n| `full` | 119 (all) | ~8,250 | LLM lớn (Claude Sonnet/Opus, GPT-4) — mặc định |\n\nKiểm soát qua:\n\n- Biến môi trường: `MCP_PROFILE=minimal|standard|full`\n- Header: `Mcp-Tool-Profile: minimal|standard|full`\n\n## Client được hỗ trợ\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — ứng dụng desktop của Anthropic\n- [Claude Code](/docs/mcp/claude-code) — agent lập trình terminal\n- [Cursor](/docs/mcp/cursor) — IDE dựa trên AI\n- [Continue.dev](/docs/mcp/continue) — trợ lý lập trình AI mã nguồn mở\n- [Cline](/docs/mcp/claude-code) — tiện ích mở rộng VS Code\n- Bất kỳ client tương thích MCP nào\n\n## Tại sao sử dụng MCP thay vì API trực tiếp?\n\n| Cách tiếp cận | Ưu điểm | Nhược điểm |\n|----------|------|------|\n| API trực tiếp | Đơn giản, không có lớp thêm | LLM cần biết URL, header, xác thực |\n| MCP | LLM thấy công cụ native, không cần ghi nhớ URL | Tiến trình MCP server thêm |\n\nCho hầu hết trường hợp sử dụng LLM agent, MCP là lựa chọn tốt hơn — LLM không\ncần ghi nhớ đường dẫn API hoặc mẫu xác thực.\n\n## Bước tiếp theo\n\n- [Thiết lập Claude Desktop](/docs/mcp/claude-desktop) — cấu hình 2 phút\n- [Thiết lập Claude Code](/docs/mcp/claude-code) — tích hợp terminal\n- [Client MCP tùy chỉnh](/docs/mcp/custom-client) — xây dựng của riêng bạn\n","content_html":"

MCP là gì?

\n

Model Context Protocol (MCP) là tiêu chuẩn mở của Anthropic (2024) cho phép\nLLM gọi công cụ bên ngoài theo cách có cấu trúc. Thay vì dán tài liệu API vào\nprompt, bạn đăng ký công cụ với MCP server, và LLM gọi chúng khi cần — giống\nfunction calling, nhưng được chuẩn hóa và không phụ thuộc client.

\n

Synapse MCP Server

\n

Synapse đi kèm với MCP server chính thức (synapse-mcp-api trên npm) lộ 79\ncông cụ bao phủ tất cả tính năng Synapse:

\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\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\n\n\n\n\n\n\n\n\n\n\n
Danh mụcCông cụSố lượng
Memoryrecall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export22
Chatpoll, reply, status, history, unread, send, upload7
Schedulercron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete8
Taskstask_list, task_get, task_create, task_update4
Scriptsscript_list, script_get, script_info, script_store, script_delete5
Computerscomputer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete9
Pushvapid_public_key, subscribe, unsubscribe, test4
User/Mindregister, login, minds_list, mind_create, mind_delete5
Utilitytime, calc, random3
Visualizationgraph, tags, compact3
Sharingshare, list, revoke3
Webhooksregister, list, get, update, delete5
Browsernew, navigate, click, type, screenshot, close6
Tổng79+
\n

Cách hoạt động

\n
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘
    \n
  1. Bạn cấu hình LLM client của mình (Claude Desktop, Cursor, v.v.) để sử dụng Synapse MCP server
    2. \n
  2. Client khởi động MCP server (qua npx -y synapse-mcp-api@latest)
    3. \n
  3. MCP server kết nối đến Synapse API sử dụng Mind Key của bạn
    4. \n
  4. LLM thấy tất cả 79 công cụ dưới dạng hàm native nó có thể gọi
    5. \n
  5. Khi LLM cần nhớ điều gì, nó gọi memory_store — MCP server dịch điều này thành POST /memory trên Synapse
    6. \n
\n

Transport

\n

Synapse MCP server hỗ trợ ba transport:

\n

stdio (cục bộ, khuyến nghị cho desktop)

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

HTTP/SSE (từ xa, multi-tenant)

\n

Kết nối MCP client của bạn đến:

\n
URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY

WebSocket (di động, khối lượng lớn)

\n
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

Tool Profile (v1.4.0)

\n

Để giảm chi phí token cho LLM nhỏ hơn, MCP server hỗ trợ ba tool profile:

\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
ProfileCông cụTokenTốt nhất cho
minimal8 (composite dispatch)~500LLM tự lưu trữ với ngữ cảnh ≤8k
standard25 (named)~2,500LLM kích thước trung bình (Claude Haiku, GPT-3.5)
full119 (all)~8,250LLM lớn (Claude Sonnet/Opus, GPT-4) — mặc định
\n

Kiểm soát qua:

\n\n

Client được hỗ trợ

\n\n

Tại sao sử dụng MCP thay vì API trực tiếp?

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Cách tiếp cậnƯu điểmNhược điểm
API trực tiếpĐơn giản, không có lớp thêmLLM cần biết URL, header, xác thực
MCPLLM thấy công cụ native, không cần ghi nhớ URLTiến trình MCP server thêm
\n

Cho hầu hết trường hợp sử dụng LLM agent, MCP là lựa chọn tốt hơn — LLM không\ncần ghi nhớ đường dẫn API hoặc mẫu xác thực.

\n

Bước tiếp theo

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