AgentLine MCP Server

什么是 AgentLine MCP Server？

AgentLine MCP Server 是 AgentLine 的托管 MCP 端点。AgentLine 是一个为 AI 智能体提供真实美国电话号码的电话通信 API，借助它，Claude 和其他 MCP 客户端可以租用号码、拨打和接听电话、读取通话记录并查看收到的短信。

AgentLine 为你处理电话这一侧：托管的语音智能体负责实时对话（实时转写和文本转语音），你的智能体只需处理文本。MCP 服务器将 AgentLine 面向智能体的 REST 操作挂载为工具（文档称有 21 个以上），因此助手可以在一个对话中创建语音智能体、绑定号码、拨打电话并总结通话记录。号码仅限美国。

如何使用 AgentLine MCP Server？

你需要一个 AgentLine 账户（在 agentline.cloud 使用邮箱、Google 或 AgentID 登录），并为租用号码、拨打电话等付费操作充值余额。读取数据是免费的。服务器 URL 为：

https://api.agentline.cloud/mcp

该服务器使用 Streamable HTTP。支持 MCP OAuth 的客户端通过浏览器登录：agentline.cloud 会打开授权页面，选择 Read and write（默认）或 Read only，保持 Stay connected for 30 days 勾选，然后点击 Allow。此流程不涉及 API 密钥。

Claude Code

claude mcp add --transport http agentline https://api.agentline.cloud/mcp

在 Claude Code 中运行 /mcp，为 AgentLine 选择 Authenticate，授权页面会在浏览器中打开。

Claude Desktop 和 claude.ai

打开 Customize → Connectors，在 AgentLine 条目上点击 Connect，或选择 Add custom connector 并粘贴 https://api.agentline.cloud/mcp。在弹出的窗口中登录 AgentLine 并点击 Allow。然后在对话中通过 + → Connectors 启用它。在 claude.ai 中添加连接器需要付费的 Claude 套餐。

Cursor

将服务器添加到 ~/.cursor/mcp.json，并在 Cursor 的 MCP 设置中完成认证：

{
  "mcpServers": {
    "agentline": {
      "url": "https://api.agentline.cloud/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json；服务器首次启动时 VS Code 会提示你登录：

{
  "servers": {
    "agentline": {
      "type": "http",
      "url": "https://api.agentline.cloud/mcp"
    }
  }
}

不支持 MCP OAuth 的客户端

无头智能体和无法打开浏览器的客户端，可按 AgentLine 文档使用 AgentLine API 密钥（al_live_...）配合 mcp-remote：

{
  "mcpServers": {
    "agentline": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.agentline.cloud/mcp", "--header", "Authorization: Bearer $AGENTLINE_API_KEY"]
    }
  }
}

请将密钥保存在环境变量或客户端配置中，切勿放进 URL。

AgentLine MCP Server 的主要功能

• 为 AI 智能体提供真实的美国电话号码（本地号码或免费电话号码），可在对话中租用和释放。
• 由托管语音智能体拨出电话，通话结束后可读取通话记录。
• 同一号码支持来电和接收短信；短信通过 list_messages 列出。
• 每个智能体都有联系人列表（create_contact、list_contacts、update_contact），"给我的牙医打电话"可以对应到已保存的号码。
• 实时通话上下文：push_call_context 可向进行中的 relay 模式通话推送简短信息。
• 提供通话和短信活动的 webhook 与事件，以及查询余额和支出的计费工具。
• OAuth 授权可选只读或读写范围，并可在 AgentLine 后台随时撤销。
• 对于会扣费、联系第三方或删除内容的工具，Claude 会先征求你的确认。

AgentLine MCP Server 的使用场景

• 设置接待员："创建一个名为 Front Desk 的 AgentLine 语音智能体，为一家牙科诊所预约，租一个 415 区号的号码并绑定。"
• 快速打个电话："用我的 Front Desk 智能体拨打 +14155550100，问他们周六是否营业，通话结束后总结通话记录。"
• 查看活动："列出我本周的 AgentLine 通话及其时长和费用。"
• 接入集成："把 Front Desk 智能体的 webhook 设为 https://example.com/hooks/agentline 并发送一个测试事件。"
• 跟踪支出："我的 AgentLine 余额是多少？本月钱花在哪里了？"
• 读取短信：查看智能体号码收到的短信，例如验证码或回复。

AgentLine MCP Server 常见问题排查

• 大约一小时后要求重新连接：授权时没有勾选 Stay connected for 30 days。重新连接并保持勾选。
• Read Only connection cannot modify data：你授权的是 Read only。在后台撤销后以 Read and write 重新连接。
• Insufficient balance：付费操作需要账户有余额；拨打电话至少需要 0.50 美元余额。充值后重试。
• "This sign-in request expired"：客户端打开授权页面后已超过 10 分钟。重新发起连接。
• Couldn't reach the MCP server：可能是临时故障或网络拦截。重试，仍不行请联系 AgentLine 支持。