一个安排发货通知的助手需要访问发送方、收件方和消息内容。连接的工具让它可以提交这些字段，而无需将你的凭据暴露在对话中。
MCP 是将应用程序连接到这些工具的协议。
MCP 服务器提供什么？
服务器为你的 AI 客户端提供工具名称、输入模式和可调用的操作。
在 MCP 工具模型下，客户端发现工具。当代理选择某个工具时，客户端提交结构化参数。
Bird 的工具包括发送邮件、SMS 和 WhatsApp 消息。设置工具管理发送域名、号码和发送方要求。验证工具启动一次验证，也可以检查验证码。另有一个工具用于推进到其他渠道。
客户端中的可用工具列表标识了每个操作及其必需输入。当预期的操作缺失时，检查该列表。
如何连接到托管服务器？
将 https://mcp.bird.com 添加为远程 MCP 服务器。通过浏览器登录。
你不需要安装 CLI 或提供 API 密钥。浏览器登录让客户端持有一个包含你部分权限的令牌。Bird 根据该令牌中的权限检查每个请求。
有些客户端会将服务器显示为需要身份验证，直到你开始登录。仅有 URL 的客户端可以列出工具。未经身份验证时，工具调用可能返回 401。
在测试工具调用之前完成身份验证。连接指南提供了受支持客户端的设置步骤。
代理如何发送和检查消息？
确认收件方已同意接收消息且内容符合你的适用策略。调用渠道的发送工具。读取所得消息的投递事件。
以邮件为例，流程如下：
- 确认工作区、发送身份、收件方和内容。
- 使用输入模式中的必填字段调用
email_send。 - 保存返回的消息 ID。
- 使用
email_get检查投递状态、收件方结果和事件时间线。
发送被接受并不代表已送达。之后的退信或拒收需要你的代理或应用程序处理该失败。
缺少发送方或权限可能导致发送失败。设置和诊断工具让代理在重试之前检查这些要求。
可以在本地运行服务器吗？
可以。安装 Bird CLI。使用 bird auth login 登录。配置你的客户端启动 bird mcp。
客户端启动该进程，通过进程的输入和输出流进行通信。它需要 bird 作为命令、mcp 作为参数。
本地和托管服务器暴露相同的工具集。在本地运行进程仍然需要网络访问以执行 Bird API 操作。
当你希望自行管理时使用本地进程。你的客户端必须能够启动命令。当客户端无法运行本地二进制文件时使用托管 URL。
什么控制代理可以执行哪些操作？
已连接的凭据限制访问范围。你的 AI 宿主控制工具执行何时需要确认。
Bird 为破坏性工具添加注解，以便宿主识别它们。例如，移除邮件抑制被标记为破坏性操作，因为它可能恢复不必要的发送。
注解本身不会强制触发审批提示。在允许更改生产资源之前，先配置你的宿主策略。
能够起草并提交邮件模板的代理也可以发布该模板。仅有草稿步骤并不能阻止代理调用提交工具。
WhatsApp 模板提交会将模板发送到 Meta 进行审核。它不会为代理可执行的每个其他操作提供人工审批步骤。
语音工具检查通话记录，也可以签发客户端凭据。没有 MCP 工具可以发起语音通话。CLI 提供测试通话操作。
对于支持 shell 的代理，CLI 提供 JSON 输出和退出码。选择你的宿主可以执行的接口，并为预期操作设置其确认策略。
简而言之
连接并登录。
托管服务器需要其 URL 和浏览器授权。仅添加 URL 并不会授权工具调用。
选择托管或本地访问。
远程客户端使用 https://mcp.bird.com，或在 CLI 登录后让客户端启动 bird mcp。
发送后跟踪消息。
发送结果确认已被接受。读取消息及其事件以确定投递状态。
配置宿主的确认策略。
工具注解描述操作，但不会强制要求审批。由你的宿主决定何时在执行前进行确认。