1. 察元 AI 文档助手 v4.0 的 MCP endpoint 到底填在哪WPS 文档自动审查链路拆解察元 AI 文档助手 v4.0 是一套跑在 WPS 里的加载项配合本机 sidecar 进程对外暴露一个 MCP 服务让 Claude Code 这类客户端能直接读段落、定位原文、写批注、在确认后替换正文。它适合需要对本机 WPS 公文、制度、合同做自动审查又希望每一步可复核的人。整条链路其实只有三段装好察元加载项并真正打开 WPS在加载项里配好校对用的对话模型并自测通过把 Claude Code 接到本机 MCP 服务chayuan-wps-mcp按「先预览、再确认写批注」跑完整闭环。很多人卡住的地方不是安装而是 MCP endpoint 的填写位置和鉴权方式。默认情况下本机 MCP 地址固定为http://127.0.0.1:62588/mcp健康检查是http://127.0.0.1:62588/healthz服务名统一写成chayuan-wps-mcp。它只监听本机回环地址不需要 Token也不需要额外配代理。这一点和不少云端 MCP 服务不一样鉴权方式就是「无 Token 仅本机可访问」所以你在客户端里填地址时不要自作主张加 Authorization 头也不要把它改成局域网 IP。我试过在同一个环境里同时跑旧版 sidecar 和新版结果 healthz 通、工具调用却失败后来发现是 62588 被两份进程抢。所以下面按安装当天的真实顺序写命令可复制失败现象按层排查。文档审查不是「一句话改完美」稳妥顺序始终是预览问题列表、人工确认、再写批注或改正文。涉密与定稿以人工和单位制度为准。如果你还没装 Claude Code可以先看官方 MCP 文档了解 transport 类型端口、sidecar 与无 Token 设计可以参考本系列专文模型配置失败时见模型与供应商配置那篇。本文重点放在「MCP endpoint 改到哪、怎么鉴权、怎么验证链路真的跑通」。2. TaoToken 前置把模型对话与 Coding Plan 准备好在动 MCP 之前先把模型侧准备好否则后面校对预览会报MODEL_NOT_CONFIGURED你会误以为是 MCP 没连上。察元加载项里的拼写与语法检查、结构化自动审查都依赖一个对话模型。你可以走两类路离线或内网用 Ollama、LM Studio、Xinference、OneAPI、New API 等 OpenAI 兼容端点云端则按单位合规要求配置可用供应商与 API 密钥。如果你希望 Claude Code 侧也能稳定调用模型做多步编排可以先把 TaoToken 的模型对话和 Coding Plan 准备好。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 不加 UTM。模型对话页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。操作建议打开察元设置进入模型与供应商相关页启用至少一家供应商并保存选定默认对话模型类型必须是对话不要误选纯嵌入或图像模型用一小段测试文字在加载项内先跑「拼写与语法检查」确认能出问题列表或批注。这一步通过后再让 Claude Code 调校对排错时才能分清是「模型没配」还是「MCP 没连上」。密钥按人按岗最小授权公共电脑慎用个人密钥。如果你在 Claude Code 里也要用同一套模型可以在~/.claude/settings.json或项目级.claude/settings.json里配置环境变量把 Base URL 指向https://taotoken.net/apiKey 用你在 API Keys 页生成的Model ID 选一个对话模型。这样 Claude Code 侧的推理和察元侧的校对可以共用一套账号体系排查时少一个变量。3. 可复制配置MCP endpoint 填写位置与鉴权方式这一节是全文核心。MCP endpoint 的填写位置有两个一是命令行claude mcp add二是项目根或用户级的.mcp.json。鉴权方式统一是「无 Token」因为服务只绑127.0.0.1。下面给出可直接复制的片段。先确认 WPS 已打开、healthz 在线。浏览器访问http://127.0.0.1:62588/healthz期望看到在线或 online。然后在终端执行claude mcp add --transport http chayuan-wps-mcp http://127.0.0.1:62588/mcp如果你更喜欢写配置文件可以在项目根或用户级.mcp.json写入{ mcpServers: { chayuan-wps-mcp: { type: http, url: http://127.0.0.1:62588/mcp } } }注意三点transport 用http不要配成stdio不需要 Token不要加headers里的 AuthorizationURL 末尾是/mcp不是/healthz。保存后重启 Claude Code或按客户端方式刷新 MCP 列表。如果你同时用 Cline MCP 或 CC Switch 管理多个 MCP 服务三件套要写全Base URL 填http://127.0.0.1:62588/mcpKey 留空或写noneModel ID 填你在察元里选定的对话模型。Codex 的auth.json里如果也要挂这个 MCP同样只填 URL不要塞 Token。Claude Code 的 Anthropic 兼容配置可以参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 但 MCP 这一段和模型供应商是两回事别混在一起。实测下来最容易错的是把http://127.0.0.1:62588/mcp写成http://localhost:62588/mcp后在某些环境解析到 IPv6导致连接失败。统一写127.0.0.1最稳。另外如果你在容器或远程开发环境里跑 Claude Code回环地址指向的是容器自己不是宿主机这种情况需要额外做端口转发但默认安装只绑本机不建议把 62588 映射到公网。4. 验证请求与成功结果四级验收跑通审查链路配好之后不要急着审正式稿先做四级验收。第一级列表可见。在 Claude Code 的 MCP 列表中能看到chayuan-wps-mcp状态为已连接或可用。第二级工具可见。展开后应能看到与文档相关的工具例如状态查询、打开文档、读段落或分块、定位、替换、批注、校对预览、写成批注等具体名称以当前版本工具列表为准。第三级只读冒烟。WPS 中打开测试稿对 Claude Code 说通过 chayuan-wps-mcp 告诉我当前活动文档的文件名和大概字数不要改正文不要写批注。若回报与标题栏一致说明读写桥通了。第四级审查预览冒烟。再说对当前文档做校对预览列出错别字和标点问题不要写批注不要改正文。若返回问题列表说明校对链路通了。若报模型未配置回到模型配置节。若报 WPS 离线回到安装与 healthz 节。成功的预览结果对话里出现条目化问题含原文片段与建议而不是一句「已检查完毕」却无细节。成功的批注结果WPS 批注窗格有多条批注点开后高亮落在具体错字或词组上表格内不整格误挂。成功的替换结果仅你确认过的条目正文变化其余不动可用另存对比。推荐固定开场白你通过 chayuan-wps-mcp 对当前 WPS 文件做自动审查。先做校对预览列出错别字、标点和明显病句。等我回复确认写批注后再写批注且尽量钉在具体文字上尤其是表格。没有我说确认替换不要改正文。最后按严重、一般、建议三级给我摘要。验收标准建议写成严重问题已处理或已批注、抽查不少于三处锚点正确、未发生未经确认的大段替换。长文超时或过大时让 Claude 按块审查不要一次拉全文。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排错时按层看不要一上来就重装。下面列几个真实报错和对应处理。401 Unauthorized如果你在.mcp.json里加了 Authorization 头或者把 TaoToken 的 Key 误填到 MCP 配置里就会 401。察元本机 MCP 不需要 Token删掉 headers 即可。如果你是在模型侧遇到 401检查 Base URL 是否为https://taotoken.net/apiKey 是否过期。local proxy failed通常是客户端试图走系统代理访问127.0.0.1但回环地址不该走代理。检查环境变量HTTP_PROXY、HTTPS_PROXY、ALL_PROXY把127.0.0.1和localhost加入NO_PROXY。命令示例export NO_PROXY127.0.0.1,localhostreading choices或类似解析错误多半是模型返回格式不符合预期或者你选的不是对话模型。回察元设置确认默认对话模型类型正确并用加载项自测一次。OAuth相关报错如果你在 Claude Code 侧配置了 Anthropic 兼容端点可能触发 OAuth 流程。MCP 这一段和模型供应商是两回事先把 MCP 的 URL 和 transport 确认对再单独处理模型侧的鉴权。WPS_AGENT_OFFLINE打开 WPS确认加载项加载刷新 healthz。MODEL_NOT_CONFIGURED回察元设置配对话模型。CONFIRMATION_REQUIRED这是设计不是故障回复确认即可。DOCUMENT_TOO_LARGE按块审查。批注落点漂到邻句或整格指令写死钉在单元格具体错字上不通过则先不要确认替换。现象MCP 列表没有服务。处理检查配置或重新执行claude mcp add核对服务名与 URL。现象有服务但 Agent 离线。处理打开 WPS确认加载项加载刷新 healthz。现象能读文档校对报模型未配置。处理回察元设置配对话模型并用加载项自测一次。现象只要预览却被改了正文。处理开场白写死禁止未确认替换重要稿先另存。6. 语义一致 CTA把审查链路固定成日常流程链路跑通后建议把它固定成日常流程在 WPS 打开待审文件重要稿先另存副本确认 healthz 在线、Claude Code 已挂上chayuan-wps-mcp粘贴开场白先只要预览人工看问题列表标出误报与必须改回复「确认写批注」打开 WPS 批注窗格抽查锚点尤其是表格需要改字的条目再「确认替换」或按条确认另存为「原名-已校对」一类文件名。如果你希望长期用 Claude Code 做编码和 Agent 编排可以把 Coding Plan 准备好https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。如果只是验证模型对话是否正常用模型对话页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。排障和接入细节看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。安全边界再强调一次默认端口不面向公网不要随手把 62588 映射到互联网公共电脑注意模型密钥残留自动审查是初筛不是司法鉴定不是定密结论扫描件、纯图文字、复杂文本框能力会下降。按本文做完你得到的是 Claude Code 能直接审本机 WPS 文件的闭环结果以 WPS 里的批注和可控替换为准不以智能体口头保证为准。