n8n

n8n はツール同士を連携させる場所です。Ayrshare は、Facebook、Instagram、LinkedIn、YouTube、TikTok、Pinterest、Reddit、Threads、Bluesky、Telegram、Google Business Profile、Snapchat、X へ単一の呼び出しで投稿できる 1 つの API です。これらを Ayrshare MCP Server で接続すれば、n8n の AI エージェントがループ全体を自律的に実行できます。投稿の下書き、各ネットワークのルールに対する検証、公開またはスケジュール、そして分析結果の取得までを一貫して行えます。

キャンバス上の n8n スターターワークフロー: チャットトリガーから AI エージェントへ、その下に Anthropic チャットモデルと Ayrshare MCP ツールノードが接続され、セットアップと使用方法の付箋が付いています。

MCP Server はホスト型の Streamable HTTP エンドポイントであるため、n8n の組み込み MCP Client Tool ノードで接続できます。ホスティング、カスタムコード、コミュニティノードのインストールは不要です。1 つのノードを 1 つの URL に向けるだけで、エージェントは 27 個すべてのソーシャルツールを利用できるようになります。

n8n スターターワークフローをダウンロード

上に示したワークフローをインポート可能な形式で提供: Chat Trigger、AI Agent、Anthropic チャットモデル、そして validate-first システムプロンプト付きの Ayrshare MCP ノードが事前配線されています。

使用方法: n8n で Workflows → Import from file を選択し、JSON を選択して、必要な 2 つの資格情報（Ayrshare キーを保持する Bearer Auth 資格情報と、Anthropic API 資格情報）を作成します。資格情報を接続すると、2 つの警告バッジは解消されます。セルフホストのインスタンスでは、api.ayrshare.com と使用するモデルプロバイダーへのアウトバウンドアクセスが必要です。このガイドでは MCP を最初に使用するパスをエンドツーエンドで解説します。固定的な非エージェントワークフローを構築したい場合は、末尾に短い REST フォールバックを用意しています。

API 呼び出しを書くのではなく MCP を使用する理由

Ayrshare の REST API は HTTP Request ノードから直接呼び出すこともでき、固定的で予測可能なワークフローには最適です。ただし、ループに LLM が入る場合には MCP Server の真価が発揮されます。

エージェントがツールを選択します。 目標を説明する（「これをビジネスチャネルに投稿し、フォローアップを火曜日にスケジュールして」）だけで、エージェントは validate_post、create_post、そして適切なパラメータを自分で選択します。
公開前に検証します。 validate_post は、各プラットフォームの長さ、フォーマット、メディアのルールに対してコンテンツをドライラン検証するため、エージェントはネットワークが拒否する投稿を送信しません。
1 回の呼び出しで多くのネットワークに投稿。 単一の create_post で、リンクされたすべてのプラットフォームに配信されます。
プラットフォームの変更は Ayrshare の責任範囲。 ネットワークが API を変更した場合、Ayrshare が統合を維持するため、ワークフローは動作し続けます。
REST API と同じルール。 すべての MCP ツール呼び出しは、同じ Ayrshare API チェーンをインプロセスで実行します。認証、レート制限、クォータ、検証はすべて同じです。個別に学ぶべき動作はありません。

接続の仕組み

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

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

エンドポイント、トランスポート、認証の詳細については、Connect & Setup を参照してください。完全なツールリストについては、Tool Catalog を参照してください。

前提条件

AI Agent と MCP Client Tool ノードを備えた最新バージョンの n8n インスタンス（Cloud またはセルフホスト）。MCP Client Tool ノードは組み込みです。Ayrshare サーバーは Streamable HTTP を話すため、コミュニティノードは必要ありません。
Ayrshare アカウントと API キー（Dashboard → Settings → API Key）、または無料トライアルを開始してください。
Ayrshare に 少なくとも 1 つのソーシャルアカウントがリンクされていること。エージェントは接続されているところにのみ投稿できます。
AI Agent ノード用の チャットモデル資格情報（Anthropic、OpenAI など）。
(オプション) サブプロファイル経由で複数のクライアントを管理する場合、Business または Enterprise Plan。

MCP Client Tool ノードのセットアップ

AI Agent ノードを追加します

ワークフローを開くか新規作成し、AI Agent ノード（Advanced AI ノードの下）を追加します。

MCP Client Tool ノードを接続します

AI Agent ノードで、Tool コネクタをクリックし、MCP Client Tool ノードを追加します。次のように構成します。

フィールド	値
Endpoint	`https://api.ayrshare.com/mcp`
Server Transport	`HTTP Streamable`
Authentication	`Bearer Auth`
Tools to Include	`All`（または特定のツールのみを公開する場合は `Selected`）

Ayrshare キーを Bearer 資格情報として追加します

Credential で、新しい Bearer Auth 資格情報を作成し、Ayrshare API キーをトークンとして貼り付けます。n8n はこれを Authorization: Bearer YOUR_API_KEY として送信します。保存すると、n8n が接続し、27 個のツールがリスト表示されます。

チャットモデルとシステムプロンプトを配線します

Chat Model サブノードを接続し、モデル資格情報を選択します。エージェントにルールを設定するシステムプロンプトを与えます。例:

あなたは Ayrshare ツールにアクセスできるソーシャルメディアアシスタントです。何かを公開する前に、必ず最初に validate_post を呼び出し、問題があれば報告してください。検証が通過した後にのみ create_post を呼び出してください。ユーザーが指定するプラットフォームをデフォルトとします。指定がない場合は尋ねてください。メディア URL を作り出さず、ユーザーが提供した URL のみを使用し、疑わしい場合は validate_media で確認してください。

トリガーを追加します

テストには Manual Trigger または Chat Trigger が最も簡単です。本番環境では、ワークフローを起動するもの（スケジュール、webhook、フォーム、シートの新しい行）を使用してください。

SSE ではなく HTTP Streamable を使用してください。 Ayrshare MCP Server は最新の Streamable HTTP トランスポートを使用し、ステートレスです。n8n の SSE オプションは非推奨で、サーバーは SSE ストリームを拒否します。常に HTTP Streamable を選択してください。

ツールサーフェス

エージェントは 1 つの MCP ノードを介して 27 個すべてのツールを見ることができます。名前で呼び出すことはほとんどなく、意図を説明するとエージェントが選択します。ドメインは Posts、History、Analytics、Comments、Messages、Profiles、Media、Generate、Webhooks、Errors です。各ツールの目的とスコープを含む完全なリストについては、Tool Catalog を参照してください。安全性の観点で 2 つが特に重要です: validate_post は create_post と同じ入力で投稿をドライラン実行しますが、何も公開しません。explain_error は Ayrshare のあらゆるエラーコードを平易な英語での原因と修正方法に変換するため、エージェントは自己診断できます。

例 1: チャットメッセージから下書き、検証、公開

この統合の「hello world」です。チャットメッセージまたはフォームでワークフローをトリガーし、あとはエージェントに任せます。

トリガー: Chat Trigger（または「何を投稿しますか?」フィールドを持つ Form Trigger）。
エージェントへのプロンプト: 「新しいアナリティクスダッシュボードの親しみやすいローンチ告知を書いて、LinkedIn、Facebook、Instagram に公開してください。先に検証してください。」

エージェントが自律的に行うこと: コピーと 3 つのプラットフォームで validate_post を呼び出します。Instagram が画像不足を指摘した場合、静かに失敗するのではなく通知します。検証が通過すると create_post を呼び出し、公開された投稿の URL を返します。検証が最初に実行されるため、公開前に問題を発見できます。

例 2: 新しいコンテンツを自動的にチャネル全体に公開

コンテンツソースをそのままマルチネットワーク投稿に変換します。

トリガー: ブログフィードの RSS Read ノード、CMS からの webhook、または Google Sheets や Airtable の新しい行。
AI Agent ステップ: 「この記事を関連するハッシュタグ 2 〜 3 個付きの短いソーシャル投稿に要約し、検証してから LinkedIn、Facebook、Threads に公開してください。」
必要に応じて、create_post ステップの前に human-in-the-loop 承認を追加し、人が承認してから公開するようにします。

データ駆動型のタグには recommend_hashtags を、コピーをチャットモデルではなく Ayrshare に下書きさせたい場合は generate_post を活用できます。

例 3: 週次アナリティクスダイジェスト

ループを逆方向に実行します: パフォーマンスを読み取り、レポートします。

トリガー: Schedule ノード、たとえば毎週月曜日午前 8 時。
AI Agent ステップ: 「LinkedIn、Instagram、Facebook について先週のアカウントアナリティクスを取得し、エンゲージメント別のトップ 3 投稿を要約してください。」
エージェントは、アカウントレベルの数値には get_social_network_analytics を、個々の投稿には get_post_analytics を使用します。その後、要約を Slack、Gmail、または Notion ノードにパイプします。

頻度に関する注意点: ほとんどの投稿は最初の 24 時間でエンゲージメントの大部分を獲得し、メトリクスは秒単位で更新されるわけではありません。日次または週次のスケジュールで十分です。数分ごとにアナリティクスをポーリングしないでください。新しいデータもないのにレート制限に達するだけです。

クライアントに代わって行動する（マルチテナント）

複数のクライアントのソーシャルを管理する場合、Ayrshare のプロファイルにより、1 つのアカウントから多数の別々のリンク済みアカウントセットに投稿できます。Business または Enterprise Plan では、n8n からクライアントをターゲットにする 2 つの方法があります。

接続ごと: MCP Client Tool ノードに Profile-Key ヘッダーを追加します（Multiple Headers 認証を使用して Authorization と Profile-Key の両方を送信できます）。そのノードでのすべての呼び出しがそのクライアントとして動作します。1 つのワークフローが 1 つのクライアントに対応する場合に適しています。
呼び出しごと: 多くのツールは profileKey 引数を受け付け、エージェントはアクションごとに設定できます。両方が存在する場合、呼び出しごとの引数が優先されます。1 つのワークフローがクライアント間をルーティングする場合に適しています。

新しいクライアントをオンボーディングするには、エージェントが create_profile を呼び出し、続いて generate_jwt_social_linking_url を呼び出して、クライアントが自分のアカウントをリンクするホスト型ページを生成できます。ワークフローを経由して資格情報が渡されることはありません。

X/Twitter への投稿

n8n では、MCP Client Tool ノードの Authentication を Multiple Headers に切り替え、Authorization と一緒に 2 つの X-Twitter-OAuth1-* ヘッダーを追加します。これは Ayrshare アカウントごとに 1 回限りのセットアップで、同じキーペアがすべてのプロファイルに適用されます。他のすべて（Facebook、Instagram、LinkedIn、YouTube、TikTok など）については、追加のヘッダーは不要です。Connect & Setup → X/Twitter BYO credentials を参照してください。

ヒューマンインザループを維持する

MCP ツールを使えばエージェントが公開するのは簡単になるため、まさにそれをゲートで管理すべきです。安価な 2 つの安全策があります。

常に最初に検証します。 「create_post の前に validate_post を呼び出す」をシステムプロンプトに組み込みます。検証は何も公開せず、プラットフォームルール違反を早期に検出します。
承認ステップを追加します。 下書きと公開アクションの間に n8n の Send and Wait for Response（Slack またはメール）ノードを挿入し、公開前に人が承認するようにします。スケジュールされたコンテンツの場合、エージェントは update_post を使用して承認待ちの投稿を修正できます。

REST フォールバック（エージェントなし）

LLM なしで固定的・決定的なワークフローを構築したい場合は、MCP をスキップし、HTTP Request ノードで REST API を呼び出します。

Method: POST
URL: https://api.ayrshare.com/api/post
Authentication: Header Auth、Authorization: Bearer YOUR_API_KEY

{
  "post": "Excited to announce our new feature!",
  "platforms": ["facebook", "linkedin", "instagram"],
  "mediaUrls": ["https://example.com/image.jpg"],
  "scheduleDate": "2026-07-01T10:00:00Z"
}

ダッシュボードホスト app.ayrshare.com ではなく、API ホスト api.ayrshare.com を使用してください。（app.ayrshare.com は API 呼び出しを受け付けますが、ドキュメント化されたエンドポイントではなく、断続的な 502/504 ゲートウェイエラーを返す可能性があるため、常に api.ayrshare.com を使用してください。）同じパターンが他の REST エンドポイントにも当てはまります。これは、ワークフローが完全に予測可能で、エージェントに何かを決定させる必要がない場合に適したツールです。

トラブルシューティング

症状	考えられる原因	修正方法
ツール呼び出しが `403` / コード `102`、「API Key not valid」を返す	API キーが不正または欠落	Bearer Auth 資格情報に正確な Ayrshare キーが保持されているか確認してください。変更後はノードを再保存してください。
n8n が MCP サーバーに接続できない	トランスポートまたはエンドポイントが間違っている	エンドポイントは `https://api.ayrshare.com/mcp` である必要があり、トランスポートは SSE ではなく HTTP Streamable である必要があります。
X/Twitter 投稿がエラー `419` で失敗する	X BYO 資格情報が欠落している	Multiple Headers 認証で 2 つの `X-Twitter-OAuth1-*` ヘッダーを追加してください。
1 つのプラットフォームのみで投稿が失敗する	そのネットワークがリンクされていないか、必要なフィールドが欠落している	ダッシュボードでリンクし、YouTube には `title` を、Reddit には `title` + `subreddit` を、Instagram には `mediaUrls` を追加してください。
Instagram 投稿が拒否される	メディアがない	Instagram はほとんどの投稿タイプで `mediaUrls` を必要とします。エージェントに `validate_media` で確認させてください。
ファイルまたはバイナリとして添付されたメディアが表示されない	MCP は JSON のみ	公開 `mediaUrls` URL でメディアを参照してください。MCP パスはファイルアップロードを受け付けません。URL は `validate_media` で確認してください。
呼び出しは成功するが、間違ったクライアントに対して動作する	プロファイルターゲティング	`Profile-Key` ヘッダー（接続ごと）または `profileKey` 引数（呼び出しごと）を設定してください。両方が設定されている場合は引数が優先されます。
`429 Too Many Requests`	ポーリング頻度が高すぎる	アナリティクスとコメントのポーリング頻度を減らしてください。メトリクスは秒単位で更新されません。
設定変更が反映されない	MCP 接続はセッション開始時に初期化される	キーまたはヘッダーを変更した後、ノードを再保存するかワークフローを再起動してください。

explain_error ツールをエージェントに公開すれば、Ayrshare のあらゆるエラーコードを自律的に原因と修正方法にデコードすることもできます。

次のステップ

Connect & Setup

エンドポイント、トランスポート、認証、プロファイルターゲティング、BYO 資格情報。

Tool Catalog

ドメイン別にグループ化された 27 個のツールと、そのスコープおよび目的。

MCP Server

MCP Server とは何か、そして Ayrshare API へのマッピング方法。

Claude Code Plugin

Claude Code 向けにパッケージ化された同じサーバー。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

n8n スターターワークフローをダウンロード

API 呼び出しを書くのではなく MCP を使用する理由

接続の仕組み

前提条件

MCP Client Tool ノードのセットアップ

ツールサーフェス

例 1: チャットメッセージから下書き、検証、公開

例 2: 新しいコンテンツを自動的にチャネル全体に公開

例 3: 週次アナリティクスダイジェスト

クライアントに代わって行動する（マルチテナント）

X/Twitter への投稿

ヒューマンインザループを維持する

REST フォールバック（エージェントなし）

トラブルシューティング

次のステップ

Connect & Setup

Tool Catalog

MCP Server

Claude Code Plugin

n8n スターターワークフローをダウンロード

​API 呼び出しを書くのではなく MCP を使用する理由

​接続の仕組み

​前提条件

​MCP Client Tool ノードのセットアップ

​ツールサーフェス

​例 1: チャットメッセージから下書き、検証、公開

​例 2: 新しいコンテンツを自動的にチャネル全体に公開

​例 3: 週次アナリティクスダイジェスト

​クライアントに代わって行動する（マルチテナント）

​X/Twitter への投稿

​ヒューマンインザループを維持する

​REST フォールバック（エージェントなし）

​トラブルシューティング

​次のステップ

Connect & Setup

Tool Catalog

MCP Server

Claude Code Plugin

API 呼び出しを書くのではなく MCP を使用する理由

接続の仕組み

前提条件

MCP Client Tool ノードのセットアップ

ツールサーフェス

例 1: チャットメッセージから下書き、検証、公開

例 2: 新しいコンテンツを自動的にチャネル全体に公開

例 3: 週次アナリティクスダイジェスト

クライアントに代わって行動する（マルチテナント）

X/Twitter への投稿

ヒューマンインザループを維持する

REST フォールバック（エージェントなし）

トラブルシューティング

次のステップ