AiVideoEditor
無料で始める
メニュー

確認日2026-11-10 · API版2026-11-09 · Markdownを読む

MCP セットアップ

UI と REST API と同じ共有サービスを /api/v1 経由でラップする、ローカルの stdio MCP サーバーです。 アダプタはプロダクトキーを、設定された AiVideoEditor API にのみ送信します。 Supabase やプロバイダーの資格情報は使用しません。

前提条件

これは公開パッケージやホステッド接続ではなく、ソースチェックアウトのアダプタです。 AiVideoEditor リポジトリへの許可されたアクセスを取得し、Node 22+ をインストールし、 リポジトリのルートで npm ci を実行してください。/app/developers で、必要なスコープと宛先アクセスのみを持つワークスペースのプロダクトキーを作成します。下書き専用の キーは公開や予約ができません。キーをチャットプロンプトに貼り付けないでください。

実行する

export PUBLISHER_API_URL=https://app.example.com   # HTTPS; http://localhost is allowed for dev
export PUBLISHER_API_KEY=pk_v1_…                   # create in /app/developers
node packages/mcp/bin/publisher-mcp.mjs            # or: npm start --workspace packages/mcp

bin は実際の実行可能ランチャーです (TypeScript と拡張子なしのインポートは tsx を通じて解決されます)。すべての診断出力は stderr に送られ、stdout は プロトコル通信専用です。PUBLISHER_API_URL は HTTPS でなければならず (平文 HTTP は ループバック開発のみ許可)、資格情報、クエリ、フラグメントを含んではなりません。

汎用クライアント設定

{
  "mcpServers": {
    "autoposted": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/bin/publisher-mcp.mjs"],
      "env": {
        "PUBLISHER_API_URL": "https://app.example.com",
        "PUBLISHER_API_KEY": "pk_v1_…"
      }
    }
  }
}

ランチャーには Node 22+ とワークスペースの依存関係 (tsx、 @modelcontextprotocol/sdk) が必要です。OAuth を伴うホステッド MCP トランスポートは将来の作業です。 すべてのデスクトップクライアントやホステッドクライアントが貼り付けたベアラーキーをサポートすると想定しないでください。

ツール

ツールRead/Mutate備考
list_accountsreadキーのアカウント許可リストに従う
get_capabilitiesreadフォーマット、制限、同意要件
create_upload_intentmutateダイレクトアップロード手順を返す。メディアのバイト列がツールを経由することはない
finalize_uploadmutateセッション ID (+ マルチパートのパートレシート)。サーバー自身がバイト/MIME を観察する
create_draftmutateソース + 宛先バリアント
validate_postread構造化された宛先ごとの問題
schedule_postmutate1 つの時刻、90 日以内、expectedVersion が必須
publish_postmutate202 のセマンティクス。公開の証拠ではない
get_post_statusread宛先ごとの状態とネイティブリンク
list_postsreadカーソルページネーション
cancel_deliverymutate安全に未処理の間のみ
retry_deliverymutate既知の失敗のみ。決して重複させない
get_usageread残り投稿数カウンターは存在しない

必須のツール引数

ツール必須引数
list_accountsなし
get_capabilitiesなし
create_upload_intentfilename、declaredMime、declaredBytes
finalize_uploadassetId、sessionId
create_draftcaption、destinations
validate_postpostId
schedule_postpostId、scheduledAt、timezone、expectedVersion
publish_postpostId
get_post_statuspostId
list_postsなし
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageなし

オプション引数には、リスト系ツールのページネーション、ミューテーションの idempotencyKey、 マルチパート確定のための multipart.parts、下書きのメディアと宛先の バリアントが含まれます。オプションフィールド、ネストされた形状、検証の制限については、 tools/list が返す実行時のツールスキーマが正です。

ミューテーションツールはオプションの idempotencyKey 引数を受け付けます。省略した場合、 サーバーが生成し、すべての結果にそれをエコーします。トランスポートの 失敗も含まれます。そこでは操作がすでに API に到達している可能性があります (エラー は transport_outcome_unknown とキーを含みます)。ツールがミューテーションを自動リトライすることは ありません。重複した操作を作らないため、同じ idempotency キー で再試行してください。

エージェントのワークフロー例

  1. list_accounts + get_capabilities → 有効な宛先を選択。
  2. create_upload_intent → バイト列を直接アップロード → finalize_upload。
  3. create_draft → validate_post → 無効な宛先を修正または選択解除。
  4. publish_post (または schedule_post) → 配信 ID を記録。
  5. get_post_status (上限付きポーリングまたはカスタマーウェブフック): requires_action の レスポンスは、TikTok の同意など、実行可能な指示として扱います。

テスト済みクライアント

  • 公式の @modelcontextprotocol/sdk TypeScript クライアントによる実際のサブプロセス stdio を、ドキュメント化された bin に対して (initialize → tools/list → tools/call) 実施。 packages/mcp/tests/stdio.test.ts で、クリーンな stdout と 起動失敗のチェックを含めてテスト済み。
  • インメモリトランスポート経由の公式 SDK クライアント: これもカバーされています。
  • デスクトップクライアント (Claude Desktop、Cursor など): 未テスト。上の汎用スニペットに従って設定し、 対応を主張する前に結果を報告してください。

クライアントの互換性

クライアントまたはトランスポート状態セットアップ
公式 TypeScript SDK のサブプロセス stdio自動テストでカバー上で示したリポジトリのランチャー
公式 SDK のインメモリトランスポート自動テストでカバーテストハーネスのみ
Claude Desktop / その他のデスクトップクライアント手動検証なしローカルの stdio 対応クライアント。ランチャーの絶対パスを使用
ChatGPT のホステッド接続このアダプタでは提供されないホステッドトランスポートが必要。ローカル stdio の JSON はホステッドコネクタではない
OAuth 付きホステッド MCP未実装別のプロダクト作業

トラブルシューティング

  • ランチャーが依存関係を解決できない: 許可されたソース チェックアウトで npm ci を実行し、Node のバージョンを確認してください。無関係な公開パッケージに置き換えないでください。
  • クライアントが初期化されない: ランチャーの絶対パスを使用し、stderr を確認してください。 デバッグ出力を stdout に書き込まないでください。
  • 401: 設定されたプロダクトキーが現行であることを確認してください。失効している場合は UI で代替キーを作成します。403: スコープとアカウント制限を確認してください。
  • transport_outcome_unknown: 返された冪等性キーを保持し、そのキーで 同一の操作を再試行してください。新しいキーは決して使わないでください。
  • requires_action: 提供された指示を権限のある人に引き渡してください。 エージェントが TikTok の人間の同意を提供することはできません。

資格情報の取り扱い

プロダクトキーは、設定された AiVideoEditor API (Authorization: Bearer) に のみ 送信されます。モデルプロバイダーや SNS に送信されることはなく、ログに記録されることもなく、URL は検証されるため、キーがリダイレクトに追従したり設定されたオリジンから逸脱したりすることはありません。