Kết nối ZaBot với Claude Code, Claude Desktop, Cursor, n8n
Khoảng 5 phút. Cần một API key của workspace.
ZaBot có máy chủ MCP (Model Context Protocol). Công cụ AI nối vào máy chủ này sẽ đăng bài lên Facebook, Instagram, Threads, YouTube, TikTok và Zalo OA qua ZaBot. Bài do AI tạo hiện trong mục Đăng bài của CMS như bài bạn soạn tay: xem trước, sửa, đổi giờ, huỷ.
https://mcp.zabotai.com/mcpXác thực: mỗi yêu cầu gửi header Authorization: Bearer + API key của workspace. Không dùng email hay mật khẩu. Kiểm tra máy chủ đang chạy tại https://mcp.zabotai.com/health.
Bước 1. Tạo API key
- 1Mở Cài đặt, kéo xuống thẻ API key, bấm Tạo API key. Đặt tên theo nơi dùng, ví dụ "Claude Code của Thiện".
- 2Sao chép key
zbt_...ngay lúc tạo. Key chỉ hiện một lần. - 3Muốn dừng công cụ nào: bấm Thu hồi ở key đó. Công cụ ngừng ngay. Mất key thì thu hồi và tạo key mới.
Key hoạt động với quyền Đăng bài của người tạo, trong workspace đó, và chỉ gọi được API đăng bài. Mỗi công cụ nên có một key riêng.
Bước 2. Claude Code
- 1Mở terminal, chạy lệnh sau. Thay
zbt_...bằng key của bạn.claude mcp add --transport http zabot https://mcp.zabotai.com/mcp --header "Authorization: Bearer zbt_..."
- 2Mở Claude Code và ra lệnh, ví dụ: "Đăng bài này lên Facebook và Instagram lúc 9h sáng mai". Claude tự gọi ZaBot để tải ảnh, chọn tài khoản và lên lịch.
Bước 3. Claude Desktop
- 1Mở Settings → Connectors → Add custom connector. Tên: ZaBot. URL:
https://mcp.zabotai.com/mcp. Nếu màn hình có ô header, điềnAuthorization: Bearer zbt_.... - 2Nếu Claude Desktop đòi đăng nhập OAuth và không có ô header, dùng cách qua tệp cấu hình. Mở Settings → Developer → Edit Config, dán đoạn sau vào
claude_desktop_config.json, rồi khởi động lại Claude Desktop. Máy cần có Node.js.{ "mcpServers": { "zabot": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.zabotai.com/mcp", "--header", "Authorization: Bearer zbt_..." ] } } }
Bước 4. Cursor
- 1Tạo hoặc mở tệp
.cursor/mcp.jsontrong dự án (hoặc~/.cursor/mcp.jsoncho mọi dự án). Dán:{ "mcpServers": { "zabot": { "url": "https://mcp.zabotai.com/mcp", "headers": { "Authorization": "Bearer zbt_..." } } } } - 2Mở Settings → MCP trong Cursor và bật zabot. Các tool của ZaBot hiện trong danh sách.
Bước 5. n8n
- 1Thêm node MCP Client Tool vào AI Agent.
- 2Transport: HTTP Streamable. Endpoint URL:
https://mcp.zabotai.com/mcp. - 3Authentication: Bearer Auth. Tạo credential mới, Token = API key của bạn.
Công cụ khác (ChatGPT, dịch vụ chỉ nhận URL)
Dùng cùng địa chỉ https://mcp.zabotai.com/mcp. Công cụ phải cho điền header Authorization. Công cụ chỉ nhận URL và không có ô header thì chưa kết nối được với ZaBot.
Ví dụ câu lệnh cho AI
- "Lấy 3 ảnh trong thư mục menu, viết caption khai trương và đăng lên Facebook, Instagram, Threads lúc 9h sáng thứ hai."
- "Liệt kê các bài tuần này bị lỗi và thử đăng lại."
- "Tạo bài Reels từ video này cho Facebook và Instagram, tiêu đề YouTube là ... , chế độ không công khai."
Sau mỗi lệnh, bài hiện trong Đăng bài với trạng thái Chờ đăng. Bạn mở bài để xem trước từng nền tảng, sửa chữ, đổi giờ hoặc huỷ trước khi đến giờ.
| list_social_accounts | Tài khoản đã nối của workspace. |
| upload_media | Tải ảnh hoặc video vào kho ZaBot. |
| create_post | Tạo bài: nội dung, media, giờ đăng, tài khoản và tuỳ chọn từng nền tảng. |
| list_posts, get_post | Xem bài theo khoảng ngày và trạng thái từng tài khoản. |
| update_post, cancel_post, delete_post, publish_now | Sửa, huỷ, xoá, đăng ngay. |
| get_post_rules | Luật của từng nền tảng để agent tự kiểm tra trước khi đăng. |
Không chia sẻ key. Không dán key vào bài đăng, tin nhắn hay kho mã nguồn chung.
Nghi ngờ lộ key: thu hồi ngay trong Cài đặt rồi tạo key mới.
Key chỉ gọi được API đăng bài. Key không đọc tin nhắn khách, không đổi cài đặt bot, không mời thành viên.
Lập trình viên muốn chạy máy chủ MCP trên máy mình: mã nguồn tại ZaBotAI-MCP (hiện là kho riêng). Chạy npm install && npm run build, rồi node dist/index.js với biến môi trường ZABOT_API_KEY.