将 AI 工具与 MCP 连接

Ody 在 https://api.ody.co/v1/mcp 提供了一个内置的 MCP（模型上下文协议）服务器 — 将其与 API 密钥一起添加到 ChatGPT、Claude、Cursor 或任何 MCP 客户端，助手就可以管理联系人、处理您的对话、搜索消息、发送短信、购买电话号码、注册 10DLC 短信、拨打出站 AI 电话以及配置您工作区中的 AI 代理。

开始之前

• 您需要一个 API 密钥 — 请参阅获取您的 Ody API 密钥。对于只应读取的助手，请仅使用读取范围创建密钥。要在不发送真实短信的情况下进行实验，请使用 ody_test_… 密钥 — 请参阅使用测试模式安全构建。
• MCP 包含在所有套餐中，从 Starter 套餐开始。

分步指南

1. 点击侧边栏中的设置，然后点击开发者 API。

2. 滚动到连接到 ChatGPT 和 Claude 卡片。它显示了 MCP 端点 — https://api.ody.co/v1/mcp — 带有一个复制按钮，以及一个可直接粘贴的客户端配置。

3. 在您的 AI 工具的 MCP/连接器设置中，使用此配置（替换为您的真实密钥）添加一个服务器：

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. 向助手提问，例如“给我总结一下我的 Ody 工作区”，以确认连接。

助手可以做什么

MCP 服务器公开了二十个工具，每个工具都由其 REST 端点使用的相同范围进行限制：

工具	功能	所需范围
list_contacts	列出或搜索您的联系人	contacts:read
create_contact	添加联系人	contacts:write
update_contact	更新联系人的姓名、公司、电话或电子邮件	contacts:write
delete_contact	永久删除联系人	contacts:write
list_conversations	列出开放/已完成的对话	conversations:read
get_conversation	读取完整对话串	conversations:read
set_conversation_status	将对话标记为开放或已完成	conversations:write
search_messages	搜索消息正文、语音邮件转录和通话备注	conversations:read
workspace_summary	快照：联系人数量、开放/已完成数量、未读总数、7 天流量	conversations:read
wait_for_message	等待（最长 25 秒）对话中的新入站消息	conversations:read
send_message	发送短信（到对话或电话号码）	messages:send
list_numbers	列出您的工作区号码	numbers:read
search_numbers	搜索您可以购买的电话号码	numbers:manage
buy_number	购买号码 — 像应用内购买一样计费	numbers:manage
get_messaging_status	检查 10DLC 短信注册状态	numbers:manage
submit_10dlc_registration	提交您的 10DLC 业务 + 活动备案（收费）	numbers:manage
place_call	让您已发布的 AI 代理拨打出站电话	calls:place
get_agent	读取您的 AI 代理配置和信用额度使用情况	agent:manage
configure_agent	更新代理配置；传递 publish: true 以使其上线	agent:manage
connect_agent_to_number	将您的一个号码路由到 AI 代理	agent:manage

如果密钥缺少某个范围，则该工具将不会提供给助手 — 因此只读密钥会生成一个真正的只读助手。所有操作都以创建密钥的成员的权限运行，且仅限于该工作区。

有两点值得注意：

• wait_for_message 允许助手进行实时短信对话：它使用 send_message 发送短信，等待最多 25 秒的回复，然后响应 — 如果等待超时，则再次调用该工具。
• 号码、10DLC、通话和代理工具与 REST API 的“代理电话”界面相同 — 相同的计费、相同的规则，您可以随时在应用中接管。请参阅通过 API 购买号码和注册短信和通过 API 拨打 AI 电话和管理 Astra。

使用测试密钥时，send_message 会记录模拟消息，buy_number 和 place_call 会进行模拟（不购买或拨号），代理发布是模拟的，submit_10dlc_registration 在模拟模式下备案 — 无费用，不提交注册。

相关文章

• 获取您的 Ody API 密钥
• 使用测试模式安全构建
• API 概述和身份验证