用 AI 客户端读社区

这是什么

X2Post 提供 MCP（Model Context Protocol）服务：Claude、Cursor 这类支持 MCP 的 AI 客户端， 可以直接读社区内容——搜索帖子、读某篇帖子与它的评论、看版块与标签、查公开资料。 不用再手工复制粘贴，AI 会自己决定该调用哪些工具。

服务地址固定为 https://x2post.com/mcp，只读：任何工具都不能发帖、评论或修改资料。

方式一：一键授权（推荐）

不用手工创建令牌，客户端会引导你完成授权：

1. 在 AI 客户端里添加一个「远程 MCP 服务」，地址填 https://x2post.com/mcp；
2. 客户端第一次连接会跳回 X2Post，你会在授权页看到「这个客户端能读到什么」，确认后点「同意授权」；
3. 之后由客户端保管授权结果，你不用再管。

不同客户端的位置：

客户端	怎么填
Claude Code	命令 claude mcp add --transport http x2post https://x2post.com/mcp
Cursor / VS Code 等读 mcp.json 的客户端	在 mcpServers 里加一项：{ "x2post": { "url": "https://x2post.com/mcp" } }
Claude 桌面端 / Claude.ai / ChatGPT	「设置 → 连接器（Connectors）」里添加自定义连接器，地址同上

授权页如果提示「由客户端自动注册、未经站长审核」，那是因为 AI 客户端的应用信息是它自己登记的； 确认是你自己在配置客户端，就可以同意。不明白来源就直接点「拒绝」。

方式二：用接口令牌

不想走授权流程时，可以用接口令牌（步骤与撤销都在「资料设置 → 接口令牌」）：

1. 新建令牌，勾选「读取社区公开内容」；想让自己名下的帖子/资料也能被读到，再勾上「读取公开资料」「读取你发布的帖子列表」；
2. 复制明文（只显示一次）；
3. 在客户端里以自定义请求头的方式带上：

{
  "mcpServers": {
    "x2post": {
      "url": "https://x2post.com/mcp",
      "headers": { "Authorization": "Bearer <你的令牌>" }
    }
  }
}

能读到什么、读不到什么

能读到	游客可见的公开内容：帖子搜索/正文/评论、版块与标签、任意用户的公开资料；再按你勾选/同意的范围附加本人资料与本人帖子
读不到	草稿、私信、通知、钱包；被隐藏或已删除的内容；作者设了「回复可见」的加密内容（一律不返回）
频率	每个令牌每分钟最多 60 次调用；服务端还会按工具再做一次细分限流

关于隐私

• AI 请求到的社区内容会发送给你配置的那个 AI 服务商（Anthropic、OpenAI 等），用于完成你发起的提问；
• 授权可以用「资料设置 → 已授权应用」取消，接口令牌可以在令牌页撤销，撤销后立即生效 （接口令牌方式下，服务端缓存最多 60 秒）；
• 授权页会逐条列出这个客户端能读什么，不会有「没说但能读」的范围。

常见问题

• 它会代替我发帖吗？不会，开放给 AI 的能力全部是只读的。
• 我的帖子能被搜到吗？能，只要它是公开可见的帖子，任何人的 AI 客户端都能读到——和网页上游客能看到的范围一致。
• 提示「没有 xxx 权限」怎么办？给它用的授权/令牌缺对应权限：OAuth 方式重新授权并勾选，令牌方式需要新建一个勾好权限的令牌（令牌权限创建后不可修改）。
• 提示「调用过于频繁」怎么办？每个令牌每分钟 60 次，稍后再试即可。
• 想自己写程序接入、而不是用现成客户端？见开发者文档：开放接口与 MCP 的协议细节都在那里。