AI 智能体集成 · MCP

面向 AI 智能体的 Chikaboom

Chikaboom 通过 MCP（Model Context Protocol）开放其渲染和排期工具。任何兼容 MCP 的 AI 客户端都可以用 API 密钥完成身份验证，并代表用户调用 Chikaboom 工具。

此集成的功能

将外部 AI 智能体连接到 Chikaboom 后，您的 AI 助手可以：

  • 列出您的品牌并查看可用模板
  • 渲染符合品牌规范的社交帖子（单篇、批量或多页轮播）
  • 将渲染好的帖子排入内容日历，自动发布
  • 读取已排期的帖子，避免重复安排

智能体基于设计师为您制作的同一套品牌模板工作，因此产出始终符合品牌规范。智能体不能绘制图形或更改视觉识别，只能填写设计师开放的文本字段。

快速上手：Claude Desktop

  1. 生成 API 密钥。 登录 Chikaboom，打开“设置”→“API 与 MCP”，点击创建新密钥。复制令牌（bs_live_…）。它只显示一次。
  2. 编辑 Claude Desktop 配置。 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "chikaboom": {
      "url": "https://<your-chikaboom-domain>/api/mcp",
      "headers": {
        "Authorization": "Bearer bs_live_YOUR_TOKEN"
      }
    }
  }
}
  3. 重启 Claude Desktop。 Chikaboom 的工具会出现在 Claude 的工具列表中。
  4. 用自然语言提问。 试试：“为我们最新的产品发布渲染一篇 LinkedIn 帖子，并安排在周五上午 9 点发布。”智能体会调用 Chikaboom 工具并返回可点击的预览 URL。

工具参考

Chikaboom 通过 MCP 提供以下工具：

list_brands

查找已认证用户有权访问的品牌。

输入（无参数）
输出Array of { brand_id, brand_name, role, templates_count }
list_templates

列出品牌中的模板，包括每个模板的字段结构（让智能体知道可以填写哪些键）。

输入{ brand_id: string }
输出Array of { template_id, name, category, width, height, fields[] }
render_post

将单篇帖子渲染为 PNG。返回公开 URL。

输入{ brand_id, template_id, content: Record<string,string>, format_id? }
输出{ url, template_id, template_name, width, height, duration_ms }
render_batch

一次调用渲染多篇帖子。返回 ZIP URL。

输入{ brand_id, template_id, rows: Array<Record<string,string>> }
输出{ zip_url, total, succeeded, failed, failures[] }
render_carousel

将多页轮播渲染为 PDF，用于 LinkedIn 文档帖子。返回 PDF URL 以及用于预览的封面页 PNG。

输入{ brand_id, slides: Array<{template_id, content}>, title? }
输出{ pdf_url, cover_url, slides_count }
schedule_post

在用户的内容日历中创建排期帖子。可选择预先渲染素材，或作为草稿排期。

输入{ brand_id, template_id, content, scheduled_for (ISO 8601), caption?, platforms?, asset_url? }
输出{ post_id, status, scheduled_for, calendar_url }
list_scheduled_posts

读取用户在某个日期范围内的日历。排期前使用，可避免重复发布。

输入{ brand_id, from?, to? }
输出{ posts[], count }
ask_user

客户端工具：向用户展示可点击的选项。当答案只在少数几个选项中时（哪个品牌、哪个模板、什么时间等），智能体会使用它。

输入{ question, options: string[2..6], allow_other? }
输出（用户选择的文本会作为下一条用户消息返回）

协议细节

Chikaboom 在 POST /api/mcp 上基于 JSON-RPC 2.0 实现了 MCP 2024-11-05 版本。

支持的方法：

  • initialize: 握手，返回协议版本和服务器信息
  • tools/list: 列出可用的工具定义
  • tools/call: 带参数调用工具
  • notifications/initialized: 空操作确认（返回 204）

错误遵循标准 JSON-RPC 2.0 错误码。身份验证失败返回 -32000 并附带明确信息；方法不存在返回 -32601。

常见问题

Chikaboom 的 AI 集成使用什么协议？

MCP（Model Context Protocol）。Chikaboom 在 POST /api/mcp 实现了一个 JSON-RPC 2.0 服务器，支持标准 MCP 方法：initialize、tools/list、tools/call。

哪些 AI 客户端可以连接 Chikaboom？

任何兼容 MCP 的客户端。已确认可用：Claude Desktop。Cursor、基于 Anthropic SDK 构建的自定义智能体，以及其他采用该标准的 MCP 客户端也应可用。

AI 智能体如何进行身份验证？

使用 API 密钥。每位用户都可以在“设置”页面生成一个或多个密钥。密钥的权限范围与该用户的品牌访问权限一致。以 Authorization: Bearer <key> 发送。密钥可随时撤销，并会记录最近使用时间。

AI 智能体能否通过 Chikaboom 直接发布到 LinkedIn/Twitter？

间接可以。智能体调用 schedule_post 将帖子放入日历，随后 Chikaboom 的 cron 任务会在排定时间发布到已连接的平台。智能体本身从不直接调用平台 API。

MCP 端点有速率限制吗？

每次渲染大约需要 200-400 毫秒，取决于模板复杂度。目前没有硬性速率限制；滥用会触发密钥自动停用。批量工具可降低大批量操作的开销。

准备好连接了吗？

登录后在“设置”中创建 API 密钥，您的 AI 客户端即可原生获得符合品牌规范的渲染能力。

登录并创建密钥