MCP 服务器

1. 托管模式 (mcp.bird.com)：只需一个 URL 和浏览器登录。无需安装任何东西，不需要 CLI，不需要 API 密钥。这是推荐方式。
2. 本地 stdio 模式 (bird mcp)：工具在你的机器上通过 bird CLI 运行，适用于 shell 代理或自行运行的场景。

• auth_signup、auth_verify_email 和 auth_create_org：这些工具用于创建你的第一个凭据，在你能够向托管服务器进行身份验证之前使用。
• compliance_attachments_upload：该工具读取本地文件路径。在托管服务器上，该路径会指向服务器的文件系统，可能上传错误的文件。

托管模式：连接到 mcp.bird.com

选择端点

1. 添加服务器：将你选择的端点 URL 提供给客户端。
2. 身份验证：通过浏览器登录，让客户端持有一个以你身份操作的令牌。

使用动态工具发现

• search 按名称或描述关键词查找工具。每条匹配结果包含名称、描述、输入模式，以及标注该工具是读取还是修改数据的注解。
• execute 使用指定参数调用一个已选工具。它可以读取数据、发送消息、修改记录或删除记录，具体取决于所选工具。

{
  "name": "search",
  "arguments": { "query": "workspace_get", "limit": 3 }
}

{
  "name": "execute",
  "arguments": { "tool": "workspace_get", "arguments": {} }
}

连接客户端

Claude Code

claude mcp add --transport http bird https://mcp.bird.com

1. 运行 /mcp。
2. 选择 bird 并按 Enter。
3. 选择 Authenticate。浏览器打开 Bird 的授权确认页面，在那里批准。

Cursor

{
  "mcpServers": {
    "bird": {
      "url": "https://mcp.bird.com"
    }
  }
}

OpenCode

opencode plugin github:messagebird/bird-ai --global

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bird": {
      "type": "remote",
      "url": "https://mcp.bird.com/dynamic"
    }
  },
  "permission": {
    "bird_execute": "ask"
  }
}

opencode mcp auth bird

VS Code

{
  "servers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com"
    }
  }
}

Codex

[mcp_servers.bird]
url = "https://mcp.bird.com"

codex mcp login bird

Claude Desktop

ChatGPT

Muse

Set up a custom connector to the Bird MCP server at https://mcp.bird.com following https://bird.com/docs/ai/mcp-server.md so you can work with my Bird workspace.

Factory Droid

droid mcp add bird https://mcp.bird.com --type http

Agent Plugins

其他任何宿主

登录时会发生什么

握手流程

1. 客户端发送未认证的请求，收到 401 响应，其中 WWW-Authenticate 请求头指向 Bird 的 RFC 9728 受保护资源元数据（/.well-known/oauth-protected-resource）。
2. 客户端从中发现授权服务器，然后动态注册自身（RFC 7591）。动态注册免去了预共享客户端 ID 或手动配置的需要。
3. 浏览器打开 Bird 的授权同意页面。
4. 客户端用结果换取访问令牌（PKCE；自动刷新），Bird 工具随即可用。

本地运行：通过 stdio 使用 CLI

Cursor

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

VS Code

{
  "servers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

Claude Code

claude mcp add bird -- bird mcp

本地服务器如何认证

工具覆盖范围

消息发送

• 发送和查看 email：email_send、email_send_batch、email_list 和 email_get，后者返回消息及其汇总投递状态。每个收件人的投递状态和事件日志是单独的工具调用。
• 发送和查看 SMS：sms_send、sms_send_batch、sms_get、sms_list 和 sms_list_events，与 email 结构一致。sms_templates_list 和 sms_templates_get 用于读取模板目录。
• 发送和查看 WhatsApp：whatsapp_send、whatsapp_get、whatsapp_list、whatsapp_list_events 和 whatsapp_media。模板在 whatsapp_templates_* 下提供完整的编辑功能，包括按版本和按语言的内容。
• 查看语音通话分支：voice_legs_get 和 voice_legs_list 读取通话分支，voice_stats_* 提供按国家和响应码分类的统计数据。voice_session_credentials_create 创建工作区凭据，供 SIP 或软电话客户端进行身份验证。
• 验证收件人：verify_verifications_create 发送一次性验证码，verify_verifications_check 验证收件人提交的内容，verify_verifications_next_channel 回退到另一个渠道。
• 创建语音通话（预览版）：voice_calls_create 使用已启用且未归档序列的当前有效发布版本准备外呼请求。需要有人在浏览器中审核并执行请求；仅准备请求不会发起通话。有关权限和重试说明，请参阅创建语音通话。本地 bird mcp 服务器需要使用包含此工具的 CLI 版本。

为渠道做好发送准备

• 设置发送域名：email_domains_create 添加发送域名并返回需要发布的 DNS 记录；email_domains_verify 重新检查记录；另有 email_domains_list 和 email_domains_get。
• 认领和注册 SMS 发送者：sms_senders_create 认领发送者，sms_senders_requirements 报告所在国家对发送者的要求，sms_senders_registrations_create 进行注册。美国 A2P 流量通过 sms_10dlc_* 的品牌、活动和提交工具处理。
• 配置号码：numbers_available_list 搜索，numbers_orders_create 购买，numbers_release 退还。whatsapp_numbers_precheck 在下单前报告 WhatsApp 是否接受该号码。
• 检查账户是否可以发送：trust_* 工具报告购买号码或注册发送者前需要满足的组织级要求。

Email 可送达性

• 编写 email 模板：email_templates_create、email_templates_list、email_templates_get、email_templates_update、email_templates_duplicate 和 email_templates_preview（使用示例值渲染草稿而不实际发送）。版本位于 email_templates_versions_* 下，其中 email_templates_versions_submit 冻结草稿并将其设为发送时使用的版本，email_templates_versions_languages_* 编辑草稿的按语言内容。代理编写的任何内容在提交前都不会到达收件人。
• 管理屏蔽列表：email_suppressions_list、email_suppressions_check（此地址是否可以安全发送？）、email_suppressions_add 和 email_suppressions_remove（标记为破坏性操作，因为无故移除屏蔽会损害发送者信誉）。
• 管理专用 IP 和 IP 池：email_dedicated_ips_create、email_dedicated_ips_list、email_dedicated_ips_get、email_dedicated_ips_assign（将 IP 移入池中）和 email_dedicated_ips_delete；另有 email_ip_pools_create、email_ip_pools_list、email_ip_pools_get、email_ip_pools_update 和 email_ip_pools_delete，用于管理你路由发送的 IP 池。

受众和配置

• 管理联系人和受众：contacts_* 和 contact_properties_* 管理发送对象，audiences_* 管理发送列表，preferences_* 管理同意授权和退订。
• 配置 Realtime：realtime_apps_* 和 realtime_apps_keys_* 创建 Realtime 客户端连接所需的应用和密钥。
• 查询某人：lookup_phone_number 和 lookup_email 报告 Bird 在发送前已知的地址信息。
• 查看配置：webhooks_list、workspace_get 和 whoami（已登录用户的 id、email、name）。

Call whoami to find my email, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.

MCP 还是 CLI？

后续步骤

• AI onboarding：本页的快速入门版本，外加机器可读的文档语料库。
• Agent skills：bird-ai 市场插件，skills 加此 MCP 服务器，一步安装。
• CLI for agents：从支持 shell 的代理驱动 Bird，无需 MCP：JSON 输出、语义退出码、OAuth 登录。
• Authentication：API 密钥、区域以及请求的授权方式。