AiVideoEditor
Ücretsiz başlayın
Menü

İnceleme 2026-11-10 · API sürümü 2026-11-09 · Markdown oku

MCP kurulumu

UI ve REST API ile aynı paylaşılan servisleri /api/v1 üzerinden saran yerel bir stdio MCP sunucusudur. Bağdaştırıcı ürün anahtarınızı yalnızca yapılandırılmış AiVideoEditor API'sine gönderir. Supabase veya sağlayıcı kimlik bilgileri kullanılmaz.

Önkoşullar

Bu, kaynak koddan kurulan bir bağdaştırıcıdır; yayımlanmış bir paket veya barındırılan bir bağlantı değildir. AiVideoEditor deposuna yetkili erişim elde edin, Node 22+ kurun ve depo kökünde npm ci çalıştırın. /app/developers içinde yalnızca gereken kapsamlarla ve hedef erişimiyle bir çalışma alanı ürün anahtarı oluşturun. Yalnızca taslak amaçlı bir anahtar yayınlayamaz veya zamanlayamaz. Anahtarı asla bir sohbet istemine yapıştırmayın.

Çalıştırma

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

İkili dosya gerçek bir çalıştırılabilir başlatıcıdır (TypeScript + uzantısız içe aktarmalar tsx ile çözülür). Tüm tanılamalar stderr gider; stdout yalnızca protokol trafiği taşır. PUBLISHER_API_URL HTTPS olmalıdır (düz HTTP yalnızca loopback geliştirmesi için) ve kimlik bilgisi, sorgu veya parça taşımamalıdır.

Genel istemci yapılandırması

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

Başlatıcı; Node 22+ ve çalışma alanı bağımlılıklarını (tsx, @modelcontextprotocol/sdk) gerektirir. OAuth'lu barındırılan MCP aktarımı gelecek bir çalışmadır; her masaüstü veya barındırılan istemcinin yapıştırılan bearer anahtarlarını desteklediğini varsaymayın.

Araçlar

AraçOku/MutasyonNotlar
list_accountsreadAnahtarın hesap izin listesine uyar
get_capabilitiesreadBiçimler, sınırlar, onay gereksinimleri
create_upload_intentmutateDoğrudan yükleme talimatları döndürür; medya baytları araçlardan asla geçmez
finalize_uploadmutateOturum kimliği (+ multipart parça makbuzları); sunucu bayt/MIME'ı kendisi gözlemler
create_draftmutateKaynak + hedef varyantları
validate_postreadYapılandırılmış hedef başına sorunlar
schedule_postmutateTek an, ≤90 gün ileri, expectedVersion gerekli
publish_postmutate202 semantiği; yayınlama kanıtı değil
get_post_statusreadHedef başına durumlar ve yerel bağlantılar
list_postsreadİmleç sayfalama
cancel_deliverymutateYalnızca güvenle talep edilmediği sürece
retry_deliverymutateYalnızca bilinen başarısızlıklar; asla çoğaltmaz
get_usagereadKalan paylaşım sayacı yoktur

Gerekli araç argümanları

AraçGerekli argümanlar
list_accountsYok
get_capabilitiesYok
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsYok
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageYok

İsteğe bağlı argümanlar; liste araçlarında sayfalamayı, mutasyonlarda idempotencyKey'yi, multipart sonlandırma için multipart.parts'ı ve taslak medya ile hedef varyantlarını içerir. tools/list tarafından döndürülen çalışma zamanı araç şeması; isteğe bağlı alanlar, iç içe biçimler ve doğrulama sınırları için yetkilidir.

Mutasyon araçları isteğe bağlı bir idempotencyKey argümanı kabul eder. Belirtilmediğinde sunucu bir tane oluşturur ve her sonuçta yankılar: taşıma başarısızlıkları dâhil; işlem API'ye zaten ulaşmış olabilir (hata, transport_outcome_unknown ve anahtarı taşır). Araçlar mutasyonları asla otomatik yeniden denemez; yinelenen bir işlem oluşturmamak için AYNI idempotency anahtarıyla yeniden deneyin.

Ajan iş akışı örneği

  1. list_accounts + get_capabilities → geçerli hedefleri seçin.
  2. create_upload_intent → baytları doğrudan yükleyin → finalize_upload.
  3. create_draft → validate_post → geçersiz hedefleri düzeltin veya seçimden çıkarın.
  4. publish_post (veya schedule_post) → teslim kimliklerini not edin.
  5. get_post_status (sınırlı yoklama veya müşteri webhook'ları): requires_action yanıtlarını eyleme dönük talimatlar olarak değerlendirin, örn. TikTok onayı.

Test edilen istemciler

  • Resmî @modelcontextprotocol/sdk TypeScript istemcisi, belgelenen ikiliye karşı gerçek subprocess stdio (initialize → tools/list → tools/call): packages/mcp/tests/stdio.test.ts içinde test edildi; temiz-stdout ve başlatma-başarısızlık kontrolleri dâhil.
  • Bellek içi aktarım üzerinden resmî SDK istemcisi: o da kapsanır.
  • Masaüstü istemciler (Claude Desktop, Cursor vb.): henüz test edilmedi: yukarıdaki genel parçacığa göre yapılandırın ve destek iddiasında bulunmadan önce sonuçları raporlayın.

İstemci uyumluluğu

İstemci veya aktarımDurumKurulum
Resmî TypeScript SDK subprocess stdioOtomatik test kapsamıYukarıda gösterilen depo başlatıcısı
Resmî SDK bellek içi aktarımOtomatik test kapsamıYalnızca test düzeneği
Claude Desktop / diğer masaüstü istemcilerManuel doğrulanmadıYerel stdio destekli istemci; mutlak başlatıcı yolunu kullanın
ChatGPT barındırılan bağlantıBu bağdaştırıcı tarafından sağlanmazBarındırılan aktarım gerektirir; yerel stdio JSON barındırılan bir bağlayıcı değildir
OAuth'lu barındırılan MCPUygulanmadıAyrı ürün çalışması

Sorun giderme

  • Başlatıcı bağımlılıkları çözemez: yetkili kaynak kontrolünde npm ci çalıştırın ve Node sürümünü kontrol edin. İlişkisiz bir genel paketle değiştirmeyin.
  • İstemci hiç başlatılmıyor: mutlak başlatıcı yolunu kullanın ve stderr'i inceleyin. Hata ayıklama çıktısını stdout'a yazmayın.
  • 401: yapılandırılmış ürün anahtarının geçerli olduğunu doğrulayın; iptal edildiyse arayüzde bir yedek oluşturun. 403: kapsamları ve hesap kısıtlamalarını kontrol edin.
  • transport_outcome_unknown: döndürülen idempotency anahtarını saklayın ve özdeş işlemi o anahtarla yeniden deneyin, asla yeni bir anahtarla değil.
  • requires_action: verilen talimatları yetkili bir kişiye iletin; bir ajan TikTok insan onayını sağlayamaz.

Kimlik bilgisi işleme

Ürün anahtarı yalnızca yapılandırılmış AiVideoEditor API'sine gönderilir (Authorization: Bearer). Model sağlayıcılarına veya sosyal ağlara asla gönderilmez, asla günlüğe yazılmaz ve anahtarın bir yönlendirmeyi takip etmemesi veya yapılandırılmış kaynaktan kaçmaması için URL'ler doğrulanır.