开源发现

X开发者平台已经把 AI Agent作为一类正式使用场景来支持。最新的官方文档中，X提供了两个面向 MCP客户端的服务：一个是用于调用 X API的 X MCP，另一个是用于查询 X API文档的 Docs MCP。对于正在使用 Cursor、Claude、VS Code、Grok Build、Codex等工具的开发者来说，这意味着 AI助手不再只能根据旧文档或复制粘贴的上下文写代码，而是可以在授权后直接检索 X数据、查询用户、读取趋势和新闻，并根据官方文档补全接口细节。

需要先提醒的是，X MCP调用的是 X API资源，本质上会走 X API的计费体系。X官方文档明确写明 X API使用 pay-per-use计费方式，也就是按实际使用量付费，而不是免费公共接口。开发者在把 MCP接入 AI工具前，应该先确认自己的 X Developer Console账户、应用权限、用量额度和费用监控，避免让 Agent在自动化任务中产生超出预期的 API成本。

图片来源：github.com

X MCP的服务地址是 https://api.x.com/mcp。官方描述中，它是一个 hosted Streamable HTTP MCP server，但实际接入时通常并不是直接把这个地址填进客户端就结束。因为 X的用户授权依赖 OAuth，官方推荐通过开源的 xurl mcp作为本地授权桥接。这个桥接会负责 OAuth登录、保存并刷新 token，然后把带有权限的请求转发给 X MCP。

X MCP暴露的能力覆盖了很多真实的 X使用场景，包括搜索帖子、完整归档搜索、用户搜索、新闻搜索、根据 ID或用户名查询用户、读取用户帖子、时间线和提及、管理书签和书签文件夹、按地区获取趋势、获取新闻故事，以及创建和发布 Articles。换句话说，它更像是把 X API包装成一组可被 AI Agent调用的工具，而不是单纯的文档检索入口。

另一个 Docs MCP地址是 https://docs.x.com/mcp。它的定位更轻量，主要用于搜索和读取 X API文档。开发者可以把它和 X MCP一起配置：前者负责让 AI查询接口说明、参数和示例，后者负责在授权范围内调用真实 API。对写脚本、做数据分析、自动生成内容草稿或构建社媒运营工具的人来说，这种组合会比手动查文档更顺畅。

使用 X MCP前，需要先准备一个 X Developer App，并在应用里拿到 CLIENT_ID和 CLIENT_SECRET。如果只需要只读能力，也可以使用 App-only Bearer Token的方式直接连接 https://api.x.com/mcp，但这种方式没有用户上下文，不能代替用户执行书签、Articles等写入类操作。只要涉及“以我的账号执行操作”，就应该使用 xurl mcp的 OAuth 2.0路线。

以通用 MCP客户端为例，最常见的配置思路是让客户端启动 npx，并通过 xurl连接 X MCP：

command: npx args: -y @xdevplatform/xurl mcp https://api.x.com/mcp env: CLIENT_ID=你的 X App Client ID，CLIENT_SECRET=你的 X App Client Secret

在 Cursor中，可以把类似配置写入全局的 ~/.cursor/mcp.json，或者写入当前项目的 .cursor/mcp.json。Claude Desktop可以写入 claude_desktop_config.json。VS Code的 Agent或 Copilot MCP配置可以写入 .vscode/mcp.json。第一次调用工具时，xurl会打开浏览器完成 X OAuth登录，授权完成后会缓存并自动刷新 token。

如果还想让 AI同时查询 X API文档，可以再添加一个 Docs MCP：

x-docs url: https://docs.x.com/mcp

这样配置后，AI助手可以先通过 Docs MCP查接口说明，再通过 X MCP执行实际操作。开发者在提示词里可以明确限制工具边界，例如只允许查询趋势和搜索帖子，不允许发布 Articles或修改书签。由于 MCP工具会让模型获得更强的外部操作能力，建议在团队环境中配合最小权限、人工确认和费用监控一起使用。

图片来源：github.com

如果你使用 OpenAI Codex，也可以把它作为调试和集成这类 MCP配置的开发环境。Codex CLI是 OpenAI的本地终端编码 Agent，可以读取、修改并运行当前目录中的代码。安装方式很简单，在 macOS或 Linux上可以使用官方安装脚本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装完成后，在项目目录里运行：

codex

首次运行时，Codex会要求登录，可以使用 ChatGPT账号或 API Key。进入交互界面后，可以让 Codex帮你创建 MCP配置文件，例如：“在这个项目中添加 X MCP和 Docs MCP配置，使用 xurl mcp，并把 CLIENT_ID与 CLIENT_SECRET从环境变量读取。”如果是在 VS Code、Cursor或 Windsurf中使用 Codex IDE扩展，也可以让它直接修改 .cursor/mcp.json或 .vscode/mcp.json，并解释每一项配置的作用。

一个实际工作流可以这样安排：先在 X Developer Console创建应用并确认计费方式；然后在本机安装或通过 npx调用 xurl；接着用 Codex生成 MCP配置文件；最后在 Cursor、Claude、VS Code或其他 MCP客户端中启动工具并完成浏览器 OAuth授权。验证通过后，再让 AI执行低风险查询任务，例如搜索某个关键词的近期帖子、查询账号资料、读取趋势或检索 X API文档。

对于开发者来说，X官方 MCP的价值不只是“多了一个接口入口”，而是让 X API进入了 AI编程工具的可调用工具层。它适合用来做舆情监测、趋势跟踪、账号分析、内容草稿生成、数据检索和文档问答。但它也带来两个必须认真对待的问题：第一，AI调用真实 API会消耗 X API费用；第二，OAuth授权后工具可能拥有用户账号权限。因此，正式使用前一定要限制 scope、确认客户端配置、检查账单监控，并避免把高权限账号直接交给未经审查的自动化任务。

图片来源：github.com