SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Đây là gì

Máy chủ MCP hoạt động tại https://get-api.simplyboost.io/api/v1/mcp. Máy chủ sử dụng giao thức truyền tải Streamable HTTP và dùng cùng mã thông báo API như REST API (Authorization: Bearer sb_live_…), cùng các gói dịch vụ (Growth, Pro và Enterprise), cùng quyền và cùng giới hạn. Mỗi công cụ thực hiện chức năng tương ứng với endpoint REST và cần cùng phạm vi quyền; nếu trợ lý thấy một công cụ mà nó không được phép dùng, trợ lý sẽ từ chối rõ ràng thay vì báo lỗi.

Máy chủ không lưu trạng thái: mỗi lần gọi là một yêu cầu và một câu trả lời, không cần duy trì phiên, vì vậy bạn có thể kết nối từ bất kỳ máy nào. Máy chủ không bao giờ tự khởi chạy luồng dữ liệu.

Kết nối ứng dụng khách

Có hai cách kết nối. Đăng nhập (OAuth): thêm địa chỉ máy chủ, rồi khi ứng dụng khách yêu cầu, hãy phê duyệt trong một thẻ SimplyBoost với tư cách chủ sở hữu nhóm, chọn nhóm, quyền và chatbot. Đây là cách các trình kết nối claude.ai và ChatGPT, Cursor, Codex và Claude Code kết nối mà không cần dán gì. Mã thông báo: với ứng dụng khách bạn tự cấu hình hoặc tập lệnh của riêng mình, hãy tạo mã thông báo trong Settings → API chỉ với những quyền trợ lý cần, rồi gửi mã đó dưới dạng header.

Claude Code (đăng nhập khi được yêu cầu)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code và các ứng dụng khách khác có mcp.json (đăng nhập khi được yêu cầu)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Tương tự, nhưng dùng mã thông báo thay vì đăng nhập

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Kết nối bằng cách đăng nhập có hiệu lực trong 90 ngày, chỉ nhận những quyền mà chủ sở hữu đã đánh dấu (quyền xóa bị tắt trừ khi được đánh dấu), và được liệt kê trong Settings → API → Connected apps, nơi chủ sở hữu có thể ngắt kết nối bất cứ lúc nào. Chỉ chủ sở hữu nhóm mới có thể phê duyệt kết nối, giống như quy định khi tạo mã thông báo. Tên ứng dụng trên màn hình phê duyệt là tên do ứng dụng tự khai báo; SimplyBoost không xác minh tên này.

Mã thông báo trong cấu hình ứng dụng khách là mật khẩu truy cập tài khoản của bạn. Hãy giữ mã trên máy tính của riêng bạn, đặt ngày hết hạn và thay mã nếu tệp cấu hình được chia sẻ. Đăng nhập giúp tránh vấn đề này: không có thông tin bí mật nào được ghi vào tệp.

Dành cho nhà phát triển ứng dụng khách: máy chủ tuân theo đặc tả ủy quyền MCP. Yêu cầu không có thông tin xác thực sẽ nhận phản hồi 401 cùng header WWW-Authenticate chỉ đến metadata của tài nguyên được bảo vệ (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), trong đó nêu máy chủ ủy quyền (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Ứng dụng khách tự đăng ký (Dynamic Client Registration), sử dụng luồng mã ủy quyền với PKCE (chỉ S256), có thể chỉ định tài nguyên và nhận mã thông báo làm mới luân phiên. Mã thông báo truy cập có hiệu lực trong một giờ và chỉ dùng được trên endpoint MCP; các endpoint REST yêu cầu mã thông báo API.

Các công cụ

Đối số và kết quả dùng cùng tên như REST API (chatbotId, threadId, các trường camelCase), vì vậy các trang endpoint mô tả cả hai. Hãy bắt đầu với list_chatbots để tìm id của chatbot.

Công cụ	Cần có	Chức năng
get_account	không cần	Tài khoản, gói dịch vụ và các quyền của chính mã thông báo.
get_usage	account:read	Số tin nhắn đã dùng trong kỳ thanh toán này.
list_chatbots, get_chatbot	chatbots:read	Các chatbot mà mã thông báo được phép sử dụng.
send_message	conversations:write	Hỏi chatbot như một khách truy cập; số tin nhắn sẽ được tính vào gói dịch vụ. Truyền threadId để tiếp tục.
list_conversations, get_conversation, list_messages	conversations:read	Các cuộc hội thoại trên mọi kênh và tin nhắn của chúng.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Xử lý cuộc hội thoại như một người: nhận xử lý, trả lời, bàn giao lại, giải quyết hoặc mở lại.
list_leads, get_lead	leads:read	Các khách hàng tiềm năng mà chatbot đã thu thập.
update_lead	leads:write	Thay đổi thông tin của khách hàng tiềm năng hoặc đánh dấu là đã chuyển đổi.
delete_lead	leads:delete	Xóa khách hàng tiềm năng.
list_knowledge_sources, get_knowledge_source	knowledge:read	Nội dung chatbot đã biết, cùng trạng thái và văn bản của từng nguồn.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Dạy chatbot bằng văn bản hoặc trang web, chỉnh sửa nguồn, đọc lại trang web.
delete_knowledge_source	knowledge:delete	Xóa một nguồn.

Không có công cụ tải tệp lên và webhook; hãy dùng các endpoint REST cho những việc đó. Các công cụ xóa được đánh dấu là có tính phá hủy, và hướng dẫn của máy chủ yêu cầu trợ lý hỏi bạn trước.

Lỗi và giới hạn

Lời gọi công cụ bị từ chối (do thiếu quyền, chatbot mà mã thông báo không được phép xem, đối số không hợp lệ hoặc giới hạn gói dịch vụ) sẽ trả về kết quả công cụ được đánh dấu là lỗi, kèm cùng code và thông báo mà REST API sẽ trả về, để trợ lý có thể cho bạn biết cần thay đổi điều gì. Mã thông báo bị thiếu hoặc không hợp lệ sẽ nhận phản hồi 401; gói dịch vụ không có API hoặc gói đăng ký đã hết hạn sẽ nhận 403; giới hạn tốc độ theo từng mã thông báo sẽ nhận 429, giống hệt REST API.

Thông báo không phải JSON-RPC 2.0 sẽ nhận lỗi JSON-RPC. GET và DELETE trên endpoint sẽ nhận phản hồi 405, vì không có phiên và không có luồng dữ liệu từ máy chủ.