> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> 通过 Model Context Protocol (MCP) Server 让 AI 代理驱动 Ayrshare API。

<Info>
  如果你要查找的是只读的文档搜索 MCP，请参见 [Documentation MCP](/additional/mcp-server)。**本页介绍的是 Action MCP**，即让 AI 代理驱动 Ayrshare API 的 MCP。
</Info>

Ayrshare **MCP Server** 允许 AI 代理通过 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 工具来驱动 Ayrshare API。代理无需手动编写 REST 调用，而是连接到 MCP Server，并调用 Ayrshare 工具来发布内容、获取历史与分析数据、管理评论和私信、创建配置文件等。

## 工作原理

每次 MCP 工具调用都会在进程内通过为 REST API 提供支持的同一条 Ayrshare API 处理链进行分发：

<ul class="custom-bullets">
  <li>对你的 API 密钥进行身份认证。</li>
  <li>按你的套餐等级进行限流。</li>
  <li>配额与用量控制。</li>
  <li>OpenAPI 请求校验。</li>
  <li>与 REST 端点相同的控制器。</li>
</ul>

由于工具通过真实的 API 处理链运行，因此 MCP Server 返回的数据与执行的规则和 REST API 完全一致。你无需学习或维护另一套独立的行为规则。

## 适用人群

<ul class="custom-bullets">
  <li>**代理开发者**：将 LLM 代理连接到 Ayrshare API，用于发布和分析内容。</li>
  <li>**Claude Code 用户**：希望在编辑器中发布内容、获取历史和管理配置文件（参见 [Claude Code 插件](/additional/mcp-claude-code-plugin)）。</li>
  <li>**集成商**：将客户的社交账户以子配置文件的形式接入（参见 [客户接入](/additional/mcp-client-onboarding)）。</li>
</ul>

<Note>
  使用配置文件和子配置文件需要 **Business 套餐**（或 Enterprise）。请参见 [Business 套餐概览](/multiple-users/business-plan-overview)。
</Note>

## 端点与传输方式

生产环境 MCP Server 地址为：

`https://api.ayrshare.com/mcp`

它使用 **Streamable HTTP** 传输方式，并且是 **无状态的（stateless）** —— 各次调用之间无需维护会话。完整的连接和认证细节请参见 [Connect & Setup](/additional/mcp-action-connect)。

## 与 REST API 和 Documentation MCP 的关系

<ul class="custom-bullets">
  <li>**REST API** —— [Ayrshare API](/apis/overview) 是底层接口。MCP Server 会通过同一条 API 处理链来分发每个工具调用，因此其行为、规则和数据都保持一致。</li>
  <li>**Documentation MCP** —— 独立的 [Documentation MCP](/additional/mcp-server) 是一个只读服务器，用于搜索 Ayrshare 的 API 文档，它不会执行任何操作。要真正驱动 API，请使用本页所讲的 MCP Server。</li>
</ul>

## 后续步骤

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    面向任意 MCP 客户端的传输方式、端点与身份认证。
  </Card>

  <Card title="工具目录" icon="list" href="/additional/mcp-action-tools" horizontal>
    按领域分组的 27 个工具，包含作用范围与用途。
  </Card>

  <Card title="Claude Code 插件" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    为 Claude Code 安装 Ayrshare 插件。
  </Card>

  <Card title="客户接入" icon="user-plus" href="/additional/mcp-client-onboarding" horizontal>
    为客户子配置文件生成社交账户关联 URL。
  </Card>
</CardGroup>