Trợ lý AI (MCP)

PostClaw có một máy chủ Model Context Protocol từ xa. Kết nối trợ lý AI vào đó, bạn chỉ cần nói “viết ba bài cho tuần sau và lên lịch trên Facebook Page của tôi”. Trợ lý sẽ xem kênh của bạn, viết nháp và đưa bài lên lịch, với tư cách là bạn.

Có trên mọi gói, kể cả Free. Giới hạn của gói áp dụng y như khi bạn dùng trong app.

Bạn cần gì

• Tài khoản PostClaw đã kết nối ít nhất một kênh.
• Một client MCP gửi được header Authorization qua Streamable HTTP: Claude Code, Cursor, VS Code và phần lớn client MCP khác.
• Một token tạo trong Cài đặt → Trợ lý AI.

Claude.ai và ChatGPT trên trình duyệt chưa được hỗ trợ. Chúng cần đăng nhập OAuth, tính năng này đang được lên kế hoạch.

Kết nối trong hai phút

1. Mở Cài đặt → Trợ lý AI và bấm Tạo token.
2. Đặt tên dễ nhận ra (ví dụ “Cursor trên laptop”) và chọn quyền.
3. Sao chép token. Token chỉ hiện một lần. Nếu làm mất, hãy thu hồi rồi tạo token mới.
4. Thêm máy chủ vào client. Trang cài đặt có sẵn các đoạn cấu hình dưới đây, đã điền token của bạn.

Địa chỉ máy chủ: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Sau đó hỏi trợ lý một câu như “Tôi có những kênh nào trong PostClaw?” để kiểm tra kết nối.

Quyền

Mỗi token có quyền riêng. Trợ lý chỉ thấy những tool mà token của nó cho phép.

Không có quyền Đăng, trợ lý chỉ để lại bản nháp để bạn xem và duyệt trong PostClaw. Chỉ bật quyền này cho trợ lý bạn tin tưởng đăng bài thay mình.

Bạn có thể giữ tối đa 10 token đang hoạt động. Thu hồi token có hiệu lực ngay ở yêu cầu tiếp theo của trợ lý.

Các tool

Media phải là URL https:// hoặc file gửi qua upload_media.

create_post và publish_post nhận thêm idempotency_key (không bắt buộc). Nếu trợ lý gửi lại cùng key trong vòng 24 giờ, PostClaw trả lại kết quả lần đầu thay vì tạo hoặc đăng hai lần.

Giới hạn và credit

Trợ lý dùng đúng gói của bạn như trong app:

• Số bài mỗi tháng, credit AI và quota ảnh được tính như nhau dù bạn làm trong PostClaw hay qua trợ lý.
• Tool AI dùng key AI riêng của bạn nếu bạn đã kết nối trong phần Cài đặt.
• Mỗi token gửi được tối đa 60 yêu cầu mỗi phút.
• Mọi lời gọi đều được ghi lại trong tài khoản của bạn.

Xử lý sự cố

Giữ token an toàn

Token hành động với tư cách là bạn. Hãy giữ nó như mật khẩu:

• Đừng commit token vào repository hay dán vào nhóm chat chung.
• Dùng mỗi thiết bị hoặc mỗi công cụ một token, để có thể thu hồi một token mà không ảnh hưởng các token khác.
• Thu hồi các token không còn dùng trong Cài đặt → Trợ lý AI.