开发者

用 MCP 基于 Kaption 构建

Kaption 通过一个 MCP 服务器把 WhatsApp 开放给 AI 应用和智能体。本页列出你需要的所有端点、文档和代码仓库。

MCP 服务器地址

https://mcp.kaptionai.com/mcp

端点

基于 Streamable HTTP 的远程 MCP 服务器。它使用 JSON-RPC 2.0,适用于任何支持 OAuth 的 MCP 客户端。工具在用户自己电脑上的 Kaption 扩展或桌面应用中运行,因此用户必须打开 Kaption。

身份验证

采用 OAuth 2.1,支持 PKCE(S256)和动态客户端注册。只有一个权限范围:kaption:access。用户用手机号码和通过 WhatsApp 收到的验证码登录,然后选择连接保持多久。访问令牌一小时后过期。不带令牌的调用会收到 HTTP 401,并附带指向受保护资源元数据的 WWW-Authenticate 标头。

参考

端点与文档

工具

工具

云端服务器提供以下工具。它们都不会立即发送消息:AI 可以留下草稿,或为一个人安排一条定时消息。用户在 WhatsApp 中锁定的聊天永远不可见。

  • query
  • list_contacts
  • get_contact
  • get_contact_groups
  • list_groups
  • get_group
  • export_contacts
  • download_media
  • get_analytics
  • summarize_conversation
  • manage_chat
  • manage_reminders
  • manage_lists
  • manage_labels
  • manage_notes
  • manage_scheduled_messages
  • call_recordings
须知

限制

  • 只有在用户打开 Kaption 时工具才能工作:装有扩展的 WhatsApp Web,或桌面应用。
  • 访问有频率限制。群发或未经请求的消息违反服务条款。
  • 一条定时消息只能发给一个人,最多 800 个字符。
开发者

安全

请将漏洞私下报告至 security@kaptionai.com,不要提交公开 issue。

常见问题

有 REST API 吗?

Kaption 的公开接口是 MCP 服务器。OpenAPI 文件描述了这个 HTTP 端点,方便读取 OpenAPI 的工具发现它;具体操作是通过 JSON-RPC 调用的 MCP 工具。

不登录能列出工具吗?

不能。每次调用(包括 initialize 和 tools/list)都需要令牌。工具名称已列在本页和服务器卡片中。

支持哪些客户端?

Claude、ChatGPT、Cursor,以及其他支持 OAuth 远程 MCP 服务器的客户端。运行本地服务器的客户端可以改用 npm 软件包。

立即转录一段音频