> ## 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. # MCP サーバーへの接続 > 任意の MCP クライアントを Ayrshare MCP サーバーに接続する — トランスポート、エンドポイント、認証。 Ayrshare [MCP サーバー](/additional/mcp-action-server) は、AI エージェントが Ayrshare API を操作できるようにします。このページでは、その接続方法と認証の仕組みを説明します。 ## エンドポイントとトランスポート 本番環境の MCP サーバーは次の URL で利用できます: `https://api.ayrshare.com/mcp` **Streamable HTTP** トランスポートを使用し、**ステートレス** です — 呼び出し間で維持するセッションはありません。 ## 認証 認証は REST API と同じ Ayrshare API チェーンによって適用されます。 ### 優先順位: 引数がヘッダーより優先されます ツール呼び出しに `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 プラグイン](/additional/mcp-claude-code-plugin) ページを参照してください。 ### オプション B: 任意の MCP クライアント Streamable HTTP をサポートする任意の MCP クライアントで、サーバーを直接登録します。Claude Code の場合: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` すべての呼び出しでサブプロファイルを対象にするには、任意の `Profile-Key` ヘッダーを追加します: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_PROFILE_KEY" ``` MCP 接続はセッション開始時に初期化されます。サーバーをインストールしたりキーを変更した後は、新しい構成が有効になるように **MCP クライアントを再起動してください**。 ## X/Twitter BYO 認証情報 2026 年 3 月 31 日以降、Ayrshare を通じた X/Twitter 操作には、独自の OAuth 1.0a 認証情報が必要です。ツール呼び出しが X/Twitter を対象とする場合、接続上で `Authorization`(および任意の `Profile-Key`)ヘッダーとともに、次の 2 つのヘッダーを転送します: | ヘッダー | 説明 | | ----------------------------- | ------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | OAuth 1.0a API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | OAuth 1.0a API Key Secret (Consumer Secret) | これらは REST API で使用されるヘッダーと同じです — Ayrshare アカウントごとに 1 組の OAuth 1.0a キーペアで、X を対象とするすべてのリクエストで送信します(同じペアがすべてのサブプロファイルに適用されます)。Ayrshare はここで OAuth 2.0 を使用しません。セットアップ、ポリシー、トラブルシューティングについては [API 概要](/apis/overview#xtwitter-byo-credentials) と [X BYO キー設定ガイド](/dashboard/connect-social-accounts/x-twitter-byo-keys) を参照してください。 これらのヘッダーがない場合、X/Twitter のツール呼び出しはエラー `419`(`x_credentials_required`)を返します。 ### BYO ヘッダーで接続する 最初から X/Twitter BYO 認証情報を設定するには、両方の OAuth 1.0a ヘッダーを `Authorization` ヘッダーと共に追加します(すべての呼び出しでサブプロファイルを対象にする場合は `Profile-Key` も含めます): ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### 既存の接続に BYO ヘッダーを追加する 接続ヘッダーはサーバー追加時に固定されるため、BYO ヘッダーなしで既に接続している場合は、サーバーを削除して完全なセットで再追加してください(すでに使用していた `Profile-Key` などのヘッダーも再度含めます): ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ヘッダーを変更した後は、新しい構成が有効になるよう MCP クライアントを再起動してください。生の接続の代わりに Claude Code プラグインを使用していますか?[Claude Code プラグイン → X/Twitter BYO 認証情報](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials) を参照してください。 ## 次のステップ ドメイン別にグループ化された 27 のツールと、スコープと目的。 Claude Code 用の Ayrshare プラグインをインストールします。