エンドポイントとトランスポート
本番環境の MCP サーバーは次の URL で利用できます:https://api.ayrshare.com/mcp
Streamable HTTP トランスポートを使用し、ステートレス です — 呼び出し間で維持するセッションはありません。
対応クライアント
Action MCP Server は、静的なAuthorization: Bearer リクエストヘッダー のみ で認証します。この 1 つの要件が以下のすべてを決定します: Streamable HTTP 接続でカスタム HTTP ヘッダーを設定できるクライアントは認証でき、設定できないクライアントは認証できません。セットアップを始める前に、お使いのクライアントを確認してください。
個人コネクターが認証できない理由
Ayrshare の Action MCP には、静的なAuthorization: Bearer ヘッダーが必要です。claude.ai、Claude Desktop、または Claude mobile で個人のカスタムコネクターとして追加しても機能しません。Ayrshare は OAuth メタデータを公開しておらず、リクエストヘッダーによる代替手段は承認された組織に限定されたベータ版だからです。
個人コネクターでは、ユーザー側のどの設定でもこれを解決できません: Authorization ヘッダー用のフィールドはなく、これを有効にする API キー、プロファイル、アカウント設定もありません。Ayrshare は OAuth メタデータを公開していないため、コネクターの OAuth パスには接続先がありません。 代わりに上記の表のクライアントを使用してください: Claude Code、Claude Code プラグイン、またはカスタム Authorization ヘッダーを設定できる任意のクライアントです。Anthropic のリクエストヘッダーベータに参加している組織の管理者の場合は、下記の Team および Enterprise 組織 を参照してください。
Team および Enterprise 組織
Anthropic のstatic_headers メカニズムを使用すると、カスタムコネクターは OAuth の代わりに、固定の認証情報をリクエストヘッダーとして送信できます。これは 一部の組織の組織管理者向けにベータ版として提供されており、個人コネクターを追加する個々のユーザーは 利用できません。
組織にアクセス権がある場合、管理者はヘッダー値として Bearer の後に Ayrshare API キーを続けて入力する必要があります(スペースを含みます) — Claude は入力された値をそのまま送信し、スキームを自動的には追加しません。現在の提供状況とセットアップについては、Anthropic のコネクター認証ドキュメント を参照してください。
認証
認証は REST API と同じ Ayrshare API チェーンによって適用されます。- 必須:
Authorization: Bearer YOUR_API_KEY— アカウントの API Key(プロファイルとサブプロファイル用の Business プランキー)。 - 任意:
Profile-Key: YOUR_PROFILE_KEY— 接続上のすべての呼び出しで対象のサブプロファイルを指定します。 - 呼び出しごとの任意:
profileKeyツール引数 — 単一のツール呼び出しでサブプロファイルを対象にします。
優先順位: 引数がヘッダーより優先されます
ツール呼び出しにprofileKey 引数が含まれ、かつ 接続に Profile-Key ヘッダーがある場合、呼び出しごとの profileKey 引数が優先されます。ヘッダーは有効な引数が指定されていない場合にのみ使用されます。
例外が 1 つあります: get_platform_history と get_social_network_analytics において、X/Twitter の userId/userName ルックアップはアカウントの API Key のみを使用する必要があります。ここに profileKey 引数または Profile-Key ヘッダーを指定するとエラー 400 が返されます。
MCP の
initialize と tools/list メソッドは、認証前にアクセス可能です — メタデータを返すだけで、何も実行しません。すべてのツール呼び出しは認証されます。認証エラー
ツール呼び出しで認証されていないか無効なキーの場合、Ayrshare の error 403 / code 102 が返され、メッセージは “API Key not valid” です。MCP 仕様に従い、ツール実行エラーはインバンドで返されます: ツール結果にはisError: true とこのメッセージが含まれますが、MCP トランスポート自体は HTTP 200 を返します。(403/102 は Ayrshare のアプリケーションエラーであり、トランスポートステータスではありません。)
接続
オプション A: Claude Code プラグイン
Claude Code を使用している場合は、Ayrshare プラグインをインストールしてください。MCP サーバーの設定、セットアップコマンド、エージェント、スキル、確認フックがバンドルされています。完全なインストール手順については Claude Code プラグイン ページを参照してください。オプション B: 任意の MCP クライアント
Streamable HTTP をサポートし、カスタムリクエストヘッダーを設定できる 任意の MCP クライアントで — 上記の 対応クライアント を参照 — サーバーを直接登録します。Claude Code の場合:Profile-Key ヘッダーを追加します:
X/Twitter BYO 認証情報
2026 年 3 月 31 日以降、Ayrshare を通じた X/Twitter 操作には、独自の OAuth 1.0a 認証情報が必要です。ツール呼び出しが X/Twitter を対象とする場合、接続上でAuthorization(および任意の Profile-Key)ヘッダーとともに、次の 2 つのヘッダーを転送します:
これらは REST API で使用されるヘッダーと同じです — Ayrshare アカウントごとに 1 組の OAuth 1.0a キーペアで、X を対象とするすべてのリクエストで送信します(同じペアがすべてのサブプロファイルに適用されます)。Ayrshare はここで OAuth 2.0 を使用しません。セットアップ、ポリシー、トラブルシューティングについては API 概要 と X BYO キー設定ガイド を参照してください。
BYO ヘッダーで接続する
最初から X/Twitter BYO 認証情報を設定するには、両方の OAuth 1.0a ヘッダーをAuthorization ヘッダーと共に追加します(すべての呼び出しでサブプロファイルを対象にする場合は Profile-Key も含めます):
既存の接続に BYO ヘッダーを追加する
接続ヘッダーはサーバー追加時に固定されるため、BYO ヘッダーなしで既に接続している場合は、サーバーを削除して完全なセットで再追加してください(すでに使用していたProfile-Key などのヘッダーも再度含めます):
次のステップ
ツールカタログ
ドメイン別にグループ化された 33 のツールと、スコープと目的。
Claude Code プラグイン
Claude Code 用の Ayrshare プラグインをインストールします。