İ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/Mutasyon | Notlar |
|---|---|---|
list_accounts | read | Anahtarın hesap izin listesine uyar |
get_capabilities | read | Biçimler, sınırlar, onay gereksinimleri |
create_upload_intent | mutate | Doğrudan yükleme talimatları döndürür; medya baytları araçlardan asla geçmez |
finalize_upload | mutate | Oturum kimliği (+ multipart parça makbuzları); sunucu bayt/MIME'ı kendisi gözlemler |
create_draft | mutate | Kaynak + hedef varyantları |
validate_post | read | Yapılandırılmış hedef başına sorunlar |
schedule_post | mutate | Tek an, ≤90 gün ileri, expectedVersion gerekli |
publish_post | mutate | 202 semantiği; yayınlama kanıtı değil |
get_post_status | read | Hedef başına durumlar ve yerel bağlantılar |
list_posts | read | İmleç sayfalama |
cancel_delivery | mutate | Yalnızca güvenle talep edilmediği sürece |
retry_delivery | mutate | Yalnızca bilinen başarısızlıklar; asla çoğaltmaz |
get_usage | read | Kalan paylaşım sayacı yoktur |
Gerekli araç argümanları
| Araç | Gerekli argümanlar |
|---|---|
list_accounts | Yok |
get_capabilities | Yok |
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 | Yok |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Yok |
İ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
list_accounts+get_capabilities→ geçerli hedefleri seçin.create_upload_intent→ baytları doğrudan yükleyin →finalize_upload.create_draft→validate_post→ geçersiz hedefleri düzeltin veya seçimden çıkarın.publish_post(veyaschedule_post) → teslim kimliklerini not edin.get_post_status(sınırlı yoklama veya müşteri webhook'ları):requires_actionyanıtlarını eyleme dönük talimatlar olarak değerlendirin, örn. TikTok onayı.
Test edilen istemciler
- Resmî
@modelcontextprotocol/sdkTypeScript istemcisi, belgelenen ikiliye karşı gerçek subprocess stdio (initialize → tools/list → tools/call):packages/mcp/tests/stdio.test.tsiç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ım | Durum | Kurulum |
|---|---|---|
| Resmî TypeScript SDK subprocess stdio | Otomatik test kapsamı | Yukarıda gösterilen depo başlatıcısı |
| Resmî SDK bellek içi aktarım | Otomatik test kapsamı | Yalnızca test düzeneği |
| Claude Desktop / diğer masaüstü istemciler | Manuel 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ğlanmaz | Barı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 MCP | Uygulanmadı | 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.