ZaBotAI

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ỷ.

Thông tin kết nối
Địa chỉ MCP:https://mcp.zabotai.com/mcp

Xá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

  1. 1
    Mở 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".
  2. 2
    Sao chép key zbt_... ngay lúc tạo. Key chỉ hiện một lần.
  3. 3
    Muố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

  1. 1
    Mở 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_..."
  2. 2
    Mở 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

  1. 1
    Mở Settings → Connectors → Add custom connector. Tên: ZaBot. URL: https://mcp.zabotai.com/mcp. Nếu màn hình có ô header, điền Authorization: Bearer zbt_....
  2. 2
    Nế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

  1. 1
    Tạo hoặc mở tệp .cursor/mcp.json trong dự án (hoặc ~/.cursor/mcp.json cho mọi dự án). Dán:
    {
      "mcpServers": {
        "zabot": {
          "url": "https://mcp.zabotai.com/mcp",
          "headers": { "Authorization": "Bearer zbt_..." }
        }
      }
    }
  2. 2
    Mở Settings → MCP trong Cursor và bật zabot. Các tool của ZaBot hiện trong danh sách.

Bước 5. n8n

  1. 1
    Thêm node MCP Client Tool vào AI Agent.
  2. 2
    Transport: HTTP Streamable. Endpoint URL: https://mcp.zabotai.com/mcp.
  3. 3
    Authentication: 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_accountsTài khoản đã nối của workspace.
upload_mediaTải ảnh hoặc video vào kho ZaBot.
create_postTạ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_postXem 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_nowSửa, huỷ, xoá, đăng ngay.
get_post_rulesLuật của từng nền tảng để agent tự kiểm tra trước khi đăng.
Bảo mật

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.