设置你的编程代理

将编程代理连接到 Bird，确认它可以使用的工作区，并为你正在开发的产品完成第一个任务。如果已有 MCP 连接或已登录的 CLI，请直接使用。设置提示词会引导代理做出选择。

连接成功后，代理即可访问你的工作区。发送消息、拨打电话或配置其他产品，还需要完成该产品的账户、发送方、号码或设备设置。在执行第一次操作之前，请按照相应的产品指南完成设置。

将此提示词复制到你的代理中

代码示例

Help me connect my coding agent to Bird and complete a first task.
1. Inspect the available Bird MCP connection or CLI installation and its sign-in state. Use whichever is already authenticated, and confirm its account and workspace; either is sufficient.
2. If neither is authenticated, follow the current per-client setup instructions at https://bird.com/docs/ai/set-up-your-agent.md. Read the Markdown guide. Complete the browser sign-in and confirm the account and workspace you will use.
3. Read the Bird product guide for my task. Before proposing changes, make a read-only inventory of my integration's call sites, identifiers and configured URLs. Identify the required permissions and account, sender, number or device setup.
4. Prepare a first example for the product and the recipient or destination I choose. Use published operations from the available CLI or MCP surface. Before any paid send or submission, show me the exact prepared action and applicable charges, and get my explicit approval. If the surface does not quote a price, ask the account owner to confirm the charges before proceeding; do not estimate them or submit the operation while they remain unknown.
5. Follow the operation through to its actual result. Explain remaining setup, rejected work or an uncertain outcome, and help me choose the next step.

部分营销页面提供适用于 Claude Code、Codex 和 Cursor 的设置提示词，并将当前页面作为上下文。各客户端的操作步骤说明了技能安装方式的差异。

或按客户端手动设置

每个客户端的起始步骤都相同，只有技能安装步骤不同。

代码示例

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

Claude Code

代码示例

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

Codex

代码示例

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

主页上的 Cursor 按钮会打开 Cursor 并预填设置提示词（即提示词深链接）；检查后发送即可。该提示词从 github.com/messagebird/bird-ai 获取技能文件夹并复制到 .agents/skills/（Cursor 加载 Agent Skills 的目录之一），以此安装 Bird 的技能。如需手动操作，可改为安装插件：从 Cursor Marketplace 添加 Bird，或在 Cursor 中运行 /add-plugin bird。该条目会同时安装技能和 MCP 服务器。你也可以在 Settings > Plugins 下添加 messagebird/bird-ai 市场，或使用 cursor.directory。

任何支持 Agent Plugins 的客户端

Bird 的插件遵循 Agent Plugins，这是一种可移植的插件格式。实现该规范的客户端会直接从 github.com/messagebird/bird-ai 安装插件，无需修改，并在一步中获取技能和 MCP 服务器，无需分成两步。使用客户端自身的插件安装命令，并指向该仓库。

OpenCode

代码示例

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

该插件一步完成技能和 MCP 服务器的安装；重启 OpenCode 即可加载。

Antigravity

代码示例

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

该脚本会将插件连同技能和 MCP 服务器一起安装到 ~/.gemini/config/plugins/bird 中。然后在侧边栏中打开 Customizations，在 bird 旁边选择 Authenticate。如果 bird 未出现在列表中，请重启 Antigravity。在浏览器中批准 Bird 的授权同意页面，将其显示的授权码粘贴到 Antigravity 中，然后选择 Submit。

其他代理（Zed、Amp、Goose、pi、Cline……）

如果客户端不支持上述任何一种格式，请将技能复制到代理的技能目录中：

代码示例

git clone --depth 1 https://github.com/messagebird/bird-ai /tmp/bird-ai
mkdir -p .agents/skills && cp -r /tmp/bird-ai/plugins/bird/skills/. .agents/skills/

大多数代理读取 .agents/skills/；Cline 使用 .clinerules/skills/。这是可选的：bird CLI 不依赖它也能工作。

身份验证

bird auth login 在浏览器中运行限定到你的工作区的 OAuth 流程，因此你无需在任何配置中保存 API 密钥或密钥文件。bird auth status 会报告工作区、区域和已授予的权限范围。

技能为你的代理提供什么

技能	功能
`bird-cli`	按 CLI 命令组将请求路由到对应的参考文档，涵盖 Bird 运行的所有渠道及各渠道发送前所需的配置
`email-audit`	检测域名的实时 DMARC、SPF、DKIM、BIMI 和 MX 记录，并将结果以优先级排序的修复清单返回

代理技能介绍了每项技能的内容、插件在各客户端的安装方式，以及技能与 MCP 服务器的关系。

改为连接 MCP 服务器

对于调用工具而非运行 shell 的客户端，请连接 Bird 托管的 MCP 服务器，地址为 https://mcp.bird.com。这包括 Claude Desktop、ChatGPT 和移动客户端。添加 URL 后需进行身份验证；未验证的客户端可以列出 Bird 的工具，但所有调用都会失败。各客户端触发方式不同：Claude Code 使用 /mcp > bird > Authenticate，Claude Desktop 使用 Connect，Cursor 使用 Needs login。参阅各客户端连接步骤。MCP 服务器指南还涵盖本地 stdio 方式。

后续步骤

CLI for agents：bird CLI 的代理契约。
代理技能：每项技能的内容，以及各客户端支持矩阵。
MCP 服务器：托管端点与工具接口。

继续查看此主题的文档、指南和示例。

获取实施简报

相关资源