LOB BrainLOB Brain
Tài liệu/MCP Quickstart

Cài Đặt MCP Nhanh Chóng

Kết nối LOB Brain với AI agent của bạn trong chưa đầy 5 phút. Hướng dẫn này sẽ giúp bạn thiết lập một node Spoke và tích hợp với Claude, Gemini, Cursor hoặc bất kỳ IDE nào hỗ trợ MCP.

1Điều Kiện Tiên Quyết

LOB Brain Executable (file thực thi lob-brain.exe hoặc linux binary)

Một IDE hỗ trợ MCP: Cursor, VS Code + Continue, Windsurf, hoặc Claude Desktop

Thư mục Dự án: Thư mục bạn muốn kích hoạt LOB Brain

2Cài Đặt LOB Brain Spoke

terminal

# Đơn giản chỉ cần thả file thực thi vào trong thư mục dự án bạn muốn

Windows: Copy lob-brain.exe vào thư mục dự án.

Linux/Mac: Copy lob-brain binary vào thư mục dự án.

# (Không cần cài đặt rườm rà, không cần dependency bổ sung. Đây là một engine độc lập)

3Khởi Tạo Không Gian Làm Việc

terminal

# Mở terminal trên chính thư mục dự án của bạn và chạy lệnh khởi tạo

$ ./lob-brain.exe init --mode spoke --attach cursor

▶ Injecting ./.cursorrules ...

▶ Injecting ./mcp.json ...

✓ IDE workspace configured.

# Hoặc gài mã thông minh vào VS Code / Windsurf

$ ./lob-brain.exe init --mode spoke --attach vscode

Lệnh trên sẽ tự động tạo cấu hình lob-brain.toml chứa policy và tiêm (inject) các file cài đặt MCP vào chuẩn để IDE của bạn tìm thấy.

4Kích Hoạt License Key (v2.7.0+)

Bắt đầu từ phiên bản 2.7.0, LOB Brain yêu cầu một License Key để kích hoạt giới hạn bộ nhớ (LOB Lite, LOB Pro, hoặc Enterprise). Mở file lob-brain.toml và dán key của bạn vào:

lob-brain.toml
[license]
key = "LOB-LITE-XXXX-XXXX-XXXX-XXXX"
# Nếu bạn chưa có key, bạn sẽ mặc định được kích hoạt 7 Ngày Dùng Thử miễn phí.

5Cấu Hình Server MCP

IDE của bạn sẽ cần cấu hình này để có thể điều hướng. Lệnh init vừa rồi đã làm hộ luôn điều này rồi. Cách gọi thủ công ra như sau:

mcp.json
{
  "mcpServers": {
    "lob-brain": {
      "command": "./lob-brain.exe",
      "args": ["--mode", "spoke", "--stdio"],
      "env": {
        "LOB_PROJECT": "my-project"
      }
    }
  }
}

6Kiểm Tra Kết Nối

Khi MCP load xong, AI agent sẽ tự động phát hiện 12 công cụ MCP. Hãy thử ngay lập tức bằng việc kêu AI đó cập nhật status hệ thống:

agent conversation

Bạn gõ chat: "Hãy kiểm tra trạng thái LOB Brain giúp tôi."

Agent phản hồi: Gọi công cụ brain_status()...

→ Total memories: 0

→ Projects: (none)

→ Database: healthy

✓ LOB Brain đã nối mạng xong.

📦Các Công Cụ MCP Hiện Có

brain_store

Memory

brain_query

Memory

brain_recall

Memory

brain_context

Memory

brain_search

RAG

brain_ingest

RAG

brain_sources

RAG

brain_status

System

brain_clusters

Analytics

brain_snapshot

Cache

brain_log_session

Logging

brain_sync

Sync

Xem Hướng dẫn API chi tiết →

Các Bước Tiếp Theo