メインコンテンツへスキップ
Ayrshare Claude Codeプラグインは、MCPサーバーの設定、セットアップコマンド、agent、skill、および安全性フックをバンドルしています。これをインストールすると、Claude Codeから直接投稿の公開、履歴やanalyticsの取得、プロフィール管理などが可能になります。何かがライブになる前に、agentは各投稿を対象ネットワークのルールに対して検証し、確認を求めるため、避けられる拒否を事前にキャッチできます。ブランドのボイスに合わせるための投稿履歴を利用でき、analyticsを読み戻すことで次の投稿に活かせます。 このプラグインはオープンソースです。内部については以下のリポジトリを参照してください: ayrshare/ayrshare-social-media-api-claude-plugin。

​
インストール

1

マーケットプレイスを追加（初回のみ）

2

プラグインをインストール

​
インストールスコープ

Claude CodeのCLIでは、グローバルスコープを--scope userと呼びます。

​
認証情報

Ayrshare APIキーは、以下のいずれかの方法で提供します:
  • /ayrshare:setupを実行して、キーの設定またはローテーションを行います。
  • AYRSHARE_API_KEY環境変数を設定します。
プラグインにバンドルされた.mcp.jsonには既にAuthorizationヘッダーに加え、オプションのProfile-KeyおよびX BYOKヘッダーがそれぞれ空のデフォルト値（${VAR:-}）で宣言されているため、対応する環境変数を設定するだけでヘッダーを有効にできます（Claude Codeが起動時に値を置換します）。すべての呼び出しでサブプロフィールを対象にするには、AYRSHARE_PROFILE_KEYを（/ayrshare:setupまたはsettings.jsonのenvブロックで）設定し、Claude Codeを再起動してください。バンドルされたProfile-Keyヘッダーがそれを運びます。未設定の場合は空のまま（未提供として扱われる）となります。単一の呼び出しでサブプロフィールを対象にするには、代わりにprofileKeyツール引数を渡します（設定変更は不要）。バンドルされた.mcp.jsonを編集する必要はなく、また編集すべきではありません。なぜならclaude plugin updateで上書きされるためです。
MCPサーバーはセッション開始時に初期化されます。プラグインのインストール後やキーを変更した後は、Claude Codeを再起動してください。

​
X/Twitter BYO認証情報

X/Twitterへの投稿には、独自のX Developer Appの認証情報が必要です（X BYOキー義務、2026年3月31日発効。API概要を参照）。バンドルされた.mcp.jsonには既に両方のX BYOKヘッダーが空のデフォルト値で宣言されており、AuthorizationおよびProfile-Keyと並んで含まれています:
したがって、/ayrshare:setupまたはsettings.jsonのenvを介して対応する環境変数（X_TWITTER_OAUTH1_API_KEY、X_TWITTER_OAUTH1_API_SECRET）を設定するだけで、その後Claude Codeを再起動します。バンドルされた.mcp.jsonは編集しません（claude plugin updateで上書きされます）。両方を設定するか、どちらも設定しないでください: どちらも設定されていない場合、X/Twitter呼び出しはエラー419（x_credentials_required）を返し、片方だけ設定されている場合はエラー400を返します。これはAyrshareアカウントごとに1つのキーペアで、Xを対象とするすべてのリクエストに送信されます（すべてのサブプロフィールで同じペア）。
プラグインよりも生の接続を好みますか？ 同じBYOヘッダーはclaude mcp add --headerで渡すこともできます — 接続とセットアップ → X/Twitter BYO認証情報を参照してください。

​
同梱されるもの

​
コマンド

  • /ayrshare:setup — Ayrshare APIキーの設定またはローテーションを行います。

​
Agents

  • social-manager: プラットフォーム全体でコンテンツを公開、スケジュール、分析します。
  • profile-manager: プロフィールを作成・一覧表示し、Businessアカウントの下のクライアントプロフィール用のJWTソーシャルリンクURLを発行します。
  • insights-analyst: 読み取り専用のレポーティング。メトリクスや投稿履歴を取得し、パフォーマンスを要約します。投稿、コメント、メッセージ送信、または変更は一切行いません。

​
Skills

​
確認フック

PreToolUseフックは、公開または送信アクションの前に確認を求めます。以下の7つのツールを正確にカバーしています:
  • create_post
  • update_post
  • retry_post
  • add_comment
  • reply_comment
  • send_message
  • set_auto_response

​
FAQ

はい。プラグインは公開前にvalidate_postを実行して、コンテンツを各ネットワークのルール（長さ、フォーマット、メディア要件）に対してドライランするため、避けられる拒否を事前にキャッチできます。
はい。PreToolUse確認フックが、公開または送信アクション（create_post、update_post、retry_post、add_comment、reply_comment、send_message、set_auto_response）の前に承認を求めます。
はい。draft-in-brand-voice skillは投稿履歴を読み取り、一貫したブランドボイスで新しいコピーをドラフトします。ドラフトを作成するだけで、確認なしに公開されるものはありません。
はい。analyticsツールは投稿ごとおよびアカウントレベルのメトリクスを返すため、結果を読み戻して次の投稿に活かせます。
Ayrshare APIキー（プロフィールおよびサブプロフィール用にはBusinessプランキー）とClaude Code。キーは/ayrshare:setupまたはAYRSHARE_API_KEY環境変数で設定し、Claude Codeを再起動します。
はい。X/Twitterには独自のOAuth 1.0a認証情報が必要で、2つの接続ヘッダー（X-Twitter-OAuth1-Api-KeyとX-Twitter-OAuth1-Api-Secret）として追加します。上記のX/Twitter BYO認証情報を参照してください。

​
次のステップ

接続とセットアップ

認証、プロフィールターゲティング、およびBYO認証情報。

ツールカタログ

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