X API 和 X 开发者文档的 MCP 服务器 - X

什么是 X API 和 X 开发者文档的 MCP 服务器

X API 和 X 开发者文档的 MCP 服务器是 X（前身为 Twitter）提供的官方开发者资源，旨在将 AI 代理和编码助手与 X 平台集成。通过利用模型上下文协议（Model Context Protocol, MCP），这些服务器允许 Grok、Cursor、Claude 和 VS Code 等 AI 工具直接连接到 X 的基础设施。这种集成使模型能够代表用户执行操作或以编程方式访问文档，从而弥合生成式 AI 工作流与社交媒体数据之间的差距。

该工具是 X 更广泛的“代理资源”（Agent Resources）倡议的一部分，旨在促进能够在 X 生态系统中运行的自主代理的开发。该解决方案由两个独立的托管服务器组成：一个用于与 X API 端点交互，另一个用于搜索和阅读 X 开发者文档。两者均可通过标准 MCP URL 访问，简化了构建 AI 驱动应用的开发者的连接过程。

主要功能

该产品提供两个主要的服务器实例，每个实例具有特定的功能：

1. X MCP（API 交互）

此服务器将 AI 工具连接到 X API，允许模型使用经过身份验证的用户账户执行操作。关键功能包括：

• 帖子管理： 获取帖子，查看点赞者/转发者/引用者，并检索近期计数。
• 搜索： 执行全归档帖子搜索、用户搜索和新闻搜索。
• 用户解析： 按 ID 或用户名查找用户，读取时间线，并查看提及内容。
• 书签： 列出、添加和删除书签，包括书签文件夹的管理。
• 新闻与趋势： 使用 WOEID 检索特定地点的新闻故事和热门话题。
• 文章： 直接通过 AI 界面起草并发布文章。

2. Docs MCP（文档访问）

此服务器允许 AI 工具搜索和阅读 X API 文档。它作为开发者和代理的知识库，确保他们无需手动浏览即可访问最新的技术规范和指南。

技术实现

• 托管服务器： 两个服务器均由 X 托管，减少了对自托管基础设施的需求。API 服务器位于 https://api.x.com/mcp，文档服务器位于 https://docs.x.com/mcp。
• 协议支持： 利用模型上下文协议（具体为协议版本 2025-06-18），确保与广泛范围的 MCP 兼容客户端的兼容性。
• 认证灵活性： 支持两种操作模式：
  • 简单（仅应用 Bearer 令牌）： 使用应用 Bearer 令牌进行只读访问。适用于不需要用户上下文的场景。
  • 完整（OAuth 2.0 用户上下文）： 需要本地桥接器（xurl mcp）来处理 OAuth 2.0 PKCE 登录。此模式允许 AI 代表用户行事，访问个人数据并执行写操作。
• 桥接机制： 对于完整的用户上下文访问，系统使用开源的 xurl 桥接器。该桥接器处理 OAuth 认证、管理令牌刷新，并在每次调用时注入新的 Bearer 令牌。它通过 npm 启动器（npx）运行，消除了复杂安装步骤的需要。

使用案例

这些 MCP 服务器为开发者和 AI 爱好者启用了几个强大的工作流程：

• 自主社交媒体代理： 开发者可以构建监控趋势、搜索特定关键词并根据实时数据起草回复或文章的 AI 代理。例如，一个代理可以跟踪新闻趋势并自动生成草稿文章以供发布。
• 增强的编码助手： IDE（如 Cursor 和 VS Code）可以利用 Docs MCP，在开发者构建 X 集成应用时提供上下文感知的辅助。AI 可以直接在编码环境中引用官方文档。
• 数据分析与研究： 研究人员可以使用 API MCP 从 X 归档中提取大型数据集进行分析。以编程方式搜索全归档和解析用户详细信息的功能促进了全面的社交媒体研究项目。
• 个性化 AI 助手： 用户可以将他们的个人 X 账户连接到 AI 工具，允许助手根据用户的偏好管理书签、检查通知或总结时间线。

有关将 AI 工具与外部 API 集成的更多信息，请探索我们的 AI 集成模式指南。

定价概览

源材料未指定 MCP 服务器本身的明确货币定价层级。但是，它强调了重要的成本和访问考虑因素：

• 服务器访问： 托管的 MCP 服务器似乎是作为开发者资源提供的。访问 API 端点通常需要 X 开发者账户，这可能会根据层级（Basic、Pro、Enterprise）产生相关的订阅费用。这些层级通过 X 开发者门户单独管理。
• 基础设施成本： “简单”路线除了 MCP 客户端外不需要额外的基础设施。“完整”路线需要通过 npx 运行本地桥接器，这是免费的，但在用户的本地机器上运行。
• 速率限制： 与所有 X API 访问一样，使用受开发者账户层级定义的速率限制约束。开发者应在 X 开发者控制台 上验证当前的速率限制结构。

建议查阅官方 X API 定价页面 以获取有关开发者账户订阅的最新信息。

谁应该使用它

该工具主要面向：

• AI 应用开发者： 构建需要以编程方式与 X 的数据或文档交互的代理或工具的开发者。
• 软件工程师： 使用 Cursor 或 VS Code 等 IDE 并希望获得 AI 辅助访问 X API 参考的开发者。
• 数据科学家： 需要以编程方式访问 X 的公共数据进行研究和分析的专业人士。
• 高级用户： 乐于设置本地 OAuth 桥接器并希望借助 AI 自动化个人 X 交互的个人。

如果您正在寻找预建的集成而不是原始 API 访问，请查看我们的 流行 X AI 工具列表 以获取替代方案。

评估上下文

入职流程： 入职过程因身份验证方法而异。对于简单的 Bearer 令牌方法，用户将令牌粘贴到 MCP 客户端配置中。对于完整的 OAuth 体验，用户必须安装 xurl 桥接器并通过 npx 运行它。首次运行会触发基于浏览器的 OAuth2 登录，之后令牌会被缓存并自动刷新。这种简化的本地设置减少了开发者的摩擦。

集成注意事项： 开发者必须确保其 AI 客户端支持模型上下文协议。已确认与 Grok、Cursor、Claude 和 VS Code 兼容。由于依赖本地桥接器进行用户上下文访问，因此桥接器必须在会话期间保持运行。需要连接到 api.x.com 和 docs.x.com 的网络连接。

数据与隐私： 使用“完整”OAuth 模式会将用户的 X 账户数据（包括书签、帖子和趋势）授予 AI 工具。用户应审查在 OAuth 流程中授予的权限。xurl 桥接器在本地处理令牌安全性，但用户负责保护其本地环境。数据隐私政策由 X 的服务条款和特定 AI 工具的隐私设置管辖。

定价验证清单：

• 确认 API 访问所需的 X 开发者账户层级要求。
• 验证 MCP 服务器是否除标准 API 使用费外还收取额外费用。
• 检查 MCP 特定端点的速率限制是否有任何变化。
• 确保安装了本地桥接器依赖项（npm、node）。

比较标准： 将此解决方案与其他 X API 集成进行比较时，请考虑：

• 协议标准化： 该工具是否使用 MCP 以便更容易集成 AI？
• 认证复杂性： OAuth 是自动处理还是手动处理？
• 功能范围： 它是否同时提供 API 访问和文档搜索？
• 设置简便性： 是否需要本地依赖项？

要了解可用 AI 工具的更全面视图，请浏览我们的 工具排名。

常见问题

问：哪些 AI 工具与这些 MCP 服务器兼容？ 答：任何 MCP 兼容的 AI 工具都可以连接，包括 Grok Build、Cursor、Claude 和 VS Code。

问：X MCP 服务器的身份验证如何工作？ 答：有两个选项：用于只读访问的简单仅应用 Bearer 令牌，或通过 xurl 桥接器进行的完整 OAuth 2.0 PKCE 流程，用于用户上下文操作。

问：我需要安装任何东西来使用桥接器吗？ 答：不需要单独安装。桥接器通过 npm 启动器使用 npx 运行。

问：AI 工具可以起草和发布文章吗？ 答：是的，X MCP 服务器允许模型使用连接的 X 账户创建草稿并发布文章。

问：我在哪里可以找到文档索引？ 答：完整的文档索引可以从 X API 文档站点的 /llms.txt 获取。

问：使用托管的 MCP 服务器有费用吗？ 答：服务器由 X 托管，但适用标准的 X 开发者 API 访问和潜在的订阅层级。源材料中未详细说明具体的服务器成本。