Bird

Bird AI Marketplace

用于通过编码 Agent 操作 Bird 平台的技能。你的 Agent 通过 bird CLI 操作 Bird；此 marketplace 中的 bird 插件会安装相关技能，帮助 Agent 了解 Bird 的工作流；对于可读取插件 MCP 声明的客户端，它还会连接 Bird 托管的 MCP 服务。

快速开始

所有客户端的起步方式都相同：安装 CLI 并登录。

curl -fsSL https://cli.bird.com/install.sh | sh   # install the bird CLI
bird auth login                                            # sign in (browser, no API key)

在 macOS 或 Linux 上，也可以通过 Homebrew 安装：brew install messagebird/tap/bird。

然后前往下方对应的客户端。最快的方式是粘贴设置提示词，让 Agent 完成其余操作；每个客户端下方也提供了手动设置方式。

还没有 Bird 账户？

bird auth login 用于登录已有账户。没有账户的 Agent 可以直接在终端创建账户——无需浏览器，也无需密码。只需运行三条命令，即可从零开始创建并保存凭据：

# 1. Sign up. Emails a six-digit code to the address; no password is set.
bird auth signup [email protected]

# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.
bird auth verify-email [email protected] --code 123456
# → { "onboarding_ticket": "obt_…", "user_id": "usr_…" }

# 3. Create your first org + workspace. Consumes the ticket, then mints and stores the credential.
#    --region picks where the account and its data live (us1 or eu1); the CLI routes there for you.
bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket obt_…

# Confirm it worked — reports the account, org, and workspace you're now acting as.
bird auth status

验证码会通过邮件发送，因此需要从 CLI 外部获取：请从收件箱中读取验证码，并将其传入第 2 步。注册和验证不受区域限制；只需在 create-org 时选择一次区域，无需设置主机或环境变量。每一步都提供自我说明：追加 --help 查看标志，追加 --example 查看可直接编辑的请求正文，或追加 --response-schema 查看返回内容——这些操作都不需要凭据，因此 Agent 可以在运行前规划完整流程。完整指南：自助注册。

任何 Agent Plugins 客户端

该插件提供根目录下的 plugin.json 和 mcp.json，遵循 Agent Plugins 这一可移植插件格式。实现该规范的客户端可直接从此仓库加载：一次安装即可同时获取技能和托管的 MCP 服务。将客户端指向 github.com/messagebird/bird-ai，然后从 plugins/bird 安装 bird。

对于使用自有插件格式或没有插件格式的客户端，请查看下方内容。

Claude Code

将此提示词粘贴到 Claude Code，它会安装 CLI、登录、安装技能并发送测试邮件：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `claude plugin marketplace add messagebird/bird-ai`, then `claude plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

或者手动安装插件：

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

**MCP 服务：**安装插件后，会自动注册 Bird 托管的服务 https://mcp.bird.com，无需进行其他配置。你仍需登录一次，因为该服务受 OAuth 保护：运行 /mcp，选择 bird，按 Enter，然后选择 Authenticate。浏览器会打开 Bird 的授权页面；批准后即可使用工具。在此之前，claude mcp list 会将 bird 报告为 ! Needs authentication，且每次工具调用都会失败。若以无头模式运行（claude -p），则没有 /mcp 面板，因此请先运行 claude mcp login bird 完成身份验证。

Cursor

将此提示词粘贴到 Cursor：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Give yourself Bird's skills (Cursor installs plugins through its UI, so set them up by file instead): fetch the skills from https://github.com/messagebird/bird-ai and write them into `.cursor/rules/` as `.mdc` files.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

若要手动设置技能，请在 Settings → Plugins 中添加 messagebird/bird-ai marketplace，或自行将此仓库中的技能写入 .cursor/rules/，保存为 .mdc 文件。

**MCP 服务：**在 ~/.cursor/mcp.json 中添加一次托管服务：

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

然后登录：在 Cursor 侧边栏中打开 Customize，选择 MCPs，并按照 bird 的登录提示操作。在浏览器中批准 Bird 的授权页面，然后返回 Cursor。完成前，工具调用会失败。

Codex

将此提示词粘贴到 Codex：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `codex plugin marketplace add messagebird/bird-ai`, then `codex plugin add bird@bird-ai` (check `codex plugin --help` if the exact form differs).
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

或者手动安装插件：

codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-ai

**MCP 服务：**插件会自动注册 https://mcp.bird.com。

然后登录，浏览器会打开 Bird 的授权页面：

codex mcp login bird

GitHub Copilot

将此提示词粘贴到 Copilot 中：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: run `copilot plugin marketplace add messagebird/bird-ai`, then `copilot plugin install bird@bird-ai`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

或者手动安装插件：

copilot plugin marketplace add messagebird/bird-ai
copilot plugin install bird@bird-ai

**MCP 服务：**在 .vscode/mcp.json 中添加一次托管服务：

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

VS Code 首次启动时会询问你是否信任该服务，随后会自行启动登录流程：在它打开的浏览器窗口中批准 Bird 的授权页面。如果没有弹出窗口，请通过 MCP: List Servers 命令启动 bird。你可以在 Accounts 菜单 → Manage Trusted MCP Servers 中查看授权，也可以在此处撤销授权。

Factory Droid

将此提示词粘贴到 Droid 中：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's skills so you know the workflows: Droid loads skills from `.factory/skills/`, so clone https://github.com/messagebird/bird-ai and copy every directory in `plugins/bird/skills/` into `.factory/skills/`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

也可以手动设置技能：

git clone https://github.com/messagebird/bird-ai
cp -r bird-ai/plugins/bird/skills/. .factory/skills/

**MCP 服务：**添加一次托管服务：

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

然后在 droid 中运行 /mcp，并通过服务器管理器完成浏览器登录。

OpenCode

将此提示词粘贴到 OpenCode 中：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's OpenCode plugin so you know the workflows: run `opencode plugin github:messagebird/bird-ai --global`, then tell me to restart OpenCode and run `opencode mcp auth bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

或者手动安装插件：

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

该插件会将 Bird 的技能和托管 MCP 服务添加到 OpenCode 配置中。默认情况下，OpenCode 会将所有 MCP 工具添加到模型上下文中，因此插件会连接到 https://mcp.bird.com/dynamic，该地址提供两个工具：search 用于查找适合某项任务的 Bird 工具，execute 用于运行该工具。启用 OpenCode 的实验性代码模式后（设置 OPENCODE_EXPERIMENTAL_CODE_MODE=1 或 OPENCODE_EXPERIMENTAL=1），OpenCode 会通过自身的搜索功能调用 MCP 工具，因此插件会改为连接完整目录 https://mcp.bird.com。

默认情况下，对于可能更改工作区的调用，插件会让 OpenCode 事先询问：在 /dynamic 上调用 bird_execute 之前，以及在代码模式下调用每个 Bird 工具之前。你自己的 opencode.json 配置优先级更高：你设置的 bird_* 规则、适用于所有工具的单个 permission 值，或你配置的 bird 服务都会覆盖插件设置。

Google Antigravity

将此提示词粘贴到 Antigravity 中：

Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.
1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.
2. Sign me in: run `bird auth login` and open the browser link for me.
3. Install Bird's Antigravity plugin so you know the workflows: run `curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash`, then tell me to open Customizations in the sidebar and authenticate `bird`.
4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.
5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".
Then let's discuss next steps, given what Bird can do.

或者手动安装插件：

curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash

此脚本会从此仓库的 main 分支下载插件，并将其安装到 ~/.gemini/config/plugins/bird。Antigravity 2.0、IDE 和 Antigravity CLI 会在每个工作区中加载该插件。若要将其安装到单个项目中，请在项目根目录运行 bash -s -- --project，这会写入 .agents/plugins/bird。再次运行相同命令即可更新。从此仓库的克隆版本运行 bash antigravity.sh，并使用相同选项。

**MCP 服务：**该插件会将 Bird 的托管服务注册为 https://mcp.bird.com。由于该服务受 OAuth 保护，你仍需登录一次：在侧边栏中打开 Customizations（在 IDE 中，按 macOS 上的 Cmd+, 或其他系统上的 Ctrl+, 打开 Agent settings），然后选择 bird 旁边的 Authenticate。如果未列出 bird，请重启 Antigravity。在浏览器中批准 Bird 的授权页面，复制显示的授权码，粘贴到 Antigravity 中，然后选择 Submit。完成之前，每次工具调用都会失败。

由于 Antigravity 的插件清单只接受名称和描述，因此软件包的 VERSION 文件会记录 Bird AI 的版本。以下是本地安装说明；若要加入 Google 精选市场，还需经过单独审核。

bird 插件包含的内容

• bird-cli：在终端中操作 Bird API。每个 CLI 命令组都有一篇参考文档，涵盖在 Bird 支持的所有渠道上发送和查看消息、各渠道发送消息前所需的设置、一次性密码验证、收件人查找、联系人和受众、消息偏好设置、Realtime 配置、Webhook、API 密钥、支持工单和文档搜索。
• email-audit：评估域名当前的 DMARC、SPF、DKIM、BIMI 和 MX 记录，并将检查结果整理成按优先级排列的修复清单。仅使用 DNS，无需登录。
• Bird MCP 服务：托管服务 https://mcp.bird.com，让你的 Agent 无需 API 密钥，通过浏览器登录即可直接调用 Bird。已为你注册到 Claude Code、Codex、OpenCode、Antigravity 和任何 Agent Plugins 宿主；其他环境只需进行一次性配置（见上文）。每个客户端都需要按照对应章节中的说明进行一次性浏览器登录：该服务受 OAuth 保护，如果客户端只有 URL 而没有授权，就会列出工具，但每次调用都会失败。

许可证

MIT。