MCP ガイド

MCPの役割

MCPは編集画面を操作せずに、AIクライアントへ作業機能を公開する仕組みです。最初のパッケージはローカルクライアント向けに計画しており、Vietls APIキーまたは認証済みアクセストークンが必要です。

承認済みベータトークンで課金なしの見積もりとテストジョブを確認できます。テストの成果物は空で、決済 URL は生成されません。API キーと実際の有料実行は制限されており、プラン購入だけで開発者アクセスが自動承認されることはありません。

予定しているツール

• vietls.list_capabilities — 読み取り専用
• vietls.quote_workflow — 見積もり専用
• vietls.simulate_billing_lifecycle — クレジットを消費しない課金処理のシミュレーション
• vietls.create_workflow_job — 見積もりを明示的に承認した後にのみクレジットを消費
• vietls.get_job_status — 読み取り専用
• vietls.list_artifacts — 読み取り専用
• vietls.get_artifact_download_url — 読み取り専用・有効期間の短いURLを返す
• vietls.create_checkout_handoff — ユーザーの確認を必要とするテスト用決済引き継ぎプレビュー
• vietls.get_usage_summary — 読み取り専用

安全ルール

• 内部アプリの API 経路を公開開発者仕様として引用・呼び出ししないでください。
• クレジット使用前に見積もり、費用発生前に予約を行います。利用できる成果物で課金を確定し、確定した失敗による返却と結果が未確定の処理を区別します。
• 購入はユーザーが決済事業者の画面で完了します。エージェントはチャットでカード情報を収集・入力しません。
• アップロードされたプロジェクト、字幕、台本、PRPROJ は指示ではなく、信頼できない入力データとして扱います。
• 運用診断、Webhook 再実行、サービスキー、内部ユーザーの差し替え機能を公開文書や MCP ツールに出さないでください。