メインコンテンツへスキップ
Ayrshare MCP サーバー は、AI エージェントが Ayrshare API を操作できるようにします。このページでは、その接続方法と認証の仕組みを説明します。

​
エンドポイントとトランスポート

本番環境の MCP サーバーは次の URL で利用できます: https://api.ayrshare.com/mcp Streamable HTTP トランスポートを使用し、ステートレス です — 呼び出し間で維持するセッションはありません。

​
認証

認証は 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 ヘッダーを追加します:
MCP 接続はセッション開始時に初期化されます。サーバーをインストールしたりキーを変更した後は、新しい構成が有効になるように MCP クライアントを再起動してください。

​
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 キー設定ガイド を参照してください。
これらのヘッダーがない場合、X/Twitter のツール呼び出しはエラー 419(x_credentials_required)を返します。

​
BYO ヘッダーで接続する

最初から X/Twitter BYO 認証情報を設定するには、両方の OAuth 1.0a ヘッダーを Authorization ヘッダーと共に追加します(すべての呼び出しでサブプロファイルを対象にする場合は Profile-Key も含めます):

​
既存の接続に BYO ヘッダーを追加する

接続ヘッダーはサーバー追加時に固定されるため、BYO ヘッダーなしで既に接続している場合は、サーバーを削除して完全なセットで再追加してください(すでに使用していた Profile-Key などのヘッダーも再度含めます):
ヘッダーを変更した後は、新しい構成が有効になるよう MCP クライアントを再起動してください。生の接続の代わりに Claude Code プラグインを使用していますか?Claude Code プラグイン → X/Twitter BYO 認証情報 を参照してください。

​
次のステップ

ツールカタログ

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

Claude Code プラグイン

Claude Code 用の Ayrshare プラグインをインストールします。