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

# n8n

> Ayrshare ソーシャルメディア API を n8n ワークフローに統合し、ユーザーのソーシャルメディアアカウントを公開、スケジュール、分析します。

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

## 概要

[n8n](https://n8n.io) は、アプリを接続し、AI エージェントを含むプロセスをクラウドまたはセルフホストでオーケストレーションできるワークフロー自動化プラットフォームです。

Ayrshare ソーシャルメディア API を n8n のワークフローに統合することで、ユーザーのソーシャルメディアアカウントを管理できます。1 回の API 呼び出しで Facebook、Instagram、LinkedIn、YouTube、TikTok、Pinterest、Reddit、Threads、Bluesky、Telegram、Google Business Profile、Snapchat、X に投稿できるため、プラットフォームごとの API コードを書いたり保守したりする必要はありません。

接続方法は 2 つあります:

<ul class="custom-bullets">
  <li>**MCP サーバー(エージェント駆動)。** [Ayrshare MCP Server](/additional/mcp-action-server) を n8n 組み込みの MCP Client Tool ノードにアタッチすると、AI Agent がループ全体を単独で実行できます: 投稿の下書き作成、各ネットワークのルールに対する検証、公開またはスケジュール、そしてアナリティクスの読み取り。ホストするものやコミュニティノードのインストールは不要です。</li>
  <li>**REST API(固定ワークフロー)。** 決定論的な、エージェント以外のワークフローには、HTTP Request ノードから [Ayrshare REST API](/apis/overview) を直接呼び出します。</li>
</ul>

ユーザーのソーシャルアカウントの管理には [Business plan](/multiple-users/business-plan-overview) が必要ですが、自分自身のソーシャルアカウントの管理も同様に、リクエストヘッダーに [API Key](/apis/overview#authorization) を含めるだけで、Premium プランで可能です。

## 接続の仕組み

MCP パスでは、**AI Agent** ノードが頭脳です。**MCP Client Tool** サブノードがこれにアタッチされ、Ayrshare MCP Server に接続し、利用可能なツールを検出してエージェントに公開します。エージェントが行動すると、ノードは呼び出しを Ayrshare にディスパッチし、Ayrshare がネットワークに公開します。

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

<Note>
  SSE ではなく **HTTP Streamable** transport を使用してください。[n8n ガイド](/additional/mcp-n8n) では、transport、認証、セットアップについて詳しく説明しています。
</Note>

## ガイド

完全な n8n ガイドでは、MCP を第一選択とするパスをエンドツーエンドでカバーしています: 前提条件、MCP Client Tool ノードのセットアップ、validate-first システムプロンプト、実例(チャットメッセージから下書き作成と公開、新規コンテンツの自動公開、週次アナリティクスダイジェスト)、サブプロファイルによるクライアント代行、Human-in-the-Loop の維持、REST フォールバック、トラブルシューティング。

<Card title="n8n + Ayrshare MCP Guide" icon="book-open" href="/additional/mcp-n8n" horizontal>
  n8n の AI Agent を Ayrshare MCP Server に接続し、プラットフォーム固有の API コードなしで、ソーシャルネットワーク全体で公開、スケジュール、分析を行います。
</Card>

<Card title="n8n スターターワークフローをダウンロード" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  インポートしてすぐ使えるワークフロー: Chat Trigger、AI Agent、Anthropic チャットモデル、validate-first システムプロンプトが事前配線された Ayrshare MCP ノード。
</Card>

## X (旧 Twitter) への投稿

<XByoNotice />

n8n では、MCP Client Tool ノードの **Authentication** を **Multiple Headers** に切り替え、`Authorization` と一緒に 2 つの `X-Twitter-OAuth1-*` ヘッダーを追加します。[Connect & Setup → X/Twitter BYO credentials](/additional/mcp-action-connect#xtwitter-byo-credentials) を参照してください。

## さらに学ぶ

<ul class="custom-bullets">
  <li>[n8n](https://n8n.io) とその [AI Agent](https://docs.n8n.io/advanced-ai/) および [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/) ノードについて詳しく学びましょう。</li>
  <li>サーバーの概要と Ayrshare API へのマッピングについては、[MCP Server 概要](/additional/mcp-action-server) を参照してください。</li>
  <li>エージェントが呼び出せるツール(ドメイン別にグループ化)については、[Tool Catalog](/additional/mcp-action-tools) を参照してください。</li>
  <li>エンドポイント、transport、認証、プロファイルターゲティングの詳細については、[Connect & Setup](/additional/mcp-action-connect) を参照してください。</li>
</ul>