確認日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_accounts | read | キーのアカウント許可リストに従う |
get_capabilities | read | フォーマット、制限、同意要件 |
create_upload_intent | mutate | ダイレクトアップロード手順を返す。メディアのバイト列がツールを経由することはない |
finalize_upload | mutate | セッション ID (+ マルチパートのパートレシート)。サーバー自身がバイト/MIME を観察する |
create_draft | mutate | ソース + 宛先バリアント |
validate_post | read | 構造化された宛先ごとの問題 |
schedule_post | mutate | 1 つの時刻、90 日以内、expectedVersion が必須 |
publish_post | mutate | 202 のセマンティクス。公開の証拠ではない |
get_post_status | read | 宛先ごとの状態とネイティブリンク |
list_posts | read | カーソルページネーション |
cancel_delivery | mutate | 安全に未処理の間のみ |
retry_delivery | mutate | 既知の失敗のみ。決して重複させない |
get_usage | read | 残り投稿数カウンターは存在しない |
必須のツール引数
| ツール | 必須引数 |
|---|---|
list_accounts | なし |
get_capabilities | なし |
create_upload_intent | filename、declaredMime、declaredBytes |
finalize_upload | assetId、sessionId |
create_draft | caption、destinations |
validate_post | postId |
schedule_post | postId、scheduledAt、timezone、expectedVersion |
publish_post | postId |
get_post_status | postId |
list_posts | なし |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | なし |
オプション引数には、リスト系ツールのページネーション、ミューテーションの idempotencyKey、
マルチパート確定のための multipart.parts、下書きのメディアと宛先の
バリアントが含まれます。オプションフィールド、ネストされた形状、検証の制限については、
tools/list が返す実行時のツールスキーマが正です。
ミューテーションツールはオプションの idempotencyKey 引数を受け付けます。省略した場合、
サーバーが生成し、すべての結果にそれをエコーします。トランスポートの
失敗も含まれます。そこでは操作がすでに API に到達している可能性があります (エラー
は transport_outcome_unknown とキーを含みます)。ツールがミューテーションを自動リトライすることは
ありません。重複した操作を作らないため、同じ idempotency キー で再試行してください。
エージェントのワークフロー例
list_accounts+get_capabilities→ 有効な宛先を選択。create_upload_intent→ バイト列を直接アップロード →finalize_upload。create_draft→validate_post→ 無効な宛先を修正または選択解除。publish_post(またはschedule_post) → 配信 ID を記録。get_post_status(上限付きポーリングまたはカスタマーウェブフック):requires_actionの レスポンスは、TikTok の同意など、実行可能な指示として扱います。
テスト済みクライアント
- 公式の
@modelcontextprotocol/sdkTypeScript クライアントによる実際のサブプロセス 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 は検証されるため、キーがリダイレクトに追従したり設定されたオリジンから逸脱したりすることはありません。