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

# n8n

> Tích hợp API mạng xã hội Ayrshare vào các quy trình làm việc n8n của bạn để xuất bản, lên lịch và phân tích các tài khoản mạng xã hội của người dùng.

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

## Tổng quan

[n8n](https://n8n.io) là một nền tảng tự động hóa quy trình làm việc cho phép bạn kết nối các ứng dụng và điều phối các quy trình, bao gồm cả AI agent, trên Cloud hoặc tự lưu trữ.

API mạng xã hội Ayrshare có thể được tích hợp vào các quy trình làm việc n8n của bạn để quản lý các tài khoản mạng xã hội của người dùng. Một lệnh gọi API sẽ xuất bản lên Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat và X, vì vậy bạn không phải viết hoặc duy trì mã API cho từng nền tảng.

Có hai cách để kết nối:

<ul class="custom-bullets">
  <li>**Máy chủ MCP (điều khiển bởi agent).** Đính kèm [Máy chủ MCP Ayrshare](/additional/mcp-action-server) với node MCP Client Tool tích hợp sẵn của n8n, và AI Agent của bạn có thể chạy toàn bộ vòng lặp tự động: soạn thảo bài đăng, xác thực nó theo quy tắc của mỗi mạng, xuất bản hoặc lên lịch, sau đó đọc lại phân tích. Không có gì để lưu trữ và không có community node nào để cài đặt.</li>
  <li>**API REST (quy trình làm việc cố định).** Đối với các quy trình làm việc xác định, không phải agent, hãy gọi [API REST Ayrshare](/apis/overview) trực tiếp từ một node HTTP Request.</li>
</ul>

Việc quản lý tài khoản mạng xã hội của người dùng yêu cầu [gói Business](/multiple-users/business-plan-overview), nhưng bạn có thể tương tự quản lý tài khoản mạng xã hội của riêng mình với gói Premium bằng cách chỉ sử dụng [API Key](/apis/overview#authorization) trong header của yêu cầu.

## Cách kết nối

Với đường dẫn MCP, node **AI Agent** là bộ não. Sub-node **MCP Client Tool** đính kèm với nó, kết nối với Máy chủ MCP Ayrshare, khám phá các công cụ có sẵn và cung cấp chúng cho agent. Khi agent hành động, node điều phối lệnh gọi đến Ayrshare, sau đó xuất bản lên các mạng.

```
Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  social networks
```

<Note>
  Sử dụng phương thức truyền tải **HTTP Streamable**, không phải SSE. [Hướng dẫn n8n](/additional/mcp-n8n) đề cập chi tiết đến phương thức truyền tải, xác thực và thiết lập.
</Note>

## Hướng dẫn

Hướng dẫn n8n đầy đủ đề cập đến đường dẫn ưu tiên MCP từ đầu đến cuối: điều kiện tiên quyết, thiết lập node MCP Client Tool, system prompt ưu tiên xác thực, các ví dụ đã thực hiện (soạn thảo và xuất bản từ một tin nhắn trò chuyện, tự động xuất bản nội dung mới, một bản tóm tắt phân tích hàng tuần), hành động thay mặt cho khách hàng với sub-profile, giữ con người trong vòng lặp, dự phòng REST và khắc phục sự cố.

<Card title="Hướng dẫn n8n + MCP Ayrshare" icon="book-open" href="/additional/mcp-n8n" horizontal>
  Kết nối AI Agent của n8n với Máy chủ MCP Ayrshare để xuất bản, lên lịch và phân tích trên các mạng xã hội của bạn, mà không cần mã API cho từng nền tảng.
</Card>

<Card title="Tải xuống quy trình làm việc khởi đầu n8n" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  Một quy trình làm việc sẵn sàng để import: Chat Trigger, AI Agent, một mô hình chat Anthropic và node MCP Ayrshare được cấu hình sẵn với system prompt ưu tiên xác thực.
</Card>

## Đăng bài lên X (trước đây là Twitter)

<XByoNotice />

Trong n8n, chuyển **Authentication** của node MCP Client Tool sang **Multiple Headers** và thêm hai header `X-Twitter-OAuth1-*` cùng với `Authorization`. Xem [Kết nối & Thiết lập → thông tin đăng nhập BYO X/Twitter](/additional/mcp-action-connect#xtwitter-byo-credentials).

## Tìm hiểu thêm

<ul class="custom-bullets">
  <li>Tìm hiểu thêm về [n8n](https://n8n.io) và các node [AI Agent](https://docs.n8n.io/advanced-ai/) và [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/) của nó.</li>
  <li>Xem [tổng quan Máy chủ MCP](/additional/mcp-action-server) để biết máy chủ là gì và cách nó ánh xạ với API Ayrshare.</li>
  <li>Duyệt [Danh mục Công cụ](/additional/mcp-action-tools) để biết các công cụ mà agent của bạn có thể gọi, được nhóm theo miền.</li>
  <li>Đọc [Kết nối & Thiết lập](/additional/mcp-action-connect) để biết chi tiết về điểm cuối, truyền tải, xác thực và nhắm mục tiêu profile.</li>
</ul>