Skip to main content

MCP trong Claude Code

intermediate 🤖 Thân thiện với LLM 1 phút · 286 từ Cập nhật: 2026-06-27 Tiếng Việt

Sử dụng công cụ Synapse từ agent terminal Claude Code — bộ nhớ cố định cho phiên lập trình.

Đọc bài viết này ở định dạng: 📄 Văn bản thuần ⚡ JSON 🤖 Định dạng LLM
Ngôn ngữ: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

MCP trong Claude Code

Claude Code là agent lập trình dựa trên terminal của Anthropic. Với Synapse MCP, Claude Code có bộ nhớ cố định qua các phiên lập trình — nó ghi nhớ ngữ cảnh dự án của bạn, quyết định quá khứ và mẫu codebase.

Thiết lập

Phương thức 1: Lệnh CLI (khuyến nghị)

# Add Synapse as an MCP server
claude mcp add synapse -- npx -y synapse-mcp-api@latest

# Set your Mind Key as env var (add to ~/.bashrc or ~/.zshrc)
export SYNAPSE_MIND_KEY="mk_YOUR_MIND_KEY_HERE"
export SYNAPSE_URL="https://synapse.schaefer.zone"  # optional, defaults to synapse.schaefer.zone

Phương thức 2: Chỉnh sửa tệp cấu hình

Chỉnh sửa ~/.claude/config.json:

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

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

Khởi động Claude Code:

claude

Trong prompt Claude Code, gõ:

recall all my memories

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

Mẫu phổ biến

Tính cố định ngữ cảnh dự án

Ở đầu phiên lập trình:

recalling my memories — what projects am I working on?

Claude gọi memory_recall, thấy danh sách dự án của bạn và tiếp tục công việc nơi bạn đã dừng.

Quyết định codebase

Khi bạn đưa ra quyết định kiến trúc:

store this: "We chose PostgreSQL over SQLite because of concurrent write
performance. Decision made on 2026-06-27."

Claude gọi memory_store với danh mục project, ưu tiên high.

Tránh lỗi quá khứ

what mistakes have I made with this codebase?

Claude tìm bộ nhớ với danh mục mistake và nhắc bạn về lỗi quá khứ.

Theo dõi tác vụ

create a task: "Refactor auth module to use JWT refresh tokens"

Claude gọi task_create, và tác vụ tồn tại qua các phiên.

Tool Profile

Cho phiên lập trình nơi bạn không cần tất cả 119 công cụ:

# Set profile via env var
export MCP_PROFILE="standard"  # 25 tools, ~2500 tokens

# Or in config.json
"env": {
  "SYNAPSE_MIND_KEY": "mk_...",
  "MCP_PROFILE": "standard"
}

Khắc phục sự cố

MCP server không khởi động

# Test the MCP server manually
npx -y synapse-mcp-api@latest

# Should print:
# [info] synapse-mcp Streamable HTTP server ready
# [info]   MCP:      http://localhost:13100/mcp

Mind Key không được nhận dạng

# Verify env var is set
echo $SYNAPSE_MIND_KEY

# Test directly
curl -H "Authorization: Bearer $SYNAPSE_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

Claude Code không thấy công cụ

  • Khởi động lại Claude Code sau thay đổi cấu hình
  • Kiểm tra claude mcp list để xác minh Synapse đã đăng ký
  • Xem Khắc phục sự cố MCP

Bước tiếp theo

← Quay lại Tích hợp MCP