{"title":"MCP trong Cursor","slug":"cursor","category":"mcp","summary":"Kết nối Synapse với Cursor IDE cho bộ nhớ dự án cố định qua các phiên lập trình.","audience":["human"],"tags":["mcp","cursor","ide","coding"],"difficulty":"intermediate","updated":"2026-06-27","word_count":369,"read_minutes":2,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# MCP trong Cursor\n\nCursor là IDE dựa trên AI dựa trên VS Code. Với Synapse MCP, Cursor có bộ nhớ\ncố định qua các phiên — nó ghi nhớ quyết định dự án, mẫu codebase và phiên gỡ\nlỗi quá khứ của bạn.\n\n## Điều kiện tiên quyết\n\n- Cursor IDE đã cài đặt ()\n- Node.js 18+\n- Synapse Mind Key của bạn\n\n## Thiết lập\n\n### Bước 1: Mở cài đặt Cursor\n\nTrong Cursor:\n\n1. Mở Settings (Cmd+, trên macOS, Ctrl+, trên Windows/Linux)\n2. Tìm \"MCP\" hoặc điều hướng đến `Cursor Settings → MCP Servers`\n\n### Bước 2: Thêm Synapse MCP Server\n\nNhấp \"Add MCP Server\" và cấu hình:\n\n| Trường | Giá trị |\n|-------|-------|\n| Name | `synapse` |\n| Type | `stdio` |\n| Command | `npx -y synapse-mcp-api@latest` |\n| Env | `SYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone` |\n\n### Bước 3: Chỉnh sửa config.json trực tiếp (thay thế)\n\nCursor lưu cấu hình MCP trong `~/.cursor/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_MIND_KEY_HERE\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### Bước 4: Khởi động lại Cursor\n\nKhởi động lại hoàn toàn Cursor (Cmd+Q và mở lại trên macOS).\n\n## Xác minh nó hoạt động\n\nTrong bảng điều khiển chat của Cursor (Cmd+L):\n\n```\nrecall all my memories\n```\n\nCursor sẽ gọi `memory_recall` và phản hồi với bộ nhớ đã lưu của bạn.\n\n## Mẫu phổ biến\n\n### Onboarding dự án\n\nKhi mở dự án mới:\n\n```\nrecalling project context — what do I know about this codebase?\n```\n\nCursor gọi `memory_recall` và tiếp tục công việc nơi bạn đã dừng.\n\n### Quyết định kiến trúc\n\n```\nstore this decision: \"Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27.\"\n```\n\nCursor lưu nó dưới dạng bộ nhớ `project` với ưu tiên `high`.\n\n### Lịch sử gỡ lỗi\n\n```\nwhat bugs have I hit in this codebase?\n```\n\nCursor tìm bộ nhớ `mistake` và nhắc bạn về sửa chữa quá khứ.\n\n### Mẫu code chéo phiên\n\n```\nsearch memories: \"authentication pattern\"\n```\n\nCursor tìm bộ nhớ về triển khai xác thực bạn đã làm trước.\n\n## Khắc phục sự cố\n\n### MCP server không kết nối\n\n1. Xác minh Node.js: `node --version` (≥ 18)\n2. Kiểm tra MCP server: `npx -y synapse-mcp-api@latest` (nên khởi động không lỗi)\n3. Kiểm tra nhật ký MCP của Cursor (View → Output → MCP)\n4. Khởi động lại Cursor hoàn toàn\n\n### Công cụ không xuất hiện\n\n- Kiểm tra `~/.cursor/config.json` là JSON hợp lệ\n- Xác minh biến môi trường `SYNAPSE_MIND_KEY` được đặt\n- Kiểm tra phiên bản Cursor hỗ trợ MCP (≥ 0.42)\n\n### Mind Key không hợp lệ\n\n```bash\n# Test your Mind Key directly\ncurl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n## Bước tiếp theo\n\n- [Thiết lập Claude Desktop](/docs/mcp/claude-desktop)\n- [Thiết lập Continue.dev](/docs/mcp/continue)\n- [Hướng dẫn LLM Agent cố định](/docs/guides/persistent-llm-agent)\n","content_html":"

MCP trong Cursor

\n

Cursor là IDE dựa trên AI dựa trên VS Code. Với Synapse MCP, Cursor có bộ nhớ\ncố định qua các phiên — nó ghi nhớ quyết định dự án, mẫu codebase và phiên gỡ\nlỗi quá khứ của bạn.

\n

Điều kiện tiên quyết

\n\n

Thiết lập

\n

Bước 1: Mở cài đặt Cursor

\n

Trong Cursor:

\n
    \n
  1. Mở Settings (Cmd+, trên macOS, Ctrl+, trên Windows/Linux)
    2. \n
  2. Tìm "MCP" hoặc điều hướng đến Cursor Settings → MCP Servers
    3. \n
\n

Bước 2: Thêm Synapse MCP Server

\n

Nhấp "Add MCP Server" và cấu hình:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TrườngGiá trị
Namesynapse
Typestdio
Commandnpx -y synapse-mcp-api@latest
EnvSYNAPSE_MIND_KEY=mk_YOUR_KEY, SYNAPSE_URL=https://synapse.schaefer.zone
\n

Bước 3: Chỉnh sửa config.json trực tiếp (thay thế)

\n

Cursor lưu cấu hình MCP trong ~/.cursor/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_MIND_KEY_HERE",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Bước 4: Khởi động lại Cursor

\n

Khởi động lại hoàn toàn Cursor (Cmd+Q và mở lại trên macOS).

\n

Xác minh nó hoạt động

\n

Trong bảng điều khiển chat của Cursor (Cmd+L):

\n
recall all my memories

Cursor sẽ gọi memory_recall và phản hồi với bộ nhớ đã lưu của bạn.

\n

Mẫu phổ biến

\n

Onboarding dự án

\n

Khi mở dự án mới:

\n
recalling project context — what do I know about this codebase?

Cursor gọi memory_recall và tiếp tục công việc nơi bạn đã dừng.

\n

Quyết định kiến trúc

\n
store this decision: "Using Fastify instead of Express for this project\nbecause of schema validation. Date: 2026-06-27."

Cursor lưu nó dưới dạng bộ nhớ project với ưu tiên high.

\n

Lịch sử gỡ lỗi

\n
what bugs have I hit in this codebase?

Cursor tìm bộ nhớ mistake và nhắc bạn về sửa chữa quá khứ.

\n

Mẫu code chéo phiên

\n
search memories: "authentication pattern"

Cursor tìm bộ nhớ về triển khai xác thực bạn đã làm trước.

\n

Khắc phục sự cố

\n

MCP server không kết nối

\n
    \n
  1. Xác minh Node.js: node --version (≥ 18)
    2. \n
  2. Kiểm tra MCP server: npx -y synapse-mcp-api@latest (nên khởi động không lỗi)
    3. \n
  3. Kiểm tra nhật ký MCP của Cursor (View → Output → MCP)
    4. \n
  4. Khởi động lại Cursor hoàn toàn
    5. \n
\n

Công cụ không xuất hiện

\n\n

Mind Key không hợp lệ

\n
# Test your Mind Key directly\ncurl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Bước tiếp theo

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