> ## 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>