将 AI 代理连接到 Telegram：Chiho 设置指南

要将 AI 代理连接到 Telegram，请先在 Chiho 中连接您的 Telegram 账户，将 https://api.chiho.ai/mcp 添加到兼容的 MCP 客户端，并完成浏览器 OAuth 授权。随后通过 auth_status 验证账户和访问范围，再让代理读取一个选定的对话。

本指南涵盖 Chiho 的托管连接和独立的本地运行环境选项。MCP 提供工具；技能提供工作流程指令。安装技能并不授权访问您的 Telegram 账户。

**验证说明 — 2026 年 9 月 8 日：**这些指令已根据 Chiho 当前实现、本地 Codex 命令帮助和链接中的客户端文档核对。本次更新没有重新进行经过身份验证的客户端设置，也没有读取客户对话。下方练习是验收清单，而非账户实测结果报告。现有顶部图片展示的是 Chiho 收件箱，并非 OAuth 设置测试。

选择您打算使用的连接

Chiho Cloud 是用于 Telegram 和 CRM 工作的托管方案。AI 客户端连接到 Chiho 的远程 MCP 服务，并要求您在浏览器中登录和同意授权。请结合本指南阅读 Telegram MCP 设置参考。

tgchats local 是 Telegram 代理仓库中独立的开源本地运行环境。如果您希望维护本地环境，请遵循该仓库当前的安装和运行说明。它的设置与存储责任不同于托管连接；成功登录云端不能验证本地运行环境。

如果仍在选择系统类型，Telegram CRM 指南介绍客户关系工作流程，而 CRM、机器人与共享收件箱的比较比较不同方案。

连接前：账户、客户端和对话

准备一个已连接 Telegram 的 Chiho 账户、支持远程 HTTP MCP 和浏览器 OAuth 的客户端，并明确选择个人或团队上下文。第一次练习请选择一个您获准查看的对话。避免从整个收件箱或发送消息的请求开始。

在允许 AI 客户端获取对话内容前，检查其数据处理方式和组织规定。Chiho 将托管的 Telegram 会话保存在自己的服务内，但工具返回的信息会提供给已连接的 AI 客户端。已公布的数据处理条款请参阅 Chiho 的隐私政策。

请严格使用上方展示的生产资源。暂存资源用于隔离的上线前测试；生产和暂存授权不能互换。

连接托管 MCP 服务

Codex

在安装了 Codex 的终端运行以下命令：

codex mcp add chiho --url https://api.chiho.ai/mcp
codex mcp login chiho

第二条命令启动浏览器授权。同意后，返回使用该已保存配置的 Codex 界面，并请求 auth_status。如果服务器没有出现，请检查该界面是否与终端使用相同配置。托管端点和配置上下文请参阅 Chiho 客户端设置参考。

Claude Code

添加远程 HTTP 服务器：

claude mcp add --scope user --transport http chiho https://api.chiho.ai/mcp

在 Claude Code 中打开 /mcp，完成 Chiho 身份验证。随后请求 auth_status。Anthropic 的 MCP 文档介绍远程 HTTP 配置和身份验证。客户端控制和可用连接器功能可能不同；请检查您所用版本的文档。

其他兼容客户端

使用客户端的自定义远程 MCP 连接流程，并填写相同的生产 URL。对于 Chiho 的公共客户端 OAuth 流程，除非支持团队已提供托管部署凭据，否则将可选的客户端 ID 和密钥字段留空。请完成浏览器同意流程，不要将持有者令牌复制到配置文件中。

Chiho 已在 ChatGPT 插件市场提供。在 ChatGPT 或 Codex 中安装插件，并在该客户端完成浏览器授权。本地 Codex 配置不会在 ChatGPT 网页版中安装插件。

能够连接服务器的客户端不一定已完成授权。不要把传输连接图标视为目标 Telegram 账户可用的证明。

将同意页面视为访问决策

同意前检查客户端身份、重定向主机、Chiho 账户、个人或团队范围以及完整权限集。Chiho 交互授权包含支持的读取和写入能力；从只读请求开始，并不会使授权本身变成只读授权。

团队授权将工具限制在团队可见的账户和对话内。团队消息搜索需要指定聊天；个人账户全局文件夹和退出登录操作不会在团队上下文开放。因此，对话缺失可能是访问边界所致，而非连接故障。

客户端工具提示和 Chiho 执行保护是独立的控制机制。超出读取操作前，请检查两者：

**存在直接写入操作。**单条消息发送、CRM 标签、任务、自动化规则、文件夹操作、摘要刷新和账户退出登录，均可在适用的客户端控制和服务器检查后执行。名为 message_send_draft 的工具会发送消息；不要推断它只保存草稿。
**发件箱审批取决于操作。**多个收件人的预览需要批准。连接使用始终询问模式时，单个收件人的发件箱预览也需要批准。
成员邀请和退出群组需要已保存的预览，并在执行前获得批准。
预览不是发送，但预览可能持久化审批状态。它不适合严格只读的验收练习。

“不要发送”这样的句子有助于定义任务，但不能替代工具权限。同样，安装工作流程技能不会改变授权。任何创建任务或刷新摘要的技能，都应作为包含写入的工作流程进行检查。

进行一次只读验收练习

授权后使用这个示例请求。将描述替换为您选定且获准查看的对话：

首先调用 auth_status，确认已连接账户及个人或团队上下文。找到我选择的对话，并在匹配不明确时请我确认。只读取该对话最近的消息。列出待解决问题、明确承诺和不清楚的内容，并为每项提供消息引用。说明时间范围和分页限制。不要发送消息、创建任务、修改 CRM 字段、刷新摘要、启动同步或准备写入预览。

自行对照对话检查结果：

**身份：**返回的账户和范围符合预期上下文。如果不符，请停止。
**目标：**选定对话正确。相似标题需要消除歧义，不能猜测收件人。
**覆盖范围：**代理说明读取了哪些内容。一页对话或消息不能证明历史完整；仅在必要且获准时继续分页。
**依据：**每个声称的承诺或待解决问题都有消息支持。缺失信息应保持未知，不能变成编造的截止日期或负责人。
**影响：**工具历史仅包含预期的读取操作。在 AI 对话中提供有用的文字摘要，不需要保存 CRM 摘要或创建任务。

例如，在一个虚构对话中，客户要求提案，队友说“我会在周五发送”。有用的答案应区分客户的问题与队友的承诺。没有支持消息时，不应声称提案已发送。这是用于说明评估的例子，不是客户证据或测量结果。

记录客户端及版本、检查日期、不含私人标识的账户上下文、使用的工具，以及五项检查的通过或失败结果。不要将令牌或私人消息放入共享测试记录。只有这项小型练习符合预期后，才扩大工作流程。

排查失败步骤

**授权始终无法完成：**重新检查准确的远程 URL，完成浏览器同意流程，并确认登录的是预期 Chiho 环境。被撤销的连接需要重新同意。向支持团队分享错误前，移除凭据和私人内容。

**授权正常但对话缺失：**检查 Chiho 中的 Telegram 连接、选定账户和授权的团队边界。比较同类清单：dialogs_list 分页列出 Telegram 对话；crm_dialogs_list 分页列出 Chiho 已持久保存的 CRM 清单。返回页面长度不是账户总数，两种列表都不是地址簿联系人数。

**只总结了部分历史：**请代理报告请求范围、返回范围和后续分页状态。不要让它把局部读取描述为整个收件箱的审计。

**Telegram 要求系统等待：**遵循返回的等待或重试信息。Chiho 的持久同步可报告 waiting_for_telegram 及恢复时间。反复重启工作无法消除 Telegram 限制，本指南也不承诺无限吞吐量。

**工具缺失或写入被拒绝：**检查身份验证后的工具列表、范围、客户端控制及所需的预览或审批状态。不要仅为消除错误而扩大访问。回到工作流程实际需要的最小操作。

撤销访问并选择下一项流程

在 Chiho 中打开已连接 AI 客户端，检查客户端和范围。不再需要时撤销连接；Chiho 会使其访问令牌和刷新令牌失效，重新连接需要再次同意。从 AI 客户端配置中移除服务器是独立的清理步骤。撤销不能收回已返回给该客户端的内容。

受控的无人值守任务请参阅高级服务令牌指南。服务令牌不是常规交互入门流程的一部分，不应出现在截图、共享配置或支持消息中。

只读练习后，选择一个限定范围的流程：通过跟进任务技能识别承诺，或通过线索资格评估技能整理对话。运行前检查技能的写入操作。优先级跟进指南解释任务与客户消息的不同用途。

在 Chiho 中连接 Telegram，完成浏览器授权，并在交给代理更广泛任务前验证一个选定对话。

如何通过 Chiho 将 AI 代理连接到 Telegram