InstantClips

InstantClips MCP

English · スペイン語 · 簡体字中国語

InstantClips は、EC商品の短尺縦型動画を作成します。TikTok、Instagram Reels、Stories に対応しています。ホスト型の MCP サーバーとして動作するため、Claude Code、Codex、Cursor、VS Code、Claude アプリ、ChatGPT など、あらゆる MCP クライアントからウェブアプリと同じ操作ができます。商品のインポート、プランの作成、動画の生成が可能です。

テキストから動画を生成するツールではありません。 InstantClips は商品ページ（写真、価格、詳細）を読み取り、実際に掲載されている情報を基に広告を作成します。まずプランを作成して提示し、そのプランに沿って動画を生成します。そのため、商品カタログ全体で使えるほど低コストで、推測ではなく、販売している商品そのものを動画にできます。

無料で始められます。ウェルカムクレジットで最初の動画を作成でき、カード情報の入力も不要です。その後は、都度購入できるクレジットパック、または複数のブランドを運営する方向けのAgencyメンバーシップを利用できます。料金をご覧ください。

• 適した用途。 投稿内容を公開するスケジューラー（Postiz、Buffer）と併用できます。どのフックが効果的だったかを示すアトリビューションツールとも併用できます。商品ページはあるものの映像素材がない場合は、動画編集ツールの代わりになります。
• 適さない用途。 映画のようなヒーロー動画。スクリプトを読むプレゼンター。横向きの4K動画。ページも写真もない商品。
• 対象ユーザー。 Shopifyの販売者、ドロップシッパー、複数のストアのソーシャル運用を同時に行うブランドや代理店。

プロダクトサーバーはホスト型のままです。 このリポジトリには、接続ガイド、レジストリのメタデータ、HTTP クライアントのサンプル、リモートサーバーに直接接続できないクライアント向けの小規模なオープンソース stdio アダプターが含まれています。このアダプターは、生成済みのスナップショットを使って初期化、ping、ツールの検出に応答し、認証済みのツール呼び出しをホストされたエンドポイントに送信します。ホスト型サーバーが引き続き唯一の情報源であり、プロダクトの実装はこのリポジトリに複製されていません。

エンドポイント

エンドポイント	https://app.instantclips.ai/mcp
トランスポート	Streamable HTTP、ステートレス
メソッド	POST、JSON-RPC 2.0
認証	クライアントから求められたらサインイン（OAuth 2.1）するか、ブラウザーを使わない呼び出し元は Authorization: Bearer <token> を使用します

アシスタントにアドレスを1つ貼り付け、求められたらサインインしてください。設定はこれだけです。初回の呼び出し時に、サーバーから InstantClips へのサインインとアシスタントの承認を求められます。コピーするキーはありません。承認したアシスタントは設定の Authorized apps に一覧表示され、接続を解除できます。

接続先はご自身のアカウントです。ウェブアプリと同じブランド、商品、クレジット、プランの制限が適用されます。アカウントをお持ちでない場合は、サインイン時にアカウントが作成され、最初の動画用のクレジットが付与されます。

ブラウザーでエンドポイントを開くと、プロトコルエラーではなくセットアップページが表示されます。Cursor と VS Code 用のワンクリックインストールボタンもあります。

インストール

クライアントが Streamable HTTP に対応している場合は、ホスト型エンドポイントに直接接続してください。初回の使用時にサインイン画面が表示されます。トークンと stdio アダプター（下の「ブラウザーを使わない場合」を参照）は、サインインページを開けないスクリプトや自動実行環境でのみ使用してください。

Claude Code

claude mcp add --transport http --scope user instantclips https://app.instantclips.ai/mcp

次に、Claude Code 内で /mcp を実行し、instantclips を選択してサインインしてください。--scope user を指定すると、すべてのプロジェクトに追加されます。指定しない場合、Claude Code はコマンドを実行したフォルダーにのみサーバーを追加します。

Codex

Codex CLI、Codex IDE 拡張機能、ChatGPT デスクトップアプリがすべて読み込む ~/.codex/config.toml に追加します。

[mcp_servers.instantclips]
url = "https://app.instantclips.ai/mcp"

次に、codex mcp login instantclips を実行してサインインします。

Cursor と VS Code

ワンクリックインストールボタンはセットアップページにあります。ボタンを押すとアプリが開き、InstantClips が追加され、初回使用時にサインインできます。

Claude アプリ

1. カスタマイズ › コネクターで、+ › カスタムコネクターを追加を選択し、https://app.instantclips.ai/mcp を貼り付けて、追加を選択します。
2. 接続を選択し、InstantClips にサインインします。
3. 会話で、+ › コネクターから InstantClips をオンにします。

Team または Enterprise プランの場合、オーナーがまず組織の設定 › コネクターから追加し、その後、各メンバーがカスタマイズ › コネクターで接続します。

ChatGPT

1. chatgpt.com で、設定 › セキュリティとログインから開発者モードをオンにします。
2. chatgpt.com/plugins を開き、**+**を選択して、OAuth を使用する https://app.instantclips.ai/mcp のアプリを作成します。求められたら InstantClips にサインインします。
3. 会話で、+メニューから開発者モードを選択し、InstantClips を選択します。

Business、Enterprise、または Edu ワークスペースの場合、管理者がワークスペースの設定 › アプリ › 作成からアプリを作成し、ワークスペースに公開します。

ChatGPT では、製品写真を会話に添付して動画を依頼します。このプラグインは添付ファイルを直接受け取るため（create_product_from_images の image_files、update_product の add_image_files）、写真にアダプターは不要で、トークンも必要ありません。

メニュー名は、2026年9月時点での各アプリの名称です。場所が変更されている場合は、Claude のカスタムコネクターガイドと OpenAI の開発者モードガイドで最新の情報を確認できます。

その他の MCP クライアントまたはエージェント

OpenClaw、Hermes、または自作のエージェントの場合は、Streamable HTTP 経由でこのアドレスを指定します。サーバーは標準的な方法でサインインフローを通知するため、仕様に準拠したクライアントであれば、ほかに必要なものはありません。サインインページを開けない場合は、以下のトークンを使用します。

ブラウザーがない場合：アクセストークンを使用する

サインインページを開けないスクリプト、CI ジョブ、エージェントは、代わりに長期間有効なトークンで認証します。トークンは**app.instantclips.ai/settings#ai-access**で発行します。このトークンはアカウントへのフルアクセスを許可するため、コミットするものに含めないでください。

トークンを使う場合、同じクライアントは次のようになります。

# Claude Code
claude mcp add --transport http --scope user instantclips https://app.instantclips.ai/mcp --header "Authorization: Bearer YOUR_TOKEN"

# Codex, in ~/.codex/config.toml
[mcp_servers.instantclips]
url = "https://app.instantclips.ai/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

Codex のファイルにトークンを記載しないようにするには、ヘッダーを bearer_token_env_var = "INSTANTCLIPS_TOKEN" に置き換え、代わりにシェルで環境変数をエクスポートします。その他のクライアントでは、Authorization: Bearer ヘッダーを送信します。通信内容に InstantClips 固有のものはありません。チャットアプリは常にサインイン用のブラウザーを利用できるため、トークンではなく上記の手順を使用します。

Stdio 専用クライアントとヘッドレスランナー

instantclips-mcp npm パッケージは、stdio から HTTPS への軽量なアダプターです。高速で認証情報不要のコールドスタートを実現するため、初期化とツールの検出をローカルで処理し、その後、環境変数からトークンを読み取り、ツール呼び出しを InstantClips に送信します。

{
  "mcpServers": {
    "instantclips": {
      "command": "npx",
      "args": ["-y", "instantclips-mcp"],
      "env": {
        "INSTANTCLIPS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

ライブのツール名も含めて接続を自動で確認するには、次のようにします。

INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json

トークンは INSTANTCLIPS_TOKEN 経由でのみ受け付けられ、コマンドライン引数では受け付けられません。そのため、プロセス一覧には表示されません。ツール呼び出しには必要ですが、initialize、ping、tools/list には必要ありません。Node.js 20 以降が必要です。

このマシン上の写真：アダプター自身が写真をアップロードできるため、ノートパソコンから一度も外に出ていないファイルを使って動画を作成できます。アダプター経由では、create_product_from_images の image_urls の代わりに image_paths（ファイルのパス。最大9枚、各8 MB）を指定でき、update_product では add_image_paths を指定できます。ファイルはパッケージ化され、商品の写真として InstantClips に直接送信されます。どこからもダウンロードされません。ファイルを、アシスタントにパスを渡すクライアント（Claude Code、Cursor、VS Code、ターミナルエージェント）にドラッグし、作りたいものを伝えてください。image_paths のみを送信してください。同じ呼び出しでホストされた image_urls も指定すると、URL が破棄されることなくアダプターがリクエストを拒否します。ホストされた写真は、後から update_product で追加してください。

スタータープロンプト

まずは次の5つをお試しください。リンクまたは商品名を入れ替えてください。

1. 「この商品の動画広告を作成してください：[URL]」
2. 「このコレクションページにあるすべての商品をインポートし、すべての商品についてプランを作成してください。まだ何も生成しないでください。」
3. 「[商品] のプランを見せて、価格を最初に伝える形にフックを書き換えてください。」
4. 「テストできるよう、フックをそれぞれ変えて、[URL] の動画を3本作成してください。」
5. 「この商品はどのブランド向けですか？それから動画を作成してください。」

ツール

ワークフローの順序は次のとおりです。

1. インポート — ストアの商品ページには import_product_from_url を、読み取れるページがない場合は create_product_from_images を使います。
2. インポートを待つ — import_status が "imported" になるまで get_product をポーリングします。
3. アイデアを選んでから、プランを確認 — ウェブサイトと同じように、商品の ideas を提示します。ユーザーが選んだもの、またはユーザー自身の言葉を update_video_direction の creator_note に渡してプランを作成します。アイデアを指定せずに redraft_video_direction を呼び出すと、ユーザーに代わってアイデアが選ばれます。プランはユーザーが確認できるテキストとして返され、update_video_direction で内容を変更できます。
4. 生成 — get_product が報告した、ユーザーに伝えたコストを expected_credit_cost として渡し、generate_video を呼び出します。コストが一致しない場合、課金せずに拒否されます。
5. 受け取る — 完了するまで get_video をポーリングし、download_url、動画専用ページ、公開共有リンクをユーザーに渡します。

同じ商品について別の動画を作成する場合も、その商品の同じワークフローに従います。編集または再ドラフトを行うと次の動画のドラフトが開き、ドラフトなしで generate_video を呼び出すと、最後のプランで別のテイクがレンダリングされます。生成済みの動画自体は変更できません。すべての get_product の応答には、次に行う操作を示す next_step が含まれます。ユーザーが動画を視聴したら、rate_video で評価を記録できます。ツール自体についてチームにメモを送信するには、ユーザーの許可を得て send_feedback を使います。

ブランドも同じ方法で扱います：list_brands、create_brand、set_product_brand。すべての動画はブランドのトーンでドラフトされます。そのため、ストアフロントが既存のどのブランドとも一致しない商品をインポートすると、推測せずに処理を止めて確認を求めます。

各ツールの正確なパラメーターは、ホストされたサーバーで公開されています。生成された manifest/instantclips-mcp.json スナップショットを使えば、stdio クライアントやレジストリから、認証情報なしで同じスキーマを確認できます。メンテナーは INSTANTCLIPS_TOKEN="..." npm run sync:manifest で更新できます。コミット済みのスナップショットがライブサーバーと異なる場合、npm run check:manifest は失敗します。ライブスキーマを HTTP 経由で表示したい場合に限り、以下の python example.py tools を実行してください。

クレジット

商品のインポート、プランの作成、編集はすべて無料です。クレジットを消費するのは generate_video ツールのみで、実行には明示的な承認が必要です。ツールはまずコストを報告し、generate_video はその数値を expected_credit_cost として受け取り、コストが変わっている場合は実行を拒否します。エージェントが気づかないうちに請求額を増やすことはありません。料金をご覧ください。

example.py

依存関係のない MCP クライアントです。Python 3.9 以降が必要で、標準ライブラリのみを使用するため、pip install は不要です。スクリプトからはブラウザーでサインインできないため、トークンで認証します。

export INSTANTCLIPS_TOKEN="your-token"

python example.py tools                 # every tool, with its live input schema
python example.py call list_brands '{}' # call one tool with JSON arguments

最初に実行するのは tools です。すべてのツールの実際のパラメーター名と型が表示されるため、上記のワークフローをスクリプト化する前に確認できます。

リンク

• instantclips.ai/automate — 自動化の目的を説明しています。ストアページ、スタータープロンプト、ツールの実行順序、ルールを使って作成した実例を紹介しています。セットアップの説明は繰り返していません。セットアップについては、このファイルとアプリのセットアップページをご覧ください。
• app.instantclips.ai/llms.txt — 製品とツールの実行順序を機械可読形式で説明しています。
• 利用規約 · プライバシー

レジストリ

server.json は、他のディレクトリが取り込む公式 MCP レジストリに登録されている、このサーバーのエントリーです。ai.instantclips/instantclips のエントリーひとつに、remotes のホスト型エンドポイントと packages の stdio アダプターの両方が含まれているため、同じツールサーフェスに対して ID を二つ作らずに、ホストはサポートしているトランスポートを選択できます。

npm パッケージの mcpName は、このレジストリ名と完全に一致している必要があります。リポジトリへのリンク先はオープンソースのアダプターです。ホスト型製品の実装はこのリポジトリには含まれていません。

ai.instantclips 名前空間はドメインの逆引き DNS 名であるため、GitHub 認証ではなく、DNS または HTTP ドメイン認証を使って公開する必要があります。代わりに GitHub で認証すると、エントリーは io.github.instantstudioai/... になり、ブランド名の名前空間を使えなくなります。

まず npm パッケージを公開し、version を更新した後、mcp-publisher publish で同じレジストリエントリーを再公開します。ドメイン認証を使うことで、ブランド名の ai.instantclips 名前空間が維持されます。io.github.* の名前に置き換えないでください。署名キーはリポジトリの外で管理します。.gitignore では *.pem を除外しており、コミットされた秘密鍵は公開されたものと同じです。

npm への公開はノート PC からではなく、GitHub Actions で行います。バージョン更新をコミットし（package.json、server.json、test/shim.test.js 内の固定値）、そのバージョン名のタグをプッシュします（git tag v1.7.2 && git push origin main v1.7.2）。.github/workflows/publish.yml がテストを実行し、npm の信頼済み公開を通じて、npm トークンもブラウザーでの確認も使わずに公開します。タグが package.json の version と一致しない場合、ジョブは停止します。npmjs.com のパッケージに設定されている信頼済み公開元は、このリポジトリと publish.yml を指定しているため、ワークフローファイルの名前を変更すると公開できなくなります。

npm に新しいバージョンが表示されるまで数分かかる場合があります。また、レジストリは npm で確認できないバージョンのエントリーを拒否します（「version … was not found」となり、変更はありません）。https://registry.npmjs.org/instantclips-mcp/<version> から応答が返るようになったら、mcp-publisher の手順を実行してください。

ログインから公開までを一つのコマンドで実行してください。レジストリトークンはログインから 5 分後に期限切れになります。また、ドメインは DNS ではなく HTTP で検証されます。マーケティングサイトの instantclips.ai/.well-known/mcp-registry-auth では、このキーの公開鍵部分（v=MCPv1; k=ed25519; p=…）が配信されます。TXT レコードはないため、login dns は「no MCP public key found」というエラーで失敗します。

mcp-publisher login http --domain instantclips.ai \
  --private-key "$(openssl pkey -in key.pem -text -noout | awk '/priv:/{f=1;next} /pub:/{f=0} f' | tr -d ' :\n')" \
  && mcp-publisher publish

test/shim.test.js では、スナップショットのサーバーバージョンと server.json の version が固定されています。リリース時には、両方を更新します。

glama.json は、Glama の掲載を申請するための、Glama 専用の別ファイルです。個人アカウントではなく組織のサーバーは、このファイルがある場合にのみ申請できます。このファイルが示すのは所有権だけです。Glama の Dockerfile 形式では、ビルド手順に ["npm install --omit=dev"]、CMD 引数に ["node", "./bin/instantclips-mcp.js"] を使い、必須の INSTANTCLIPS_TOKEN プレースホルダーには任意のダミー値を指定してください。Glama の初期化チェックとツール品質チェックでは、同梱されたマニフェストが使われ、プレースホルダーが上流に送信されることはありません。サードパーティのビルド用サンドボックスに、実際のアカウントトークンを入れないでください。

ライセンス

MIT — 詳しくは LICENSE をご覧ください。ライセンスはこのリポジトリの内容を対象とします。ホスト型サービスの利用には、利用規約が適用されます。