AiVideoEditor
Mulai gratis
Menu

Ditinjau 2026-11-10 · Versi API 2026-11-09 · Baca Markdown

Penyiapan MCP

Sebuah server MCP stdio lokal yang membungkus layanan bersama yang sama dengan UI dan REST API melalui /api/v1. Adaptor hanya mengirim kunci produk Anda ke API AiVideoEditor yang dikonfigurasi. Tidak ada kredensial Supabase atau penyedia yang digunakan.

Prasyarat

Ini adalah adaptor dari checkout sumber, bukan paket yang dipublikasikan atau koneksi hosting. Dapatkan akses resmi ke repositori AiVideoEditor, instal Node 22+, dan jalankan npm ci di akar repositori. Buat kunci produk ruang kerja di /app/developers hanya dengan cakupan dan akses tujuan yang diperlukan. Kunci khusus draf tidak dapat menerbitkan atau menjadwalkan. Jangan pernah menempelkan kunci ke prompt obrolan.

Menjalankannya

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 adalah launcher executable sungguhan (TypeScript + import tanpa ekstensi diselesaikan melalui tsx). Semua diagnostik menuju stderr; stdout hanya membawa trafik protokol. PUBLISHER_API_URL harus HTTPS (HTTP biasa hanya untuk pengembangan loopback) dan tidak boleh membawa kredensial, kueri, atau fragmen.

Konfigurasi klien generik

{
  "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_…"
      }
    }
  }
}

Launcher memerlukan Node 22+ dan dependensi ruang kerja (tsx, @modelcontextprotocol/sdk). Transport MCP hosting dengan OAuth adalah pekerjaan mendatang; jangan berasumsi setiap klien desktop atau hosting mendukung bearer key yang ditempelkan.

Alat

AlatBaca/MutasiCatatan
list_accountsreadMenghormati daftar izin akun kunci
get_capabilitiesreadFormat, batasan, persyaratan persetujuan
create_upload_intentmutateMengembalikan instruksi unggahan langsung; byte media tidak pernah mengalir melalui alat
finalize_uploadmutateID sesi (+ tanda terima bagian multipart); server mengamati byte/MIME sendiri
create_draftmutateSumber + varian tujuan
validate_postreadIsu terstruktur per tujuan
schedule_postmutateSatu waktu instan, ≤90 hari ke depan, expectedVersion wajib
publish_postmutateSemantik 202; bukan bukti penerbitan
get_post_statusreadStatus per tujuan dan tautan asli
list_postsreadPaginasi kursor
cancel_deliverymutateHanya selama belum diambil secara aman
retry_deliverymutateHanya kegagalan yang diketahui; tidak pernah menduplikasi
get_usagereadTidak ada penghitung posting tersisa

Argumen alat yang wajib

AlatArgumen wajib
list_accountsTidak ada
get_capabilitiesTidak ada
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsTidak ada
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageTidak ada

Argumen opsional mencakup paginasi pada alat daftar, idempotencyKey pada mutasi, multipart.parts untuk finalisasi multipart, serta media draf dan varian tujuan. Skema alat runtime yang dikembalikan oleh tools/list bersifat otoritatif untuk field opsional, bentuk bersarang, dan batasan validasi.

Alat mutasi menerima argumen opsional idempotencyKey. Bila dihilangkan, server membuat satu dan menampilkannya di setiap hasil: termasuk kegagalan transport, di mana operasi mungkin sudah mencapai API (kesalahan membawa transport_outcome_unknown beserta kuncinya). Alat tidak pernah mencoba ulang mutasi secara otomatis; coba ulang dengan kunci idempotensi YANG SAMA untuk menghindari pembuatan operasi duplikat.

Contoh alur kerja agen

  1. list_accounts + get_capabilities → pilih tujuan yang valid.
  2. create_upload_intent → unggah byte secara langsung → finalize_upload.
  3. create_draft → validate_post → perbaiki atau batalkan pilihan tujuan yang tidak valid.
  4. publish_post (atau schedule_post) → catat ID pengiriman.
  5. get_post_status (polling berbatas atau webhook pelanggan): perlakukan respons requires_action sebagai instruksi yang dapat ditindaklanjuti, mis. persetujuan TikTok.

Klien yang diuji

  • Klien TypeScript resmi @modelcontextprotocol/sdk, subprocess stdio nyata terhadap bin yang didokumentasikan (initialize → tools/list → tools/call): diuji di packages/mcp/tests/stdio.test.ts, termasuk pemeriksaan stdout bersih dan kegagalan startup.
  • Klien SDK resmi melalui transport in-memory: juga tercakup.
  • Klien desktop (Claude Desktop, Cursor, dll.): belum diuji: konfigurasikan sesuai cuplikan generik di atas dan laporkan hasilnya sebelum mengklaim dukungan.

Kompatibilitas klien

Klien atau transportStatusPenyiapan
SDK TypeScript resmi subprocess stdioCakupan uji otomatisLauncher repositori yang ditunjukkan di atas
Transport in-memory SDK resmiCakupan uji otomatisHanya harness pengujian
Claude Desktop / klien desktop lainnyaBelum diverifikasi manualKlien lokal yang mampu stdio; gunakan jalur launcher absolut
Koneksi hosting ChatGPTTidak disediakan adaptor iniMemerlukan transport hosting; JSON stdio lokal bukan konektor hosting
MCP hosting dengan OAuthBelum diimplementasikanPekerjaan produk terpisah

Pemecahan masalah

  • Launcher tidak dapat menyelesaikan dependensi: jalankan npm ci di checkout sumber resmi dan periksa versi Node. Jangan mengganti dengan paket publik yang tidak terkait.
  • Klien tidak pernah terinisialisasi: gunakan jalur launcher absolut dan periksa stderr. Jangan menulis keluaran debug ke stdout.
  • 401: verifikasi kunci produk yang dikonfigurasi masih berlaku; buat pengganti di UI jika dicabut. 403: periksa cakupan dan pembatasan akun.
  • transport_outcome_unknown: simpan kunci idempotensi yang dikembalikan dan coba ulang operasi identik dengan kunci itu, bukan kunci baru.
  • requires_action: serahkan instruksi yang diberikan kepada orang berwenang; agen tidak dapat memberikan persetujuan manusia TikTok.

Penanganan kredensial

Kunci produk dikirim hanya ke API AiVideoEditor yang Anda konfigurasikan (Authorization: Bearer). Kunci tidak pernah dikirim ke penyedia model atau jaringan sosial, tidak pernah dicatat, dan URL divalidasi sehingga kunci tidak dapat mengikuti pengalihan atau lolos dari origin yang dikonfigurasi.