企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api （不加 UTM）。模型对话页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，Coding Plan 在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，API Keys 在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

操作建议：打开察元设置进入模型与供应商相关页；启用至少一家供应商并保存；选定默认对话模型，类型必须是对话，不要误选纯嵌入或图像模型；用一小段测试文字，在加载项内先跑「拼写与语法检查」，确认能出问题列表或批注。这一步通过后，再让 Claude Code 调校对，排错时才能分清是「模型没配」还是「MCP 没连上」。

密钥按人按岗最小授权，公共电脑慎用个人密钥。如果你在 Claude Code 里也要用同一套模型，可以在~/.claude/settings.json或项目级.claude/settings.json里配置环境变量，把 Base URL 指向https://taotoken.net/api，Key 用你在 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里的 Authorization；URL 末尾是/mcp，不是/healthz。保存后重启 Claude Code，或按客户端方式刷新 MCP 列表。

如果你同时用 Cline MCP 或 CC Switch 管理多个 MCP 服务，三件套要写全：Base URL 填http://127.0.0.1:62588/mcp，Key 留空或写none，Model ID 填你在察元里选定的对话模型。Codex 的auth.json里如果也要挂这个 MCP，同样只填 URL，不要塞 Token。Claude Code 的 Anthropic 兼容配置可以参考 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite ，但 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/api，Key 是否过期。

local proxy failed：通常是客户端试图走系统代理访问127.0.0.1，但回环地址不该走代理。检查环境变量HTTP_PROXY、HTTPS_PROXY、ALL_PROXY，把127.0.0.1和localhost加入NO_PROXY。命令示例：

export NO_PROXY="127.0.0.1,localhost"

reading 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_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。如果只是验证模型对话是否正常，用模型对话页：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。排障和接入细节看接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。API Keys 在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。

安全边界再强调一次：默认端口不面向公网，不要随手把 62588 映射到互联网；公共电脑注意模型密钥残留；自动审查是初筛，不是司法鉴定，不是定密结论；扫描件、纯图文字、复杂文本框能力会下降。按本文做完，你得到的是 Claude Code 能直接审本机 WPS 文件的闭环，结果以 WPS 里的批注和可控替换为准，不以智能体口头保证为准。