文档 MCP 服务器 — 在 AI 工具中直接查找本文档

这是一个让 AI 工具直接查找并阅读 PlantPulse 文档 的 MCP（Model Context Protocol）服务器。只需在 Claude Code、Claude Desktop、Cursor、VS Code 等支持 MCP 的工具中添加一个地址，它就能在对话中搜索文档、阅读整页内容，并 附上出处链接 作答。

任何人都可以使用，无需注册，也无需 API 密钥。 服务器为只读，不具备修改文档或访问其他系统的功能。

连接信息

项目	值
地址	`https://docs.plantpulse.io/mcp`
传输方式	Streamable HTTP（无状态 — 无会话）
认证	无
语言	`en`（默认）·`ko`·`ja`·`zh`·`de`
文档范围	本站当前发布的全部文档 — Platform·Edge·AI·Studio·资源

文档更新、网站重新部署后，MCP 服务器的内容也会随之更新，无需另外等待索引。

连接方法

Claude Code

claude mcp add --transport http plantpulse-docs https://docs.plantpulse.io/mcp

添加后，如果 claude mcp list 中显示 plantpulse-docs 为 ✓ Connected，即表示连接成功。若要让整个项目共用，请加上 --scope project（会写入 .mcp.json）。

Claude Desktop

在 设置 → 连接器 → 添加自定义连接器 中填入地址 https://docs.plantpulse.io/mcp，认证项留空。

如需通过配置文件（claude_desktop_config.json）添加，请使用桥接远程服务器的 mcp-remote（需要 Node.js）。

{
  "mcpServers": {
    "plantpulse-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.plantpulse.io/mcp"]
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json（所有项目）或项目中的 .cursor/mcp.json。

{
  "mcpServers": {
    "plantpulse-docs": {
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

VS Code（GitHub Copilot 代理模式）

添加到工作区的 .vscode/mcp.json。

{
  "servers": {
    "plantpulse-docs": {
      "type": "http",
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

ChatGPT

在 ChatGPT 中，以 自定义连接器（自定义 MCP 服务器）的方式连接。

打开添加自定义 MCP 服务器的界面。目前是 Plugins（chatgpt.com/plugins）中的 + → Add custom MCP server；视 ChatGPT 版本而定，也可能是在 设置 → 连接器（Apps & Connectors）→ 高级设置 中开启 开发者模式，再选择创建。
输入名称（例如 PlantPulse Docs）和说明，地址填写 https://docs.plantpulse.io/mcp。
认证选择无（No authentication）。
阅读风险提示并同意后创建。服务器报告的工具列表中出现 search·fetch 即可。

能否使用该菜单取决于 ChatGPT 的套餐和工作区设置（管理员是否允许自定义连接器），菜单名称也会随 ChatGPT 版本而变化。ChatGPT 的连接器和深度研究会寻找名称恰好为 search·fetch 的工具，因此本服务器单独提供这两个工具（见下方工具）。

其他 MCP 客户端

支持 Streamable HTTP 的客户端一般都接受以下格式。

{
  "mcpServers": {
    "plantpulse-docs": {
      "type": "http",
      "url": "https://docs.plantpulse.io/mcp"
    }
  }
}

工具

五个工具均为只读。

工具	参数	返回内容
`search_docs`	`query`（必填，最多 300 字）·`product`·`locale`·`limit`（1～20，默认 8）	最匹配的章节 — 标题·章节标题·产品·地址·摘录
`get_page`	`path`（必填）·`locale`	单个页面的标题·地址·章节列表·完整正文（最多 6 万字）
`list_pages`	`product`·`locale`·`cursor`·`limit`（1～200，默认 100）	页面列表 — 路径·标题·产品。用 `cursor` 获取下一批
`search`	`query`（必填）·`locale`·`product`·`limit`（1～20，默认 8）	供 ChatGPT 使用。`{"results":[{id, title, url, text}]}` — 以页面为单位的结果
`fetch`	`id`（必填）— `search` 返回的 id 或文档地址	供 ChatGPT 使用。`{id, title, text, url, metadata}` — 单个页面的完整正文

product 取 platform·edge·ai·studio·resources 之一。多个产品都有「修改密码·API 密钥」这类 同名页面，因此问题针对特定产品时，指定产品会更准确。
不指定 locale 时按英文（en）搜索。用中文提问时，zh 更合适。
get_page 的 path 可以是 /platform/frontline/user-guide 这样的站点路径、/zh/... 这样带语言前缀的路径，或完整的 https://docs.plantpulse.io/... 地址。路径不存在时会给出相近的页面。
search·fetch 以 ChatGPT 期望的名称和格式返回同一索引的内容。不指定 locale 时，search 根据搜索词的字符选择语言（韩文 → ko，假名 → ja，其他汉字 → zh，德语 → de，其余为 en）。id 是带语言前缀的页面路径，例如 /ko/edge/user-guide/plc-profiling-testkit。
搜索与本站的文档问答使用 相同的索引和相同的方法（关键词 BM25，包括韩语助词处理）。

服务器还会提示 AI 工具「作答时请引用返回的地址作为出处」。答案带有链接时，可以打开该页面核对原文。

使用限制

由于是公开服务器，为防止个别用户独占资源，设有以下限制。

项目	限制	超出时
请求次数	每个 IP 每分钟约 30 次（瞬时最多允许 20 次）	`429` — 1 分钟后重试
请求大小	64 KB	`413`
搜索词长度	300 字	工具错误
搜索结果	每次 20 条，摘录约 700 字	截断后返回
页面正文	6 万字	截断后返回，并附上原文地址

AI 工具连接时通常使用三四次请求（初始化·工具列表），每个问题再进行几次搜索和页面阅读。正常使用不会触及限制。

会记录什么

服务器只保留与文档网站相同的 Web 服务器访问日志（来源 IP·时间·地址），不另行保存搜索词和工具参数。请勿把公司机密内容作为搜索词 — 这是公开服务器。

自行验证

即使没有客户端，也可以用 curl 查看运行情况。Accept 请求头中必须同时写明两种格式。

curl -s https://docs.plantpulse.io/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_docs","arguments":{"query":"PLC 剖析","locale":"zh","limit":3}}}'

服务器状态（版本·页面数）可在 https://docs.plantpulse.io/mcp/healthz 查看。

出现问题时

症状	原因与处理
连接失败·`406`	客户端不支持 Streamable HTTP，或缺少 `Accept` 请求头。只支持旧版 SSE 传输方式的客户端，可像 Claude Desktop 一样经由 `mcp-remote` 连接。
`405`	使用了 `GET` 调用。本服务器为无状态，只接受 `POST`。
`429`	请求超出限制。请等待约 1 分钟后重试。
`503`	网站刚重新部署，服务器正在加载索引。请几秒后重试。
结果只有英文	未指定 `locale`。告诉 AI 工具「用中文文档查找」，它就会以 `zh` 调用。

连接信息​

连接方法​

Claude Code​

Claude Desktop​

Cursor​

VS Code（GitHub Copilot 代理模式）​

ChatGPT​

其他 MCP 客户端​

工具​

使用限制​

自行验证​

出现问题时​