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

> Cho phép AI agent điều khiển Ayrshare API thông qua MCP (Model Context Protocol) Server.

<Info>
  Đang tìm MCP tìm kiếm tài liệu chỉ đọc? Xem [Documentation MCP](/additional/mcp-server). **Trang này tài liệu hóa Action MCP** cho phép một AI agent điều khiển Ayrshare API.
</Info>

**MCP Server** của Ayrshare cho phép các AI agent điều khiển Ayrshare API thông qua các công cụ [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Thay vì viết các lệnh gọi REST thủ công, một agent kết nối với MCP Server và gọi các công cụ Ayrshare để xuất bản bài đăng, lấy lịch sử và phân tích, quản lý bình luận và tin nhắn trực tiếp, tạo profiles, và nhiều hơn nữa.

## Cách hoạt động

Mỗi lệnh gọi công cụ MCP được điều phối trong tiến trình qua cùng chuỗi Ayrshare API cung cấp năng lượng cho REST API:

<ul class="custom-bullets">
  <li>Xác thực API key của bạn.</li>
  <li>Giới hạn tốc độ cho bậc gói của bạn.</li>
  <li>Thực thi hạn mức và mức sử dụng.</li>
  <li>Xác thực yêu cầu OpenAPI.</li>
  <li>Cùng các controller phục vụ các endpoint REST.</li>
</ul>

Vì các công cụ chạy qua chuỗi API thực tế, MCP Server trả về cùng dữ liệu và thực thi cùng các quy tắc như REST API. Không có hành vi riêng biệt nào để học hoặc duy trì.

## Đối tượng phù hợp

<ul class="custom-bullets">
  <li>**Các nhà xây dựng agent** kết nối một LLM agent tới Ayrshare API để xuất bản và phân tích nội dung.</li>
  <li>**Người dùng Claude Code** muốn đăng bài, lấy lịch sử và quản lý profiles từ trình soạn thảo của họ (xem [Plugin Claude Code](/additional/mcp-claude-code-plugin)).</li>
  <li>**Nhà tích hợp** đưa các tài khoản mạng xã hội của khách hàng vào dưới các sub-profile (xem [Client Onboarding](/additional/mcp-client-onboarding)).</li>
</ul>

<Note>
  Làm việc với profiles và sub-profiles yêu cầu **Business Plan** (hoặc Enterprise). Xem [Tổng quan Business Plan](/multiple-users/business-plan-overview).
</Note>

## Endpoint và transport

MCP Server phiên bản production có sẵn tại:

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

Nó sử dụng transport **Streamable HTTP** và là **stateless** — không có phiên nào cần duy trì giữa các lệnh gọi. Xem [Kết nối & Thiết lập](/additional/mcp-action-connect) để biết chi tiết đầy đủ về kết nối và xác thực.

## Mối quan hệ với REST API và Documentation MCP

<ul class="custom-bullets">
  <li>**REST API** — [Ayrshare API](/apis/overview) là giao diện nền tảng. MCP Server điều phối mỗi lệnh gọi công cụ qua cùng chuỗi API đó, nên hành vi, quy tắc và dữ liệu khớp nhau.</li>
  <li>**Documentation MCP** — [Documentation MCP](/additional/mcp-server) riêng biệt là một server chỉ đọc tìm kiếm tài liệu API của Ayrshare. Nó không thực hiện các hành động. Sử dụng MCP Server (trang này) để thực sự điều khiển API.</li>
</ul>

## Các bước tiếp theo

<CardGroup cols={2}>
  <Card title="Kết nối & Thiết lập" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Transport, endpoint và xác thực cho mọi client MCP.
  </Card>

  <Card title="Danh mục Công cụ" icon="list" href="/additional/mcp-action-tools" horizontal>
    27 công cụ được nhóm theo miền, với phạm vi và mục đích.
  </Card>

  <Card title="Plugin Claude Code" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    Cài đặt plugin Ayrshare cho Claude Code.
  </Card>

  <Card title="Client Onboarding" icon="user-plus" href="/additional/mcp-client-onboarding" horizontal>
    Tạo các URL social-linking cho các sub-profile của khách hàng.
  </Card>
</CardGroup>