Chiho AI
如果 Telegram MCP 显示已连接，但助手找不到工具或聊天，请按顺序检查：安装 → 浏览器授权 → 身份确认 → 一次限定范围的读取。服务器连接状态本身，不能证明助手能从目标 Telegram 账号获取消息。
Chiho 将已获授权的现有 Telegram 账号会话提供给 Codex、Claude 或 ChatGPT 等 AI 客户端。通过 Telegram 机器人或 Claude Channel 向运行中的代理发送指令，是另一种用途；仅有这类连接，并不能证明代理可以访问你的个人聊天历史。实际访问范围取决于账号身份、已授予的权限、可能涉及的 Telegram Business 权限、历史覆盖范围和可用工具。架构指南介绍了如何选择适合的访问方式。
本文由 Chiho 发布，依据 2026 年 10 月 6 日检查的 Chiho 源代码及当前客户端文档编写。这是一套诊断流程，并非客户账号中的成功测试报告。示例均为虚构；可用工具取决于所连接的产品与资源版本。 页首现有图片仅展示 Chiho 的一般界面，并非故障排查结果。
从第一个缺少证据的环节开始
按以下顺序检查，在第一个失败环节停下：
- **当前客户端没有 Chiho 连接：**检查是否已在这个应用和工作区安装。
- **连接存在，但要求登录：**完成该连接的浏览器授权。
- **工具不可用：**检查客户端发现的工具、所选资源及限制。
- **身份不符，或没有状态正常的 Telegram 账号：**核对 Chiho 连接及其中的 Telegram 账号。
- **读取成功，但没有有用内容：**检查聊天、时间范围、分页和覆盖情况。
- **读取返回等待或错误：**先处理返回结果，再重试或扩大请求。
不要把删除并重装所有连接当成通用修复方法。定位故障层之前，保留仍然正常的连接。
确认安装在实际使用的客户端中
从持续维护的 Chiho MCP 设置页面开始。记录应用、所选连接标签和不含凭据的资源 URL。Chiho CRM 与独立的 Telegram 客户端产品不保证工具完全相同，不同资源版本也保留不同契约。请对照已安装产品的设置说明，而不是凭记忆比较工具数量。
在 Codex 中，检查当前运行的客户端能否看到目标 MCP 配置。对于手动配置的 OAuth 服务器，codex mcp login <server-name> 会启动浏览器登录；使用现有配置中的服务器名。在另一个应用中安装插件，并不能证明这里也能使用。参见 Codex MCP 文档与 Chiho ChatGPT/Codex 指南。
在 Claude Code 中，通过 /mcp 检查连接，并在提示时为远程 OAuth 服务器授权。在其他 Claude 界面配置的连接器，仍需在当前使用的界面可用。参见 Claude Code MCP 文档与 Chiho Claude 指南。
在 ChatGPT 中，检查当前工作区已安装的插件和已连接账号。可用性可能取决于支持的使用界面和工作区政策。按 OpenAI 的账号连接说明操作，再确认当前对话选用的连接。
通过 Telegram 与代理交流的 Claude Channel，并不能证明代理拥有账号历史连接器。修改设置前，先辨明集成类型。
区分浏览器授权与 Telegram 账号状态
完成 Chiho 的浏览器同意流程，返回同一个客户端。核对目标 Chiho 账号、个人或团队范围，以及请求的权限。交互式设置不需要把服务令牌复制到提示词或支持工单中。
如果当前连接的工具集提供这些工具，先调用 auth_status，再调用 account_whoami：
auth_status返回已认证的范围、能力权限、审批模式，以及可访问且状态正常的 Telegram 账号数量。account_whoami返回可访问的 Telegram 账号及连接或重新授权标记。身份信息应在私密环境中核对。
Chiho 已认证但没有正常的 Telegram 账号，与 MCP 授权失败是两种不同结果。如果账号状态要求重新授权，应通过 Chiho 重新连接 Telegram；单纯重复 AI 客户端的 OAuth 登录，不能证明 Telegram 会话已经恢复。
对于提供 get_profile 的 CRM v9 连接，先用它核对 Chiho 身份与范围，再选择 Telegram 账号。旧资源和独立的 Telegram 客户端产品保留各自契约，因此仅缺少这个工具并不代表故障。get_profile 不读取 Telegram 消息。accountId 只能选择已授权连接内部的 Telegram 账号，不能切换到另一个 Chiho 连接。
如果存在两个命名连接，要求助手只使用目标连接，并在身份不匹配时停止。定时任务需要与交互式聊天分别验证：某个对话中的成功选择，不证明任务也会使用同一连接。
连接存在，但工具缺失
让助手检查当前对话实际可用的工具。不要让它根据旧指南中的名称编造调用。有些客户端按需发现工具，不同产品界面展示的名称也可能不同。
对照三项信息：配置的资源与版本、已认证的个人或团队范围，以及客户端允许的工具。Chiho 按范围与能力权限过滤已认证工具列表，因此个人连接和团队范围连接不一定提供相同操作。
如果授权过期或被撤销，使用客户端的重新连接流程，然后再次核对身份。令牌绑定具体资源与环境；把生产凭据复制到预发布端点，或更改资源 URL 却继续使用旧授权，都不是修复方法。新资源需要单独授权。不要为了排查缺失的读取工具而放宽工作区控制或启用写入。
纠正配置后，使用客户端支持的方式刷新连接。先再次确认工具发现，再尝试读取历史。如果发现过程仍然失败，保存脱敏错误信息，停止没有新依据的重复登录。
工具可用，但找不到聊天或消息
选择一个已知且获准访问的会话，以及包含一条你能独立确认的消息的短时间段。首次测试保持小范围。可以这样提出诊断请求：
只使用指定的 Chiho 连接。先核对连接身份和 Telegram 账号。读取我指定的一个已授权聊天，最多五条消息。返回实际覆盖的时间段、消息引用和简短事实摘要。说明任何不完整覆盖或错误。不要发送消息、导入聊天、修改记录或创建任务。如果身份不明确，请停止。
谨慎解释结果：
- **Telegram 历史与 CRM 列表不同。**没有保存的 CRM 行，并不证明 Telegram 中不存在该会话；存在一行，也不证明完整消息历史已被获取。参见联系人、会话与 CRM 数量的区别。
- **范围很重要。**团队读取要求会话对团队可见。不要为了绕过团队限制而切换到更宽泛的个人范围。
- **搜索参数很重要。**托管 CRM 的消息搜索实现支持 Telegram 搜索，不支持其中的本地、标签或公司过滤。团队范围搜索必须指定聊天。使用当前工具架构，不要照抄不支持的参数。
- **一页结果不是整个档案。**说明账号、会话、返回的时间范围，以及是否存在后续页或部分结果。仅使用工具支持的分页方式。
- **空结果是有限范围的观察。**某个短语或时间段没有匹配，不能证明某项承诺从未存在。作出更广泛结论前，重新核对范围与已知消息。
例如，一个虚构测试返回了五条近期消息，但已知决定是在一个月前作出的。这证明近期的一页已被读取，不能证明搜索损坏或决定不存在。再对正确时段进行一次限定范围的请求，就能帮助区分原因，无需获取整个账号的历史。
遵守等待响应，区分读取与会写入的修复操作
如果 chat_read 返回 rate_limited，必须等待返回的 retryAfterSeconds，再读取该账号。不要对同一账号并行读取，也不要在等待期内反复调用。Chiho 源代码按 Telegram 账号执行退避；对固定请求速率的猜测不能代替运行时响应。
如果你正在检查已有的会话列表同步，waiting_for_telegram 和 resumeAt 表示该任务处于等待状态，不代表任务已完成。启动新的同步是可能更新已存列表的独立操作，不是证明 MCP 已授权所必需的步骤。
HTTP 成功也不证明工具成功。先检查工具错误标记与结果，再确认请求的消息是否实际返回。超时时，保留这个小范围请求及已报告状态，不要立即扩大为多个读取请求。
在尝试会改变数据的修复前，检查工具权限。Chiho 执行范围、能力和运行保护，但并非每次代理写入都会等待一次独立的 Chiho 审批。某些消息发送及 CRM、任务修改可能在客户端控制之后直接执行。将本次诊断保持为只读；在有意扩大工作流前，先查看安全检查清单。
若仍失败，提供简短、脱敏的支持记录
有效记录应标出失败环节，而不暴露会话内容：
- UTC 时间、客户端名称与版本，以及交互式聊天还是定时任务。
- 不含令牌或秘密查询参数的产品/资源 URL；用中性标签代替私密连接名称。
- 最后成功的步骤：安装、授权、身份核对、工具发现，或限定范围读取。
- 失败工具名、安全的错误代码、界面若提供则记录请求 ID，以及返回的等待时长。
- 预期与实际行为，用虚构聊天标签说明，并区分空结果、部分结果和错误。
不要附上 bearer 令牌、OAuth 回调 URL、Telegram 登录码、会话字符串、原始工具载荷、消息历史，或含账号信息的截图。可以写“预期连接 A，实际为连接 B”，无需发送个人资料标识符或账号名称。
一个虚构的支持摘要可以是：“Claude Code；交互式聊天；身份已核对；单个聊天读取返回限流代码及等待时长；没有并行重试。”这能给支持人员一个明确的故障边界，而无需复制客户内容。
用一次有来源依据的读取完成验证
对本次测试而言，恢复完成的条件是：目标连接与 Telegram 账号已确认，所需工具可用，一次限定范围请求返回预期的源消息，并清楚说明覆盖范围。绿色连接标记，或没有实际检索证据的流畅回答，都不足以证明成功。
返回 Chiho 设置指南，完成安装与浏览器授权，核对身份，再读取一个获准访问的会话。成功后，使用收件箱简报工作流逐步扩大范围。启用定期检查或写入前，把首次成功读取保留为验收检查。