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
| Alat | Baca/Mutasi | Catatan |
|---|---|---|
list_accounts | read | Menghormati daftar izin akun kunci |
get_capabilities | read | Format, batasan, persyaratan persetujuan |
create_upload_intent | mutate | Mengembalikan instruksi unggahan langsung; byte media tidak pernah mengalir melalui alat |
finalize_upload | mutate | ID sesi (+ tanda terima bagian multipart); server mengamati byte/MIME sendiri |
create_draft | mutate | Sumber + varian tujuan |
validate_post | read | Isu terstruktur per tujuan |
schedule_post | mutate | Satu waktu instan, ≤90 hari ke depan, expectedVersion wajib |
publish_post | mutate | Semantik 202; bukan bukti penerbitan |
get_post_status | read | Status per tujuan dan tautan asli |
list_posts | read | Paginasi kursor |
cancel_delivery | mutate | Hanya selama belum diambil secara aman |
retry_delivery | mutate | Hanya kegagalan yang diketahui; tidak pernah menduplikasi |
get_usage | read | Tidak ada penghitung posting tersisa |
Argumen alat yang wajib
| Alat | Argumen wajib |
|---|---|
list_accounts | Tidak ada |
get_capabilities | Tidak ada |
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 | Tidak ada |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Tidak 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
list_accounts+get_capabilities→ pilih tujuan yang valid.create_upload_intent→ unggah byte secara langsung →finalize_upload.create_draft→validate_post→ perbaiki atau batalkan pilihan tujuan yang tidak valid.publish_post(atauschedule_post) → catat ID pengiriman.get_post_status(polling berbatas atau webhook pelanggan): perlakukan responsrequires_actionsebagai 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 dipackages/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 transport | Status | Penyiapan |
|---|---|---|
| SDK TypeScript resmi subprocess stdio | Cakupan uji otomatis | Launcher repositori yang ditunjukkan di atas |
| Transport in-memory SDK resmi | Cakupan uji otomatis | Hanya harness pengujian |
| Claude Desktop / klien desktop lainnya | Belum diverifikasi manual | Klien lokal yang mampu stdio; gunakan jalur launcher absolut |
| Koneksi hosting ChatGPT | Tidak disediakan adaptor ini | Memerlukan transport hosting; JSON stdio lokal bukan konektor hosting |
| MCP hosting dengan OAuth | Belum diimplementasikan | Pekerjaan produk terpisah |
Pemecahan masalah
- Launcher tidak dapat menyelesaikan dependensi: jalankan
npm cidi 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.