端点与传输方式
生产环境 MCP Server 地址为：https://api.ayrshare.com/mcp
它使用 Streamable HTTP 传输方式，并且是 无状态的（stateless） —— 各次调用之间无需维护会话。
身份认证
身份认证由为 REST API 提供支持的同一条 Ayrshare API 处理链执行。- 必填：
Authorization: Bearer YOUR_API_KEY—— 你的账户 API 密钥（涉及配置文件与子配置文件时，需要 Business 套餐的密钥）。 - 可选：
Profile-Key: YOUR_PROFILE_KEY—— 让该连接上的每一次调用都以该子配置文件为目标。 - 每次调用可选：
profileKey工具参数 —— 仅让本次工具调用以某个子配置文件为目标。
优先级：参数优先于请求头
当一次工具调用同时包含profileKey 参数 和 连接上的 Profile-Key 请求头时，本次调用的 profileKey 参数优先生效。只有在未提供有效参数时，才会使用请求头。
一个例外：在 get_platform_history 和 get_social_network_analytics 上，X/Twitter 的 userId / userName 查询必须仅使用账户 API 密钥；此时如果传入 profileKey 参数或 Profile-Key 请求头，会返回 400 错误。
MCP 的
initialize 和 tools/list 方法可以在 认证之前 访问 —— 它们只返回元数据，不会执行任何操作。所有工具调用都必须经过认证。认证错误
在工具调用中使用未认证或无效的密钥，会返回 Ayrshare error 403 / code 102，错误信息为 “API Key not valid”。根据 MCP 规范，工具执行错误以带内（in-band）方式返回：工具结果携带isError: true 及该错误信息，而 MCP 传输本身返回 HTTP 200。（403 / 102 是 Ayrshare 的应用层错误，而非传输层状态。）
连接
方式 A：Claude Code 插件
如果你使用 Claude Code，可以安装 Ayrshare 插件。该插件已内置 MCP Server 配置、初始化命令、代理、技能以及确认钩子。完整安装步骤请参见 Claude Code 插件 页面。方式 B：任意 MCP 客户端
对于任何支持 Streamable HTTP 的 MCP 客户端，可以直接注册服务器。在 Claude Code 中：Profile-Key 请求头：
X/Twitter 自带（BYO）凭据
从 2026 年 3 月 31 日起，通过 Ayrshare 进行的 X/Twitter 操作要求使用你自己的 OAuth 1.0a 凭据。当工具调用目标是 X/Twitter 时，请在连接中随Authorization（以及可选的 Profile-Key）请求头一起附加以下两个请求头：
| 请求头 | 说明 |
|---|---|
X-Twitter-OAuth1-Api-Key | 你的 OAuth 1.0a API Key（Consumer Key） |
X-Twitter-OAuth1-Api-Secret | 你的 OAuth 1.0a API Key Secret（Consumer Secret） |
连接时同时配置 BYO 请求头
如需从一开始就配置 X/Twitter BYO 凭据，请在添加服务器时同时提供两个 OAuth 1.0a 请求头与Authorization 请求头（如需每次调用都以某个子配置文件为目标，也请一并附上 Profile-Key）：
为已有连接补充 BYO 请求头
连接的请求头在添加服务器时就已固定，因此如果你之前连接时没有携带 BYO 请求头，需要先移除服务器，然后重新添加并提供完整的请求头集合（重新包含你之前已经使用的任何请求头，例如Profile-Key）：
后续步骤
工具目录
按领域分组的 27 个工具，包含作用范围与用途。
Claude Code 插件
为 Claude Code 安装 Ayrshare 插件。