Máy chủ MCP Ecbot

Máy chủ MCP Ecbot cho phép trợ lý AI như Claude Code, Codex hoặc Cursor làm việc trong workspace của bạn. Kết nối bằng một API key, rồi nhờ bằng lời thường: "liệt kê các cuộc trò chuyện cần mình xử lý", "thêm chính sách đổi trả vào cơ sở kiến thức" hay "gắn thẻ VIP cho khách này". Trợ lý làm được những gì người tạo key làm được.

Tạo API keyCopy Anchor Link

Chủ workspace và thành viên có vai trò Admin có sẵn tạo được API key, còn vai trò tự tạo thì không. Mở menu workspace ở đầu thanh bên, chọn Cài đặt (thành viên chọn tên workspace), rồi mở API key:

1

2

1. 1API key trong thanh bên của Cài đặt liệt kê mọi key của workspace.
2. 2Tạo mới tạo một key mới.

Chọn Tạo mới, đặt tên cho key, ví dụ "Claude Code", rồi chọn Tạo mới lần nữa. Key mới chỉ hiện một lần:

1

2

1. 1Secret chỉ hiện đúng một lần này. Nếu làm mất, hãy đổi secret hoặc tạo key mới.
2. 2Sao chép toàn bộ giá trị ở mục x-api-key. Đây là key mà trợ lý gửi đi.

Nếu key bị lộ, mở menu của key (...) và chọn Đổi secret: secret cũ ngừng hoạt động ngay. Xóa sẽ thu hồi key vĩnh viễn.

Kết nối trợ lýCopy Anchor Link

Địa chỉ máy chủ là https://mcp.ecbot.dev/mcp. Trợ lý gửi key kèm mọi yêu cầu, qua header x-api-key hoặc dưới dạng bearer token. Thay YOUR_KEY bên dưới bằng giá trị bạn vừa sao chép.

Claude CodeCopy Anchor Link

claude mcp add --transport http --scope user ecbot https://mcp.ecbot.dev/mcp \
  --header "x-api-key: YOUR_KEY"

CodexCopy Anchor Link

export ECBOT_API_KEY="YOUR_KEY"
codex mcp add ecbot --url https://mcp.ecbot.dev/mcp \
  --bearer-token-env-var ECBOT_API_KEY

Cursor và các trợ lý khácCopy Anchor Link

Các trợ lý cấu hình bằng tệp JSON, như tệp mcp.json của Cursor, nhận địa chỉ và một header:

{
  "mcpServers": {
    "ecbot": {
      "url": "https://mcp.ecbot.dev/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

Đừng để tệp chứa key trong thư mục dùng chung hay kho mã nguồn.

Trợ lý làm được gìCopy Anchor Link

Tải tệp lên, cài ứng dụng từ kho công cụ và xóa vĩnh viễn dữ liệu của khách chỉ làm được trong ứng dụng.

Tạo kỹ năng cùng trợ lýCopy Anchor Link

Trợ lý có thể viết một kỹ năng theo các bước, có rẽ nhánh, công cụ của bạn và các thao tác có sẵn: chuyển cho nhân viên, báo cho đội ngũ, gắn hoặc gỡ tag, hẹn nhắn lại và lưu thông tin khách. Hãy mô tả quy trình bằng lời thường, ví dụ:

Tạo kỹ năng "Tình trạng đơn hàng" cho khi khách hỏi đơn đang ở đâu. Hỏi mã đơn và gọi công cụ Order lookup. Nếu đơn trễ, xin lỗi và chuyển cho nhân viên. Nếu không, báo ngày giao. Gắn kỹ năng cho agent của cửa hàng.

Trợ lý có thể tra công cụ và tag của bạn trước, để các bước trỏ đúng vào công cụ và tag có thật. Sau đó hãy mở kỹ năng trong ứng dụng để kiểm tra lại. Xem thêm câu lệnh trong sổ tay công thức.

Thêm kỹ năng Ecbot cho trợ lýCopy Anchor Link

Ecbot có sẵn các kỹ năng giúp trợ lý của bạn biết cách làm việc trong workspace. Cài chúng cùng với server, rồi chọn những kỹ năng bạn cần:

npx skills add blackmouse572/ecbot

• ecbot: các quy tắc an toàn, như hỏi bạn trước khi gửi tin nhắn đến khách, và mỗi loại cài đặt nên đặt ở đâu.
• ecbot-agent-builder: thiết lập hoặc dọn lại một agent. Giữ Hướng dẫn bổ sung chỉ gồm giọng điệu và vài quy tắc, chuyển thông tin sang kiến thức, và biến mỗi quy trình thành một kỹ năng.
• ecbot-skill-builder: biến một yêu cầu thành kỹ năng viết theo các bước, như trong phần hướng dẫn.

Quyền và nhật ký hoạt độngCopy Anchor Link

• Key hoạt động với tư cách người tạo. Key luôn có đúng quyền hiện tại của người tạo: nếu họ mất một quyền hoặc rời workspace, key cũng mất theo.
• Trợ lý chỉ thấy những công cụ key được dùng, nên không thử những thao tác sẽ bị từ chối.
• Mọi thay đổi đều được ghi lại. Thay đổi và tin trả lời hiện trong Nhật ký hoạt động dưới tên người tạo key, như khi họ làm trong ứng dụng. Mở một cuộc trò chuyện hay một khách hàng cũng được ghi là lượt xem, giống như vậy.
• Nội dung của khách là dữ liệu, không phải mệnh lệnh. Tin nhắn của khách và nội dung tài liệu có thể chứa bất cứ điều gì, nên máy chủ dặn trợ lý không bao giờ làm theo chỉ dẫn nằm trong đó.