设置你的编程代理
连接成功后，代理即可访问你的工作区。发送消息、拨打电话或配置其他产品，还需要完成该产品的账户、发送方、号码或设备设置。在执行第一次操作之前，请按照相应的产品指南完成设置。
将此提示词复制到你的代理中
代码示例
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-aiCodex
代码示例
codex plugin marketplace add messagebird/bird-ai
codex plugin add bird@bird-aiCursor
首页的 Cursor 按钮会打开 Cursor，并预先填入设置提示词（通过提示词深层链接）；请检查后发送。提示词会从 github.com/messagebird/bird-ai 获取 Bird 的技能，并将技能文件夹复制到 .agents/skills/，从而完成安装。该目录是 Cursor 加载 Agent Skills 的目录之一。如需手动操作，请安装插件：在 Settings > Plugins 中添加 messagebird/bird-ai 插件市场，或使用 cursor.directory。两种方式都会为 Cursor 提供相同的两个技能。
任何支持 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 即可加载。
其他代理（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 服务器：托管端点与工具接口。