MCPクイックスタートと提供状況
リモートMCPへOAuthで接続し、画像転送と承認済み見積もりから成果物保存まで安全に進めます。
このページの目次
公開ベータとして利用可能
公式リモートMCPはhttps://api.animgen.com/mcpで提供中です。Streamable HTTP対応クライアント、OAuth、認証済みAnimGenアカウントを使います。登録者には基準の開発者上限があり、有効な購読で上がります。
MCPサーバーはリモートです。AIがローカルパスを知ってもPCのファイルは読めません。OAuthはアクセス許可であり、画像アップロードやクレジット支出の承認ではありません。
最初の接続
- Codexなどの接続手順で正しいURLを登録し、OAuthを完了します。
- 認可画面でAnimGenアカウントと要求スコープを確認します。
- 空の引数で
list_modelsを呼び、読み取りだけを確認します。 - クライアントがローカル画像の実バイトを転送し、ダウンロードを保存できるか確かめます。
- 具体的なリクエストを見積もり、有料生成前に承認を得ます。
https://animgen.com/mcp/tools.jsonは文書用マニフェストで接続先ではありません。OAuthをAPIキーで代用しないでください。
主なツールの権限
| スコープ | ツール |
|---|---|
models:read |
list_models |
files:write |
prepare_image_upload、complete_image_upload |
animations:read |
get_animation |
animations:write |
quote_animation、generate_animation、cancel_animation |
assets:read |
download_asset |
この表はワンクリックの流れを示します。段階的な動画生成、プレビュー、書き出しには同じスコープの追加ツールがあります。登録済みの各ツールは生成された参考と、実際の引数・結果・安全注釈を持つ機械可読マニフェストに掲載されています。生成にはアカウント資格、十分な残高、明示的な支出承認が必要です。
AIへの安全な最初の指示
Use the connected AnimGen MCP to inspect current models first.
After I provide an image and intended output, explain the upload steps
and prepare a quote for the exact supported request.
Do not generate or spend credits until I approve that request and amount.
Persist the request and idempotency key. Keep credentials and signed URLs private.
標準ワークフローに従いバイト転送、見積もり、生成、状態確認、保存を進めます。支出保護を読み、quote_idまたはmax_creditsがrequestと同じ階層に必要で、認可は支出承認ではないことを確認してください。
実際の制作例を確認する
透過キャラクターのMCP実例(英語)はモデル取得、実バイト転送、36クレジットの承認、終状態までの確認、ローカル保存、画素検査を記録しています。最初のシートには縦横比の書き出し不具合があり、同じ元MP4からモデル再実行や追加クレジットなしで再書き出しした例でもあります。見た目の検査が必要な理由を示します。
権限と失敗を管理する
アカウント → 開発者で連携アプリを確認・失効できます。失効は受理済みタスクを中止しません。接続、アップロード、見積もりの問題はAPI/MCPのトラブル対応を参照してください。公開ベータで利用可能でも、すべてのクライアント、入力、描画先が検証済みという意味ではありません。部分成果物と実際の状態を確認し、モデル一覧取得を完全な生成試験とみなさないでください。
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー