Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet 提供了一个 Model Context Protocol (MCP) 服务器，允许 AI 代理和基于 LLM 的工具（例如 Claude 和 ChatGPT）通过标准 MCP 接口与 Telerivet REST API 交互。

Telerivet 的 MCP 服务器支持 AI 代理在 Telerivet 中执行各种操作，包括发送和安排消息、检索数据和使用统计信息、导入联系人，以及配置项目、路由和自动化服务。

MCP 端点位于：

https://api.telerivet.com/mcp

MCP 客户端通过 Streamable HTTP 传输，使用 HTTP POST 请求发送 JSON-RPC 2.0 消息进行连接。

客户端配置

MCP 端点需要通过 OAuth 2.0 进行身份验证。

支持 OAuth Client ID Metadata Documents (CIMD) 的 MCP 客户端无需任何手动配置即可连接：用户首次授权时，Telerivet 会自动注册该客户端。Telerivet 不支持 Dynamic Client Registration。

以下 MCP 客户端提供了设置说明：

• Claude（claude.ai 和 Claude Desktop）
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

对于不支持 Client ID Metadata Documents 的 MCP 客户端，必须手动配置 OAuth Client。若要使用其他不支持 CIMD 的 MCP 客户端，可以在 Telerivet 组织中添加新的 OAuth Client，并配置该 MCP 客户端所需的 OAuth 回调 URL。（提供 MCP 客户端的服务可能会在其文档中列出 OAuth 回调 URL。）以这种方式手动配置的 OAuth Client 只能由您自己的 Telerivet 组织中的用户访问。

授权 MCP 客户端

连接 MCP 客户端时，它会将您重定向到 Telerivet 以授权访问。在此页面上，您可以选择：

• 权限 – 应用可以访问的数据和执行的操作类型（例如，查看消息、发送消息或编辑自动化服务）。取消选中您不希望应用拥有的任何权限。应用的操作权限不会超过您自己的用户帐户权限；需要您未授予的权限的 API 方法会对 MCP 客户端隐藏。
• 组织 – 应用可以访问您的哪个组织。每次授权仅适用于一个组织；若要在另一个组织中使用该应用，请重新连接。

批准组织的应用。 每个 MCP 客户端（例如 Claude 或 ChatGPT）都必须先由组织管理员批准，才能在组织中使用。如果您是组织管理员，授权页面会允许您批准该应用在组织中使用，并选择谁可以使用此应用？：组织中的所有用户、仅组织管理员，或仅组织和项目管理员。其他用户会看到一条消息，提示他们联系组织管理员以批准该应用。

撤销访问权限。 您可以随时在帐户安全设置的已授权应用部分撤销应用对您帐户的访问权限。组织管理员可以在OAuth 访问令牌页面查看并撤销所有用户的访问令牌，也可以在已连接的应用页面彻底撤销某个应用的访问权限。

组织控制

组织管理员可以在已连接的应用页面（也可从组织的 Developer API 页面访问）控制每个已批准的 MCP 客户端在组织中可以执行的操作。点击某个应用即可查看或更改其设置。这些设置适用于组织中所有用户对该应用的访问，无论用户连接时授予了哪些权限。

所需权限 – 组织中哪些用户可以授权该应用（所有用户、仅组织管理员，或仅组织和项目管理员）。

允许的操作 – 对于每类操作，设置应用是否可以自行执行、是否必须由用户批准每项操作，或是否完全禁止：

操作	说明	选项	默认值
读取数据	查找联系人、消息、统计信息和其他项目数据。	允许、不允许	允许
创建和更新数据	创建和编辑联系人、群组、服务、草稿活动、路由和其他项目数据。	允许、需要批准、不允许	允许
发送消息和触发服务	向联系人发送或安排消息和通话、触发自动化服务，以及运行脚本。	允许、需要批准、不允许	需要批准
删除数据	删除联系人、消息、服务和其他项目数据。	允许、需要批准、不允许	需要批准
发出外部 Web 请求	从此应用运行的脚本向外部网站和第三方 API 发出请求。	允许、不允许	允许

当某个类别设为不允许时，相应的 MCP 工具（例如 send_api 或 delete_api）会对 MCP 客户端隐藏，并且该类别中的任何 API 请求都会被拒绝。run_script 工具遵循发送、创建/更新和删除数据这几类操作中最严格的设置。

某些应用会指定自己的默认设置，例如需要在没有用户参与的情况下发送消息的自主代理。如果应用的默认设置与标准默认设置不同，已连接的应用页面会在相应设置旁注明该应用的默认值。始终以您组织的设置为准。

允许的权限 – 应用在此组织中可以访问的数据和执行的操作类型。取消选中某项权限后，该应用在组织中的所有用户都无法执行相应的 API 操作，即使用户连接时授予了该权限也是如此。

撤销访问权限 – 将应用从组织的已批准应用中移除，并撤销该应用在组织中的所有现有访问令牌。

由您自己的组织拥有的应用（通过添加 OAuth Client添加）无需批准，其允许的操作在应用自身的设置页面中配置。

人工参与确认

当已连接的应用页面中的某类操作设为需要批准时，MCP 客户端必须先获得用户对每项操作的明确批准，才能执行这些操作。默认情况下，这适用于发送消息和触发服务，以及删除数据。

发送类别中的操作包括发送或安排消息和通话、重新发送消息、触发自动化服务、创建批量任务、模拟收到的消息、编辑已安排的消息或活动、启用自动化服务或更改活动服务的配置、创建 Webhook 或更改 Webhook URL、更改路由的电话号码或服务提供商设置、更改项目的默认路由，以及使用 run_script 工具运行脚本。删除类别包括所有删除方法，以及缩短项目的消息保留期限。

根据 MCP 客户端的不同，您可以通过以下方式之一批准操作：

MCP 客户端中的批准提示

如果 MCP 客户端支持 MCP elicitation（使用 MCP 协议版本 2026-07-28 或更高版本），MCP 客户端会直接提示您批准操作，并以通俗易懂的语言说明操作内容及其影响的项目。如果您批准，操作会立即执行。如果您拒绝，操作不会执行，并且 AI 模型会收到不得重试的指示。

消息草稿

如果 MCP 客户端支持 MCP Apps 扩展，AI 模型可以使用 draft_message 工具向您展示可编辑的文本消息草稿，其中包括收件人。点击发送即可批准向这些收件人发送该确切消息。

批准链接

如果 MCP 客户端不支持上述任一方式，或者操作无法通过这些方式批准，AI 模型会收到 Telerivet Web 应用中批准操作页面的链接，并应提示您打开该页面。此页面会显示应用、项目、操作说明和完整请求详情。点击批准后，返回 MCP 客户端并要求其重试。

要批准某项操作，您必须拥有该操作本身所需的权限（例如，在项目中发送消息的权限）。批准操作不会向应用授予任何额外权限。

批准的工作方式

• 每次批准仅适用于一个确切的请求——相同的 API 方法和相同的参数——且只能使用一次。如果 AI 模型更改了请求中的任何内容，就必须重新批准。
• 批准会在 1 小时后过期。
• 通过 run_script 批准的脚本所发出的 API 请求无需单独批准。
• 如果应用使用其访问令牌直接调用 REST API（而非通过 MCP），需要批准的请求会失败，并返回错误代码 confirmation_required，错误消息中包含批准链接。若应用需要在没有用户参与的情况下执行这些操作（例如服务器端集成或自主代理），组织管理员必须将相应类别设为允许。

消息审核。 无论上述设置如何，如果项目在消息设置中启用了消息审核，通过 API（包括 MCP）发送且超出配置限制的消息都会被暂存为待处理消息，直到审核者批准；这与从 Web 应用发送的消息处理方式相同。

工具

MCP 服务器目前提供以下工具：

• list_api_methods – 列出可用的 API 方法，包括名称、描述和参数摘要。支持按类别筛选。
• get_method_schema – 返回特定 API 方法的完整参数架构和响应字段说明。
• read_api – 执行只读 API 方法以检索数据。
• modify_api – 执行用于创建或更新数据的 API 方法。
• delete_api – 执行用于删除数据的 API 方法。
• send_api – 执行用于发送、安排或接收消息、调用自动化服务或执行批量任务的 API 方法。
• run_analysis_script – 在 Telerivet 的 Cloud Script API 沙盒中运行只读 JavaScript，以分析项目数据；适用于聚合、跨实体类型联接，或扫描大量记录而无需通过模型逐页读取。API 访问为只读，且已禁用出站 HTTP。
• run_script – 运行可访问 Cloud Script API 的 JavaScript（读取、写入、发送、HTTP 请求），用于执行原本需要许多单独 API 调用的批量操作。脚本发出的 API 请求会根据 OAuth 令牌的作用域进行检查，因此脚本的权限不会超出运行它的令牌。
• get_web_app_urls – 返回有关 Web 应用功能和 URL 模式的信息。AI 代理可据此生成指向无法通过 API 直接访问的功能的链接。不带查询时，返回所有页面的精简索引；按关键词或 URL 路径搜索时，返回匹配页面的完整详情。
• draft_message – 为一个或多个电话号码（或一组联系人）起草一条简单的文本消息，并在发送前提示用户批准（参见消息草稿）。仅当 MCP 客户端支持 MCP Apps 扩展时可用。
• get_route_options – 返回有关可用消息路由/渠道选项的信息。按国家/地区、渠道类型或使用场景筛选（或查询特定路由类型）时，会返回完整详情，包括地理可用性、合规要求、注册流程、计费模式（内部/Telerivet 管理与外部/BYOC）、设置时间表和定价。
• skillbook_search / skillbook_get – 返回与某个意图或使用场景匹配的常见解决方案模式、服务、营销活动类型、平台功能和消息模板的信息。
• search_documentation / get_documentation – 搜索并检索 Telerivet 文档库中的条目，包括用户指南帮助文章、法律/政策页面、开发者 API 文档，以及 www.telerivet.com 上的营销/公司内容。

MCP 服务器公开的工具和 API 方法可能会随时间变化。

以下链接展示了 MCP 服务器返回的 JSON，有助于了解可用的工具和 API 方法：

• 工具定义
• list_api_methods 工具的输出
• get_method_schema 工具针对 Project_queryContacts 方法的输出（替换 URL 的最后一部分，即可查看其他 API 方法的架构）
• get_documentation 工具针对 Cloud Script API 参考文档的输出（替换 URL 的最后一部分，即可查看其他文档条目）

授予 OAuth 令牌的作用域以及组织针对该应用的控制措施，共同决定哪些工具和 API 方法可用。需要令牌不具备的作用域，或组织不允许该应用使用的方法，将从列表中排除。