WEIR
获取 API Key
语言English
主题

X 官方 MCP 服务器：配置方法、费用和限制（2026）

X（推特）官方 MCP 服务器在 api.x.com/mcp：需要你自己的开发者应用，调用按量计费，只能写书签和长文。附配置步骤，以及只读数据时的另一个选择。


发布于 · 更新于 · 阅读约 6 分钟 · Read in English

封面图：X 官方 MCP，讲清楚

X 官方 MCP 服务器是 X 托管在 api.x.com/mcp 的接口，让 AI 工具通过你自己的开发者应用调用 X API。

这篇写给想让 Claude、Cursor 这类 AI 工具读写 X（推特）数据的人。你会看到配置步骤、真实成本，以及哪些工具能写入，全部在 2026 年 10 月 21 日对照 X 官方页面核对过。我们做的 Weir 是另一个 MCP 服务器，看我们的观点时请记住这一点。

这是 X 文档里给 Cursor 的配置，原样复制：

{
  "mcpServers": {
    "xapi": {
      "command": "npx",
      "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
      "env": {
        "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
      }
    }
  }
}
api.x.com/mcpX 托管的 MCP 地址
$0.005每读一条推文，按量计费
300 万每月读取推文上限，超过要签企业合同
2个写入范围：书签和长文

X 官方 MCP 服务器是什么？

X 运行着两个托管的 MCP 服务器：一个对应 API，一个对应文档。

大家说的是 API 那个。X 在 2026 年 6 月 30 日通过开发者论坛和 @XDevelopers 宣布了它。它走 Streamable HTTP，地址是 https://api.x.com/mcp，自称 xmcp。

另一个 https://docs.x.com/mcp 只用来搜索 X 的开发者文档，配置只需要这个地址。

按 X 的文档，API 服务器能做这些事：

范围 模型能做什么 类型
推文 读取推文、点赞者、转推者、引用者 只读
搜索 全量历史推文、用户、新闻 只读
用户 查账号、时间线、提及 只读
书签 列出、添加、删除、管理文件夹 写入
新闻和趋势 新闻，以及某个地区的趋势 只读
长文 创建草稿并发布 写入

列表里没有发推。上线当天，TechCrunch 报道说 X 确认这个 MCP“与 X 的写入 API 接口不兼容”。也就是说：不能发推、回复、点赞或关注。

2026 年 10 月 21 日，我们通过 Weir 搜索了 @XDevelopers 关于“MCP”的推文，排第一的就是上线公告：

→ search_x {"fromUsers": ["XDevelopers"], "query": "MCP", "sort": "top", "limit": 3}
← 4 posts · 5 credits
  2026-06-30 · 10,455 likes
  "Announcing the hosted X MCP. ..."

公告说任何兼容 MCP 的 AI 工具都能“无需任何设置”接入 X API。这是口号，文档里的步骤要长得多。

X 官方 MCP 怎么配置

每一种接法都要从你自己的 X 开发者应用开始。

X 的文档写得很直白：“X 的 OAuth 需要你自己的开发者应用。”它不支持动态客户端注册，所以聊天应用没法只凭地址帮你登录。一个叫 xurl 的本地小工具保管你应用的密钥，替你完成登录。

  1. 创建 X 应用在开发者控制台里创建，并开启 OAuth 2.0。
  2. 登记回调地址把 http://localhost:8080/callback 加到应用里。
  3. 复制 Client ID 和 Secret填进客户端配置的 env 部分。
  4. 启动桥接工具npx 运行 xurl，第一次运行会打开浏览器登录。

X 的文档给出了 Cursor、Claude Desktop、VS Code 等客户端的配置。把客户端的启动超时设成至少 300 秒，第一次登录才来得及完成。

在没有浏览器的服务器上，先用 xurl auth oauth2 --headless 登录。

如果登录时报 client-not-enrolled，X 给的解决办法是在控制台里把应用切到按量计费（Pay-per-use）和生产环境（Production）。

有只读的 X MCP 接法吗？

有。X 的简单接法跳过桥接工具：把应用身份的 Bearer Token 放在 Authorization 请求头里，直接发到 https://api.x.com/mcp。

X 说这种接法是只读的，“没有用户上下文”，不能以你的身份操作。它还要求客户端能自定义请求头，而大多数网页版聊天应用连接自定义服务器时走的是登录授权，用不了这种接法。

X 官方 MCP 收费吗？

收费。连接本身不花钱，但每次工具调用都是一次按量计费的 X API 调用。

X 的 MCP 页面没有单独的费用，服务器是用你的应用去调用 X API 接口。它对 client-not-enrolled 的解决办法，就是把应用切到按量计费。

2026 年 2 月 6 日按量计费上线时，@XDevelopers 就把 MCP 列在新工具里。截至 2026 年 10 月，X 价格页面上 AI 智能体最常花钱的几项：

X API 单项价格，2026 年 10 月
读取一条推文$0.005
添加一个书签$0.005
读取一个用户$0.010
获取趋势$0.010

所以一个研究时读了 1,000 条推文的智能体，要花 $5。按量计费账号每月最多读取 300 万条推文，超过之后 X 会让你转企业版。

没有每月免费额度。X 的价格页面写着：首次购买后送 $20 积分，首次自动充值再按金额送一份，最多 $50。

用 X 官方 MCP，还是托管的只读服务器？

看你的智能体要不要写入，以及你愿不愿意维护一个 X 应用。我们做的 Weir 是只读服务器，地址 https://api.weirapp.io/mcp，看这一节时请记住这一点。

X 托管的 MCP 是官方渠道：

优点

  • X 自己的服务器，适用 X 自己的条款
  • 能以你的账号管理书签和长文
  • 能搜新闻、按地区看趋势

需要注意

  • 需要你自己的开发者应用，还要本地桥接工具登录
  • 每读一条推文 $0.005，没有每月免费额度
  • 只有 X 的数据

Weir 的 MCP 用登录授权连接，不需要 X 开发者应用：

优点

  • 一个地址，什么都不用装，claude.ai 和 chatgpt.com 里都能用
  • 同一个连接还有 Reddit 工具
  • 每月 5,000 免费积分，无需绑卡

需要注意

  • 只读：不能管理书签、长文，也不能发推
  • 第三方服务，没有 X 的授权，访问方式可能会变

在 Weir 上，一次调用扣 1 积分，每条推文再扣 1 积分，X 每页大约给 20 条。所以读 1,000 条推文大约要 50 次调用，也就是 1,050 积分：

通过 MCP 读取 1,000 条 X 推文
X MCP$5.00
Weir，$5 套餐约 $0.21

按需求选：

  • 要管理书签或长文： 用 X 的 MCP。
  • 要发推、点赞或私信： 两个托管服务器都不行。X 的自托管 xmcp 代码里有这些工具。
  • 在聊天应用里做研究： 只读服务器更便宜也更快，见推特 MCP 服务器。
  • 要推特和 Reddit 一起用： 看我们的 Reddit 与 X MCP 实测（英文）。

什么时候不适合用 Weir

  • 你的智能体要往 X 里写东西。 Weir 没有写入工具，这是有意的设计。
  • 你需要 X 的条款或和 X 签合同。 Weir 和 X 没有关联。
  • 你读的是自己的账号。 X 对“自有读取”每条只收 $0.001，而且只有 X 能看到你的书签。
  • 你已经有一个付过费的 X 应用。 X 的 MCP 可以直接接上，不用再注册新账号。

常见问题

X 官方 MCP 免费吗？

连接免费，调用不免费。每次工具调用都是一次按量计费的 X API 请求，截至 2026 年 10 月，每读一条推文 $0.005。按 X 的配置说明，docs.x.com/mcp 这个文档 MCP 不需要应用。

用 X 官方 MCP 需要 X API Key 吗？

需要。两种接法都要从你自己的开发者应用开始：只读用应用身份的 Bearer Token，xurl 登录用应用的 Client ID 和 Secret。X 不支持动态客户端注册，所以绕不开应用。

X 官方 MCP 能在 Claude Code 里用吗？

X 的文档没有点名 Claude Code，列出的是 Cursor、Claude Desktop、VS Code 等客户端，并说任何兼容 MCP 的客户端都能配合 xurl 使用。这个组合我们没有亲自测过。

X 官方 MCP 能发推吗？

不能。X 托管的服务器没有发推工具，X 也对 TechCrunch 说它不支持写入 API 接口。它能写的只有书签和长文。X 自托管的 xmcp 代码里倒是有 createPosts 工具。

参考来源

以下均于 2026 年 10 月 21 日核对，均为英文页面：

继续阅读