AI 入门引导
当你的编码代理可以运行 shell 命令时，使用 bird CLI 和 Bird 的技能。当你的客户端改为调用工具时，使用托管的 MCP 服务器。两种方式都可以搜索文档，没有工具的代理也可以读取已发布的 Markdown 语料库。除非你的客户端要求 MCP，否则从 CLI 开始。
1. 设置你的代理（CLI + 技能）
将设置提示粘贴到你的编码代理中。它会安装 bird CLI，通过 bird auth login 登录，安装 Bird 的技能，并发送一封测试邮件以确认设置完成。Bird 产品页面上的 Claude Code、Codex 和 Cursor 按钮会复制针对各客户端定制的提示。设置你的编码代理详细介绍了同一流程。
2. 连接 MCP 服务器（适用时）
如果你的客户端调用工具而不是运行 shell，将其指向 Bird 的托管 MCP 服务器。你只需要 URL 和浏览器登录：
代码示例
https://mcp.bird.com该端点使用 OAuth，因此在每个客户端中认证一次即可。你的浏览器会打开一个 Bird 授权页面，你在其中登录、选择工作区和权限并批准访问。你不需要 API 密钥，也不需要在客户端配置中填写密钥。按照适用于你客户端的连接步骤操作。MCP 服务器指南还介绍了工具接口、委托的 OAuth 以及本地 bird mcp 选项。
3. 为你的代理提供文档
如果你的代理已有步骤 1 或 2 中的 Bird 工具，它已经可以读取这些文档：docs_search 按查询查找页面，docs_read 以 Markdown 格式返回单个页面。在 shell 中对应的命令是 bird docs search "ip warmup" 和 bird docs read <slug>。优先使用此方式而非加载整个语料库，因为代理只获取当前需要的页面。
对于无法调用工具的代理，整个站点以 Markdown 形式发布：
- /llms.txt：索引文件，每个页面的扁平化、富链接摘要，代理可以从中跟随链接浏览。
- /llms-full.txt：完整语料库，所有文档页面拼接为 Markdown，适用于需要将全部内容放入上下文的代理。
这两个文件在每次站点部署时重新生成。你也可以使用文档页面侧边栏中的 AI 工具：Copy as Markdown 复制该页面，Open llms-full.txt 打开语料库。控制面板的邮件入门引导页面提供相同的 Copy for AI 快捷方式。
格式、大小和检索技巧在 llms.txt 指南中介绍。
4. 试一试
代理设置完成后，给它一个端到端的实际任务：
Find my email with whoami, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.
代理通过 whoami 读取你的地址，从 Bird 的共享入门域名发送邮件，并轮询状态直到消息到达你的收件箱。入门域名无需域名验证即可向工作区中已验证的成员发送邮件。如需不依赖真实收件箱的确定性检查，可改为发送至 delivered@messagebird.dev；参见测试沙盒。
后续步骤
- 自助注册：当代理需要自己的 Bird 账户而非使用你的账户时适用。从终端创建账户、组织和工作区，无需浏览器。
- CLI for agents：bird CLI 的代理契约。JSON 输出、语义退出码、OAuth 登录。
- Agent skills：bird-ai marketplace 插件以及每个客户端获得的功能。
- MCP 服务器：托管端点、完整工具接口、委托的 OAuth 模型以及 local-stdio 选项。
- llms.txt 与 Markdown 文档：机器可读语料库的构建方式和检索方法。
- 发送你的第一封邮件：在不使用代理的情况下完成相同的邮件流程。
- 设置您的编码代理：一段连接代理并通过代理发送测试邮件的视频