HandlePilot

HandlePilot MCP

AI エージェントのための Instagram コンテンツハブです。 Claude、ChatGPT、Claude Code、Codex、Cursor、または VS Code を HandlePilot に接続できます。エージェントは、お使いの AI サブスクリプションを利用して調査、計画、執筆を行います。HandlePilot は、ワークスペース、競合調査、コンテンツ計画、ボード、アセット、カルーセル、リールを管理し、エージェントのために動画を視聴します。また、すべての文章を確認できるエディターも用意しています。

• サーバー： https://app.handlepilot.com/mcp（リモート、Streamable HTTP）
• サインイン： ブラウザーで OAuth（メールのサインインリンクを開いてから「Allow」を選択）、または個人用トークン
• ドキュメント： https://handlepilot.com/mcp

このリポジトリには、公開ドキュメント、MCP Registry のエントリー（server.json）、および HandlePilot のプレイブックをスキルとして収録した Claude Code プラグインがあります。サーバー自体は HandlePilot が運用しており、このリポジトリには含まれていません。

エージェントでできること

• 調査： 公開されている Instagram アカウントや投稿を検索し、プロフィールやリールを探し、競合の投稿のパフォーマンスを比較できます。また、リールを視聴して、トランスクリプト、シーン、フック、構成、音楽、効果がある理由を含む詳細な分析を取得できます。
• 計画： 自社の分野と実績データに基づいてコンテンツ戦略を作成し、コンテンツ計画として保存して、アイデアをカレンダーに追加できます。
• 制作： 実績のある投稿を自分の声に合わせたスクリプトにリミックスしたり、HandlePilot のデザインにカルーセルを作成したり（独自のスタイルをデザインすることもできます）、パソコンで編集したリールをアップロードしたりできます。
• 記憶： ブランドの声のガイド、計画、ボード、アセット、デッキは HandlePilot に保存されるため、どのエージェントのセッションも同じ情報をもとに開始できます。

無料プランと有料プラン

サインインした方は誰でも無料アカウントを利用できます。パソコン上で何かが実行されることはなく、コピーするキーもありません。最初の接続時にブラウザーで HandlePilot のサインイン画面が開きます。

	無料	有料、月額 $50、いつでもキャンセル可能
プレイブック、プロンプト、カルーセルのスタイル、その他のナレッジツール	無制限	無制限
新しい動画の視聴（同じ動画の再視聴は無料）	月 3 回	より多く利用可能
Instagram の検索（アカウント、投稿、検索）	月 30 回	より多く利用可能
ワークスペース（管理する Instagram アカウント）	1	追加可能
インスピレーション用アカウント	ワークスペースごとに最大 5 件、手動で追加	一括調査スキャンも利用可能
カルーセル	月 5 件、組み込みスタイルを利用	利用可能。カスタムスタイルも利用可能
制作ボードとカレンダー		利用可能
アセットライブラリとアップロード		利用可能
リール（Reel Maker、完成したリールのアップロード）		利用可能

• 無料枠は各暦月の初め（UTC）にリセットされます。
• すべてのアカウントで、すべてのツールを確認できます。有料プランが必要なツールを使う場合、または無料枠を使い切った場合、そのツールはリンク付きで upgrade_required と応答し、エージェントが一度だけ通知します。すでに保存したものはすべて引き続き利用できます。
• アプリでアップグレードできます：https://app.handlepilot.com/subscribe。同じ接続をそのまま使えるため、再インストールは不要です。

インストール

どのクライアントも同じ URL に接続します：https://app.handlepilot.com/mcp。

Claude（claude.ai、Claude Desktop、モバイル）

1. 上のリンクを開くか、Customize → Connectors に移動して + Add を選択し、次に Add custom connector を選択します。名前に HandlePilot を入力し、URL を貼り付けます。
2. Add を選択し、HandlePilot にサインインして Allow を押します。
3. チャットで + → Connectors を開き、有効にします。

Team プランと Enterprise プランでは、オーナーが Organization settings → Connectors で一度追加すると、各メンバーが Connect を選択できるようになります。Claude の無料プランでは、カスタムコネクターを 1 つ追加できます。

ChatGPT

1. chatgpt.com/pluginsを開き、**+**を選択してから、Add custom MCP serverを選択します。
2. 名前にHandlePilotを入力し、URLを貼り付け、認証方法にOAuthを選択します。警告を承諾して、Create as a pluginを選択します。
3. HandlePilotにサインインして、Allowを押します。チャットで**@**と入力し、HandlePilotを選択します。

カスタム MCP サーバーを追加できるかどうかは、ChatGPTのプランとワークスペースの設定によって決まります。

Claude Code

claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp

すべてのプロジェクトで使うには、--scope userを追加します。その後、/mcpと入力し、handlepilotを選択して、Authenticateを選び、サインインしてAllowを押します。

または、プラグインをインストールします。同じサーバーに加えて、HandlePilotのプレイブックをスキルとして追加します（/handlepilot:strategy、/handlepilot:remix、...）。

/plugin install handlepilot --marketplace Handlepilot/instagram-mcp

2.1.275より古いClaude Codeでは、/plugin marketplace add Handlepilot/instagram-mcpを実行してから、/plugin install handlepilot@handlepilotを実行します。その後、/mcpと入力し、plugin:handlepilot:handlepilotを選択して、Authenticateを選び、サインインしてAllowを押します。

どちらか一方を使ってください。両方を使うと、Claude Codeが2回接続し、すべてのツールが2回ずつ表示されます。手動で追加した方はclaude mcp remove handlepilotで削除してください。

Codex

codex mcp add handlepilot --url https://app.handlepilot.com/mcp
codex mcp login handlepilot

または、~/.codex/config.tomlに追加します。

[mcp_servers.handlepilot]
url = "https://app.handlepilot.com/mcp"

その後、codex mcp login handlepilotを実行します。

Cursor

または、~/.cursor/mcp.jsonに追加します。

{
  "mcpServers": {
    "handlepilot": {
      "url": "https://app.handlepilot.com/mcp"
    }
  }
}

Cursorは初回接続時に、HandlePilotへのサインインを求めます。

VS Code

または、ターミナルから実行します。

code --add-mcp '{"name":"handlepilot","type":"http","url":"https://app.handlepilot.com/mcp"}'

または、.vscode/mcp.jsonに追加します。

{
  "servers": {
    "handlepilot": {
      "type": "http",
      "url": "https://app.handlepilot.com/mcp"
    }
  }
}

VS Codeは初回使用時に、ブラウザーでHandlePilotへのサインイン画面を開きます。

その他のクライアント

リモートのStreamable HTTPサーバーとOAuthに対応するMCPクライアントであれば、https://app.handlepilot.com/mcpを使用できます。

OAuthの代わりに個人用トークンを使う

OAuthに対応していないクライアントやスクリプトで使う場合：

1. https://app.handlepilot.com/connect-ai にサインインして、トークンを作成します。トークンはhp_で始まり、一度だけ表示されます。
2. ヘッダーとして送信します：Authorization: Bearer hp_YOUR_TOKEN。

# Claude Code
claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp \
  --header "Authorization: Bearer hp_YOUR_TOKEN"

# Codex: put the token in an environment variable, e.g. export HANDLEPILOT_TOKEN="hp_YOUR_TOKEN"
[mcp_servers.handlepilot]
url = "https://app.handlepilot.com/mcp"
bearer_token_env_var = "HANDLEPILOT_TOKEN"

// Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "handlepilot": {
      "url": "https://app.handlepilot.com/mcp",
      "headers": { "Authorization": "Bearer hp_YOUR_TOKEN" }
    }
  }
}

トークンを使うと、管理しているすべてのワークスペースに、アプリ内での自分と同じ権限でアクセスできます。トークンはいつでも同じページで取り消すことができ、取り消すとすぐに無効になります。

ツール

39 個のツールがあります。すべてのアカウントで全ツールを利用でき、どのツールが実行されるかはプランによって決まります。

無料

ツール	機能
list_workspaces	HandlePilot で管理している Instagram アカウント
get_creator_context	プロフィール、ニッチ、オーディエンスの言語、ボイスガイドとサンプル、プランおよびボードの概要。最初に読み取ります
update_voice_pack	クリエイターの話し方や書き方を保存します
get_my_performance	クリエイター自身の過去 30 日間の Instagram の数値（アプリで Instagram との接続が必要です）
list_inspiration_accounts	競合アカウントと参考アカウントのウォッチリスト。おすすめ順です
verify_inspiration_accounts	ユーザーの申告に基づいて、リスト内のアカウントを確認済みにします
remove_inspiration_account	リストからアカウントを削除します
list_top_content	ウォッチリスト内の最近の人気投稿。キャッシュ済みの動画分析もインラインで表示します
get_content_plan, save_content_plan	コンテンツ戦略を読み取る、または保存します
list_carousel_styles, get_carousel_style	HandlePilot のカルーセルデザインと、それぞれのライティングブリーフ
list_carousels, get_carousel, update_carousel	カルーセルを一覧表示、取得し、デッキを改訂します
get_playbook	HandlePilot のハウツーガイド（プラグインのスキルと同じ内容です）
send_feedback	HandlePilot チームに、修正・追加・変更してほしいことを伝えます

無料（月ごとの上限あり）

ツール	機能	無料利用枠
watch_video	リール、投稿、アセットの構造化分析。文字起こし、画面上のテキスト、シーン、フック、構成、音楽、編集、効果がある理由を確認できます	月 3 本の新しい動画。再視聴は無料です
get_instagram_account	公開プロフィールと最近の投稿の数値	月 30 回の検索。この 3 つのツールで共有されます
get_instagram_post	1 件の投稿のキャプション、数値、投稿者、メディアリンク
search_instagram	Instagram のプロフィール、または今月の特定のトピックに関するリールを検索します
create_workspace	Instagram アカウントをワークスペースとして追加します	1 ワークスペース
add_inspiration_accounts	確認するアカウントをウォッチリストに追加します	ワークスペースあたり最大 5 件
create_carousel	スタイルを使ってカルーセルを作成します。Carousel Maker で編集できます	月 5 件。組み込みスタイルを使用

有料プラン

ツール	機能
scan_instagram_accounts	一括リサーチ。1 回の呼び出しで最大 20 アカウントを調査します
list_cards, get_card, create_card, update_card, delete_card	制作ボードとカレンダー。スクリプトも含まれます
create_custom_style	独自のカルーセルスタイルをデザインし、最初のデッキも作成します
list_assets, search_assets, get_asset, import_asset_from_url, create_upload_link	意味で検索できるアセットライブラリ。チャットで送るには大きすぎるファイル用のアップロードページも利用できます
start_asset_upload	コンピューターからアセットライブラリにファイルをアップロードします *
list_reels, start_reel_upload	Reel Maker と、エージェントが編集した完成済みリール *

* start_asset_upload と start_reel_upload は、Claude Code など、コンピューター上で動作するエージェントにのみ提供されます。ChatGPT や claude.ai などのチャットアプリでは利用できません。

このサーバーは、次のプレイブックを MCP プロンプトとしても提供します：getting-started、strategy、discovery、voice-pack、remix、carousel、custom-style、reel-editing。

プロンプトの例

• 「HandlePilot で @yourhandle を調べて、直近の投稿 30 件のうち、普段の閲覧数を上回ったものと、その理由を教えてください。」
• 「このリールを確認して、フック、構成、効果がある理由を分析してください：https://www.instagram.com/reel/...」
• 「最近の投稿をもとにボイスガイドを作成し、HandlePilot に保存してください。」
• 「HandlePilot のスタイルを使って、忙しい親向けの食事の作り置きについて、私の声で 7 枚のカルーセルを作成してください。」
• 「競合を調査して、来月のコンテンツ戦略を作成してください。」
• 有料プラン：「私が参考にすべきニッチ分野のアカウントを 25 件見つけて、インスピレーションリストに追加してください。」
• 有料プラン：「プランの中で最も有望なアイデアを、来週火曜日にボードで使える撮影準備済みのスクリプトにしてください。」

Claude Code プラグイン

plugins/handlepilot/ は、このリポジトリのマーケットプレイス（.claude-plugin/marketplace.json）に掲載されている Claude Code プラグインです。.mcp.json でリモートサーバーを宣言し、HandlePilot のプレイブックを、getting-started、strategy、discovery、voice-pack、remix、carousel、custom-style、reel-editing の 8 つのスキルとして提供します。ローカルコードは実行しません。plugins/handlepilot/README.md をご覧ください。

お客様のデータ

• 接続したアプリまたはトークンを使うと、お客様が管理するすべてのワークスペースにアクセスでき、アプリ内ではお客様と同じ権限が適用されます。アプリの接続解除またはトークンの取り消しは、いつでも https://app.handlepilot.com/connect-ai から行えます。
• ツールが返す内容は、お客様との契約に基づき、お客様のエージェントの AI プロバイダー（たとえば、ChatGPT と Codex の場合は OpenAI、Claude の場合は Anthropic）によって読み取られます。
• HandlePilot は、必要に応じて公開 Instagram データを取得します。お客様のエージェントを通じて Instagram に投稿されることはありません。
• プライバシーポリシー：https://handlepilot.com/privacy
• 利用規約：https://handlepilot.com/terms

サポート

• メール：[email protected]
• 不具合や機能要望：issue を作成してください。issue にトークン（hp_...）を貼り付けないでください。
• エージェントから：フィードバックを送信するよう依頼してください。HandlePilot の send_feedback ツールからチームに直接届きます。

ライセンス

このリポジトリ内のファイル（ドキュメント、server.json、プラグインとそのスキル）は MIT ライセンスです。LICENSE をご覧ください。HandlePilot サービスには、利用規約が適用されます。

HandlePilot は独立した製品です。Instagram または Meta との提携、支持、後援関係はありません。Instagram は Meta Platforms, Inc. の商標です。