> ## 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 > n8n の AI エージェントを Ayrshare MCP Server に接続することで、プラットフォームごとの API コードを書くことなく、13 のソーシャルネットワークで公開・スケジュール・分析を実行できます。 export const XByoNotice = () => Targeting X/Twitter? Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:

X-Twitter-OAuth1-Api-Key — Your API Key (Consumer Key)
X-Twitter-OAuth1-Api-Secret — Your API Key Secret (Consumer Secret)

One-time setup per Ayrshare account. You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do not create a new app per customer.

Not linked yet? See the full setup guide to connect your X account.

Your keys are never logged or stored by Ayrshare. ; n8n はツール同士を連携させる場所です。Ayrshare は、Facebook、Instagram、LinkedIn、YouTube、TikTok、Pinterest、Reddit、Threads、Bluesky、Telegram、Google Business Profile、Snapchat、X へ単一の呼び出しで投稿できる 1 つの API です。これらを [Ayrshare MCP Server](/additional/mcp-action-server) で接続すれば、n8n の AI エージェントがループ全体を自律的に実行できます。投稿の下書き、各ネットワークのルールに対する検証、公開またはスケジュール、そして分析結果の取得までを一貫して行えます。 キャンバス上の n8n スターターワークフロー: チャットトリガーから AI エージェントへ、その下に Anthropic チャットモデルと Ayrshare MCP ツールノードが接続され、セットアップと使用方法の付箋が付いています。 MCP Server はホスト型の Streamable HTTP エンドポイントであるため、n8n の組み込み **MCP Client Tool** ノードで接続できます。ホスティング、カスタムコード、コミュニティノードのインストールは不要です。1 つのノードを 1 つの URL に向けるだけで、エージェントは 27 個すべてのソーシャルツールを利用できるようになります。 上に示したワークフローをインポート可能な形式で提供: 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 フォールバック](#rest-fallback-no-agent) を用意しています。 ## API 呼び出しを書くのではなく MCP を使用する理由 Ayrshare の REST API は HTTP Request ノードから直接呼び出すこともでき、固定的で予測可能なワークフローには最適です。ただし、ループに LLM が入る場合には MCP Server の真価が発揮されます。 ## 接続の仕組み **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](/additional/mcp-action-connect) を参照してください。完全なツールリストについては、[Tool Catalog](/additional/mcp-action-tools) を参照してください。 ## 前提条件 ## MCP Client Tool ノードのセットアップ ワークフローを開くか新規作成し、**AI Agent** ノード（*Advanced AI* ノードの下）を追加します。 AI Agent ノードで、**Tool** コネクタをクリックし、**MCP Client Tool** ノードを追加します。次のように構成します。 | フィールド | 値 | | -------------------- | ------------------------------------- | | **Endpoint** | `https://api.ayrshare.com/mcp` | | **Server Transport** | `HTTP Streamable` | | **Authentication** | `Bearer Auth` | | **Tools to Include** | `All`（または特定のツールのみを公開する場合は `Selected`） | **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](/additional/mcp-action-tools) を参照してください。 安全性の観点で 2 つが特に重要です: **`validate_post`** は `create_post` と同じ入力で投稿をドライラン実行しますが、何も公開しません。**`explain_error`** は Ayrshare のあらゆるエラーコードを平易な英語での原因と修正方法に変換するため、エージェントは自己診断できます。 ## 例 1: チャットメッセージから下書き、検証、公開 この統合の「hello world」です。チャットメッセージまたはフォームでワークフローをトリガーし、あとはエージェントに任せます。 エージェントが自律的に行うこと: コピーと 3 つのプラットフォームで `validate_post` を呼び出します。Instagram が画像不足を指摘した場合、静かに失敗するのではなく通知します。検証が通過すると `create_post` を呼び出し、公開された投稿の URL を返します。検証が最初に実行されるため、公開前に問題を発見できます。 ## 例 2: 新しいコンテンツを自動的にチャネル全体に公開 コンテンツソースをそのままマルチネットワーク投稿に変換します。 データ駆動型のタグには `recommend_hashtags` を、コピーをチャットモデルではなく Ayrshare に下書きさせたい場合は `generate_post` を活用できます。 ## 例 3: 週次アナリティクスダイジェスト ループを逆方向に実行します: パフォーマンスを読み取り、レポートします。 頻度に関する注意点: ほとんどの投稿は最初の 24 時間でエンゲージメントの大部分を獲得し、メトリクスは秒単位で更新されるわけではありません。日次または週次のスケジュールで十分です。数分ごとにアナリティクスをポーリングしないでください。新しいデータもないのにレート制限に達するだけです。 ## クライアントに代わって行動する（マルチテナント） 複数のクライアントのソーシャルを管理する場合、Ayrshare のプロファイルにより、1 つのアカウントから多数の別々のリンク済みアカウントセットに投稿できます。Business または Enterprise Plan では、n8n からクライアントをターゲットにする 2 つの方法があります。 新しいクライアントをオンボーディングするには、エージェントが `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](/additional/mcp-action-connect#xtwitter-byo-credentials) を参照してください。 ## ヒューマンインザループを維持する MCP ツールを使えばエージェントが公開するのは簡単になるため、まさにそれをゲートで管理すべきです。安価な 2 つの安全策があります。 ## REST フォールバック（エージェントなし） LLM なしで固定的・決定的なワークフローを構築したい場合は、MCP をスキップし、**HTTP Request** ノードで REST API を呼び出します。 ```json theme={"system"} { "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 ゲートウェイエラー](/help-center/technical-support/response_bad_gateway_502_or_504_error) を返す可能性があるため、常に `api.ayrshare.com` を使用してください。）同じパターンが他の [REST エンドポイント](/apis/overview) にも当てはまります。これは、ワークフローが完全に予測可能で、エージェントに何かを決定させる必要がない場合に適したツールです。 ## トラブルシューティング | 症状 | 考えられる原因 | 修正方法 | | ------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------- | | ツール呼び出しが `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 のあらゆるエラーコードを自律的に原因と修正方法にデコードすることもできます。 ## 次のステップ エンドポイント、トランスポート、認証、プロファイルターゲティング、BYO 資格情報。 ドメイン別にグループ化された 27 個のツールと、そのスコープおよび目的。 MCP Server とは何か、そして Ayrshare API へのマッピング方法。 Claude Code 向けにパッケージ化された同じサーバー。