InstaVision MCP Server認証済み注目

InstaVision MCP Server とは？

InstaVision MCP Server は、AI エージェントがニッチ、都市、フォロワー数の範囲、類似アカウントをもとに Instagram のクリエイターや見込み客を探せるようにします。エージェントはプレイブックを選び、クレジットを見積もり、あなたの InstaVision アカウントで実行を開始し、結果を読み取ったりエクスポートしたりします。

InstaVision はホスト型の発見サービスです。実行は InstaVision のダッシュボードに表示され、アカウントのクレジットを使います。リモートエンドポイントは https://instavision.co/api/mcp/mcp です。オープンソースの instavision-mcp npm パッケージ（MIT）は、stdio サーバーしか動かせないクライアント向けの軽量なローカルブリッジです。MCP の通信を同じホスト型サーバーに転送し、ディスクには何も保存しません。InstaVision は独立した製品で、Instagram や Meta とは提携しておらず、承認も受けていません。

InstaVision MCP Server の使い方

ほとんどのクライアントでは API キーが必要です。InstaVision にサインインし、Settings → API keys でキーを作成します。キーは一度しか表示されず、iv_sk_ で始まります。実際のキーをコマンドラインに直接入力しないでください。シェルの履歴に残ります。claude.ai はキーなしで OAuth 接続できます。

Claude Code

read -rs INSTAVISION_API_KEY && claude mcp add --scope user --transport http instavision https://instavision.co/api/mcp/mcp --header "Authorization: Bearer $INSTAVISION_API_KEY"

bash か zsh に貼り付けて Enter を押し、続けてキーを貼り付けて Enter を押します。キーは表示されず、シェルの履歴にも残りません。Claude Code はキーを ~/.claude.json に保存し、すべてのプロジェクトでサーバーを使えるようにします。

claude.ai

Settings → Connectors を開き、Add custom connector を選びます。名前を InstaVision にして https://instavision.co/api/connect/mcp を貼り付けます。サインインはブラウザで行います。Claude に求められたら InstaVision にサインインし、アクセスを承認してください。

Claude Desktop

Claude Desktop は npx ブリッジを使うため、Node.js が必要です。Settings → Developer → Edit Config を開き、次のブロックにキーを入れて追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "instavision": {
      "command": "npx",
      "args": ["-y", "instavision-mcp"],
      "env": { "INSTAVISION_API_KEY": "YOUR_INSTAVISION_API_KEY" }
    }
  }
}

Windows で npx が起動しない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "instavision-mcp"] を使ってください。

Cursor

~/.cursor/mcp.json に記述し、Cursor を起動する環境で INSTAVISION_API_KEY を設定します。

{"mcpServers":{"instavision":{"url":"https://instavision.co/api/mcp/mcp","headers":{"Authorization":"Bearer ${env:INSTAVISION_API_KEY}"}}}}

VS Code

.vscode/mcp.json に記述します。VS Code はキーを一度だけ尋ねて保存します。

{
  "inputs": [
    { "type": "promptString", "id": "instavision-api-key", "description": "InstaVision API key", "password": true }
  ],
  "servers": {
    "instavision": {
      "type": "http",
      "url": "https://instavision.co/api/mcp/mcp",
      "headers": { "Authorization": "Bearer ${input:instavision-api-key}" }
    }
  }
}

Codex

codex mcp add instavision --url https://instavision.co/api/mcp/mcp --bearer-token-env-var INSTAVISION_API_KEY

エージェントに「list InstaVision playbooks」と頼めば、接続を確認できます。

InstaVision MCP Server の主な機能

• 自然な言葉での依頼。エージェントが依頼をプレイブックと支出上限に変換します。
• 無料のコスト見積もり。estimate_credits は何も開始せずに最小と最大を返します。
• 支出の制限。すべての実行には合意した上限が付き、最大 500 クレジットです。アカウントで 5 件の検索が実行中のあいだはエージェントによる開始はできず、エージェントによる開始は 24 時間で最大 2,000 クレジットまでです。
• 重複なし。すでに届けたアカウントは、excludeSeen=false を指定しない限り以降の実行でスキップされます。
• 結果にはハンドル、名前、フォロワー数、メール、AI カテゴリ、適格性のフラグが含まれます。
• 1 時間で期限切れになる署名付きリンクで PDF をエクスポートできます。
• プロフィールのテキストはデータとして返され、指示としては扱われません。

InstaVision MCP Server のツール

11 個のツールを用途別にまとめます。

• 計画： list_playbooks と estimate_credits は API キーなしで使えます。
• 実行： launch_discovery はクレジットを使い、runId を返します。get_run_status でポーリングし、get_run_results でページごとに結果を読みます。export_run_pdf は結果を PDF にします。
• アカウントとプラン： get_balance はクレジットとプランを表示します。change_plan はより大きな月額プランに変更します。確認したあと、エージェント決済がオンで、月間上限の範囲内の場合にだけ、保存済みのカードに請求します。
• 重複排除プール： get_seen_accounts、add_seen_accounts（ブロックリストの取り込み）、破壊的操作の reset_seen_accounts。

InstaVision MCP Server のユースケース

• インフルエンサーの候補リスト：「オースティンでフォロワー 5k〜50k、公開メールのあるフィットネスコーチを探して」
• ニッチなリードリスト：「ナイジェリアの FX メンター系アカウントを探して。フォロワー 2k〜50k、上限 100 クレジット」
• 地域ビジネスの開拓：「ウェブサイトがなく公開メールを載せている米国の屋根工事業者を 5 件探して」
• いくつかの例となるアカウントから類似アカウントへ広げる。
• クライアント向けの納品物：「前回の実行を PDF でエクスポートして」

InstaVision MCP Server のトラブルシューティング

• API keys ページへの案内とともに呼び出しが失敗する： ブリッジまたはクライアントがキーなしで接続しています。プレイブックの一覧とクレジットの見積もりは使えますが、実行の開始、結果の読み取り、既出アカウントの一覧、PDF エクスポートにはキーが必要です。
• Cursor や Codex で認証できない： 起動した環境の INSTAVISION_API_KEY を読みます。そこで設定して再起動してください。
• Windows で npx が起動しない： 上記の cmd /c npx の形を使ってください。
• ブリッジがカスタム URL を拒否する： INSTAVISION_ALLOW_CUSTOM_URL=1 を設定しない限り、INSTAVISION_MCP_URL は https://instavision.co/ 配下でなければなりません。