INSSIST

@inssist/mcp

AI エージェントが INSSIST Chrome 拡張機能を通じて、あなた自身がログイン済みの Instagram セッション内で作業できるようにする MCP サーバーです。

完全なドキュメントとインストール: https://inssist.com/instagram-mcp

なぜ必要か

他のすべての Instagram MCP は Graph API をラップしています。ビジネスアカウント専用で、ストーリーズも音楽も DM もなく、Meta が公開を選んだものだけが扱えます。INSSIST はあなたがすでにサインインしているブラウザを操作するため、Claude Code、Codex、Cursor、Claude Desktop が、個人・クリエイター・ビジネスのいずれのアカウントでも、プロフィールと DM を読み、音楽付きの投稿・リール・ストーリーズを公開およびスケジュールし、インサイトとオーディエンスレポートを取得し、メディアをダウンロードできます。

クラウドを経由したプロキシは一切なく、Instagram の認証情報が保持されることもありません。サーバーは各ツール呼び出しをループバック経由で拡張機能に渡し、拡張機能がブラウザから応答します。

Claude Code / Codex / Cursor / Claude Desktop
  │  stdio (MCP)
  ▼
@inssist/mcp
  │  ws://127.0.0.1:48231
  ▼
INSSIST Browser Extension
  │
  ▼
Instagram, in your own session

要件

• INSSIST がインストールされ、Instagram を開いてログイン済みの Chrome（またはその他の Chromium ブラウザ）。
• Node.js 22 以降（npx も同梱されています）。
• MCP クライアント。stdio サーバーを起動できるハーネスであればどれでも動作します。

インストール

お使いのエージェントにサーバーを登録します。サーバーは自動的にダウンロードおよび起動されるため、手動で実行するものはありません。

Claude Code

claude mcp add inssist -- npx -y @inssist/mcp

Codex

codex mcp add inssist -- npx -y @inssist/mcp

Claude Desktop、Cowork を含む: inssist-mcp.mcpb をダウンロードしてダブルクリックします。1 ステップで、Claude 内蔵の Node.js 上で動作し、ターミナルは不要です。

Cursor、Windsurf、Gemini CLI およびその他のクライアント: その MCP 設定に以下を追加します（Cursor: .cursor/mcp.json）:

{ "mcpServers": { "inssist": { "command": "npx", "args": ["-y", "@inssist/mcp"] } } }

ブラウザを接続する

1. Chrome で instagram.com を開き、INSSIST メニューをクリックします。
2. Connect to AI Agents をクリックし、トグルをオンにします。
3. 数秒以内にパネルに Connected と表示されます。

ペアリングは自動です。トグルがその同意となります。拡張機能がサーバーに接続し、双方がサイレント再接続用のトークンを保存し、トグルをオフにすると切断されてすべての再試行が停止します。複数の Chrome プロファイルを同じサーバーに接続でき、それぞれが account_info 内に instance として表示されます。

複数のエージェントを同時に使用することも問題ありません。各ハーネスは独自の @inssist/mcp プロセスを起動し、最初にポートをバインドしたものがハブとなり、後から起動したものはピアとして参加してハブ経由でリレーするため、2 つのターミナルで動く Claude Code、Claude Desktop、Cursor がすべて同じブラウザを共有します。ハブのハーネスが閉じると、ピアの 1 つがポートを引き継ぎ、拡張機能はそれに再接続します。

試してみる

Who am I logged in as, and how many followers do I have?
Show me the last 5 posts from @nasa with their like counts.
List my unread DMs and draft a reply to the first one. Don't send it yet.
Schedule /Users/me/reel.mp4 as a reel for tomorrow 9am with a caption about spring, and add a trending track.
Run an unfollowers scan and tell me who left this week.
Download the last 20 posts from @natgeo to my machine.

ツール

拡張機能の ツールと機能 パネルでグループ分けされている60個のツールです。PRO はINSSIST PROのサブスクリプションが必要なツールを示します。それ以外はすべて無料で、INSSIST 独自の間隔調整を除き、レート制限はありません。サブスクリプションなしで PRO ツールを呼び出すと、失敗する代わりに短いメッセージとアップグレードリンクが返されるため、エージェントからユーザーに伝えられます。

グループ	ツール
アカウント	account_info, account_switch
プロフィール	profile_update, note_set
データの読み取り	ig_fetch_profile, ig_fetch_posts, ig_fetch_post, ig_fetch_stories, ig_fetch_saved, ig_search
エンゲージメント	story_viewers, notifications_list, events_check, follow_requests_list, follower_remove, ig_block
コメント	comments_list, comment_add, comment_reply, comment_like, comment_delete
ダイレクトメッセージ	dm_list, dm_requests, dm_read, dm_send, dm_mark_seen, dm_accept, dm_remove
公開	draft_create, draft_schedule, draft_publish, draft_get, draft_preview, draft_update, draft_delete, draft_list, draft_reorder
投稿	ig_post_edit, ig_post_delete, location_search, music_search
インサイト	insights_collect, insights_report
オーディエンス	unfollowers_scan / _report / _export, antibot_scan / _report / _export, peers_scan / _report / _export
ダウンロード	downloads_start, downloads_status, downloads_cancel

知っておくと便利なツールの特徴をいくつか紹介します。

• draft_* と ig_post_* の違い。 下書きは INSSIST 独自の公開キューに保存されます（下書きには投稿、リール、ストーリー、カルーセルがあり、どれに該当するかは type で示されます）。ig_post_edit / ig_post_delete は、すでに Instagram に公開されている投稿を操作します。
• 開始してから、状況を確認します。 時間のかかるジョブはバックグラウンドで実行され、INSSIST の UI で確認できます。 insights_collect → insights_report、unfollowers_scan → unfollowers_report、 antibot_scan → antibot_report、peers_scan → peers_report、 downloads_start → downloads_status。
• *_export は、エージェントのコンテキストにストリーミングするには大きすぎるリストを、Chrome のダウンロード機能で CSV に書き出し、そのパスを返します。
• draft_create の Assets には、ローカルファイルのパス（サーバーが読み込みます）または http(s) URL（拡張機能がダウンロードします）を指定します。1ファイルあたり最大100 MB、1回の呼び出しあたり最大200 MBです。
• instance（account_info 以外のすべてのツール）：使用する接続済みブラウザープロフィールを指定します。デフォルトではアクティブなプロフィールが使われます。
• instant（Instagram にアクセスするツール）：INSSIST は、1アカウントごとに1つのキューを使って、エージェントからの呼び出しの間隔を数秒空けるため、短時間の連続呼び出しによるレート制限を防げます。instant: true を指定するとキューをスキップします。エージェントは、即時の操作を依頼された場合にのみ使用してください。待ち時間が約50秒を超える呼び出しは、busy: true と retryAfterMs を伴ってすぐに拒否されます。

ブラウザーが接続する前に、サーバーはパッケージに含まれるツールリストのスナップショットを通知するため、ハーネスは何も起動していない状態でもツールを一覧表示できます。この状態での呼び出しには、接続手順が返されます。拡張機能が接続されると、ライブのリストがスナップショットに置き換わり、クライアントに tools/list_changed 通知が送信されます。

プライバシー

すべてはお使いのマシン上で動作します。サーバーは 127.0.0.1 にバインドされ、chrome-extension:// オリジンからの接続のみを受け付け、1 つのファイル ~/.inssist/mcp-pairings.json(モード 0600)を保存します。このファイルには自身の id と、ブラウザプロファイルごとに 1 つのペアリングトークンが格納されます。拡張機能は INSSIST に通常どおり匿名の利用イベントを送信します。これにはエージェントが呼び出した各ツールの名前が含まれますが、引数や結果は決して含まれません。Instagram の通信はブラウザ自身によるものです。詳しくはプライバシーポリシーをご覧ください。

設定

変数	デフォルト	意味
INSSIST_MCP_PORT	48231	拡張機能が接続するループバックポート(拡張機能側でも変更してください)
INSSIST_MCP_HOME	~/.inssist	mcp-pairings.json を格納するディレクトリ

npx @inssist/mcp --version と --help も利用できます。

トラブルシューティング

• 「Failed to start the bridge on 127.0.0.1:48231.」 ほかのプログラムがそのポートを占有しています(別の @inssist/mcp であれば、拒否されずに参加されていたはずです)。macOS/Linux では lsof -nP -i :48231 で特定するか、ここおよび拡張機能側で INSSIST_MCP_PORT を空きポートに設定してください。
• パネルが「Waiting…」のままになる。 サーバーが起動していません。MCP クライアントがサーバーを起動していること(多くは最初のツール呼び出し時やセッションを開いたときに遅延起動します)、およびそのポートでほかに応答しているものがないことを確認してください。トグルをオフにしてからオンに戻すと、すぐに再接続します。
• ツールが「No INSSIST browser is connected」と応答する。 トグルがオフであるか、その Chrome プロファイルで Instagram が開かれていないか、拡張機能がまだ接続中です。パネルに Connected と表示されているか確認してください。
• プロトコルバージョンに関するメッセージ。 拡張機能とサーバーでワイヤフォーマットが一致していません。メッセージが示す側を更新してください。拡張機能は chrome://extensions → 更新、サーバーは npx @inssist/mcp@latest(または npx キャッシュのクリア)で更新し、ハーネスを再起動します。
• PRO ツールがアップグレードメッセージを返す。 サブスクリプションがない場合は想定どおりの動作です。エージェントがリンクを伝えます。

開発

npm install
npm run build               # compile (in the INSSIST monorepo this also refreshes the tool snapshot)
npm test                    # build + unit tests (node --test)
node scripts/smoke.mjs 60   # spawn the built server, list tools, call account_info

mcp-bridge-manifest.json はツールのスナップショットであり、拡張機能のソースから生成され、各リリース時にここへコミットされます。手動で編集されるものではありません。

セキュリティとサポート

脆弱性は [email protected] まで報告してください(SECURITY.md を参照)。サポートおよび質問は同じアドレス、または inssist.com/support まで。MIT。