Postiz MCP
resmiPostiz ile sosyal medyanızı kolaylaştırın. Gönderileri planlayın, performansı analiz edin ve tüm hesapları tek bir yerden yönetin.
Postiz MCP ile neler yapabilirsiniz?
- Bağlı hesapları listeleme — Aracıdan, isteğe bağlı olarak gruba göre filtreleyerek bağlı sosyal medya hesaplarınızı listelemesini isteyin.
- Platform kurallarını kontrol etme — Bir gönderi taslağı hazırlamadan önce platforma özgü paylaşım kurallarını ve ayarlar şemasını alın.
- Gönderileri planlama veya yayınlama — Bağlı bir hesaba gönderi planlayın, taslak olarak kaydedin veya hemen yayınlayın.
- Planlanmış gönderileri inceleme — Kuruluşunuzun iki tarih arasında planlanmış gönderilerini mevcut ayarlarıyla birlikte listeleyin.
- Medya oluşturma — Gönderiler için yapay zekâ ile görsel veya video oluşturun ve kullanılabilir video oluşturma seçeneklerini listeleyin.
- Uzun videoları kliplere dönüştürme — Uzun bir YouTube videosunu altyazılı dikey kliplere ve gönderi taslaklarına dönüştürün, ardından klip oluşturma durumunu kontrol edin.
Dokümantasyon
Giriş
Model Context Protocol (MCP) kullanarak yapay zekâ ajanlarını Postiz'e bağlayın
MCP (Model Context Protocol), yapay zekâ ajanlarının Postiz ile doğrudan etkileşim kurmasını sağlar. Entegrasyonları listeleme, gönderileri planlama, görsel ve video oluşturma, uzun videoları kısa kliplere dönüştürme gibi işlemlerin tümü standartlaştırılmış bir araç çağırma arayüzü üzerinden gerçekleştirilir.
Böylece Claude, ChatGPT, Cursor veya MCP uyumlu herhangi bir istemciyi Postiz hesabınıza bağlayabilir ve sosyal medyanızı doğal dil kullanarak yönetebilirsiniz.
Nasıl Çalışır?
Postiz, yapay zekâ ajanlarına 13 araç sunan bir MCP sunucusu sağlar. Ajan bu araçları keşfeder, şemalarını anlar ve sizin adınıza çağırır.
sequenceDiagram
participant Agent as AI Agent
participant MCP as Postiz MCP Server
participant Postiz as Postiz Backend
Agent->>MCP: Connect with API key / OAuth token
MCP-->>Agent: List available tools
Agent->>MCP: Call tool (e.g., schedule post)
MCP->>Postiz: Execute action
Postiz-->>MCP: Return result
MCP-->>Agent: Tool response
Kullanılabilir Araçlar
| Araç | Açıklama |
|---|---|
integrationList | Bağlı tüm sosyal medya hesaplarını listeler (isteğe bağlı olarak gruba göre filtrelenebilir) |
groupList | Kuruluşunuzdaki tüm grupları (müşterileri) listeler |
integrationConnectTool | Yeni bir sosyal medya hesabı bağlamak için bağlantı alır |
integrationSchema | Platforma özgü gönderi kurallarını ve ayar şemasını alır |
triggerTool | Platforma özgü yardımcıları çalıştırır (ör. Discord kanallarını listeleme) |
schedulePostTool | Gönderileri planlar, taslak olarak kaydeder veya hemen yayımlar |
postsListTool | Kuruluşun iki tarih arasında planlanmış gönderilerini (mevcut ayarlarıyla birlikte) listeler |
postSettingsTool | Henüz yayımlanmamış planlanmış bir gönderinin veya taslağın sağlayıcı ayarlarını günceller |
generateImageTool | Gönderiler için yapay zekâ ile görsel oluşturur |
generateVideoOptions | Kullanılabilir video oluşturma seçeneklerini listeler |
videoFunctionTool | Video oluşturucu ayarlarını (ör. kullanılabilir sesleri) alır |
generateVideoTool | Gönderiler için video oluşturur |
clippingTool | Uzun bir YouTube videosunu altyazılı dikey kliplere dönüştürür ve gönderi taslakları oluşturur |
clippingStatusTool | Bir klip oluşturma işleminin durumunu kontrol eder ve tamamlanan klipleri alır |
Kimlik Doğrulama
MCP sunucusunda kimlik doğrulamanın iki yolu vardır:
API Anahtarı
Bunu doğrudan MCP uç noktasının URL'sinde veya Bearer token olarak kullanın.
OAuth Token'ı
Diğer Postiz kullanıcıları için bir uygulama geliştiriyorsanız token almak üzere OAuth2 kullanın. OAuth token'ları pos_ ile başlar ve API anahtarlarıyla aynı şekilde çalışır.
Bağlanma
[tab] Bearer Token
/mcpuç noktasını API anahtarınız veya OAuth token'ınızla Bearer token olarak kullanın:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyBu yöntem hem API anahtarlarını hem de OAuth token'larını destekler (
pos_önekiyle).
[tab] URL'de API Anahtarı
API anahtarınız URL'ye eklenmiş olarak
/mcp/:apiKeyuç noktasını kullanın:URL: https://mcp.postiz.com/mcp/your-api-key
Hızlı Örnek
Bir yapay zekâ ajanı Postiz MCP'yi kullandığında tipik bir etkileşim şöyle görünür:
- Ajan
integrationListçağrısını yapar ve bağlı hesaplarınızı (X, LinkedIn vb.) alır - Ajan
integrationSchemaçağrısınıplatform: "x"ile yapar ve X'in karakter sınırlarını, ayarlarını ve kurallarını öğrenir - Ajan
schedulePostToolçağrısını yapar ve gönderinizi doğru biçimde planlar
Yapay zekâ ajanınıza şu şekilde bir istekte bulunduğunuzda bunların tümü otomatik olarak gerçekleşir:
"Yarın saat 10'da X'te bir gönderi planla: Yeni özelliğimizi duyurmaktan heyecan duyuyoruz!"
SSS
Postiz MCP'yi kullanmak için OpenAI anahtarına ihtiyacım var mı?
Hayır. MCP sunucusu yalnızca Postiz araçlarını sunar. Modeli yapay zekâ istemciniz (Claude, ChatGPT, Cursor vb.) sağlar. Postiz'in kendi yapay zekâ özelliklerini (görsel oluşturma, yardımcı pilot) kullanmadığınız sürece Postiz'in yalnızca bir OPENAI_API_KEY anahtarına ihtiyacı vardır. Bu özellikler, istemcinize sunulan MCP araçlarından ayrıdır.
API anahtarımın süresi dolduğunda veya anahtar yenilendiğinde ne olur?
Postiz API anahtarları otomatik olarak yenilenmez. Ancak Settings → Developers → Public API bölümünden bir anahtarı yeniden oluşturursanız eski anahtarı kullanan tüm MCP istemcileri, yapılandırmalarını güncelleyene kadar çalışmayı durdurur. İstemci yapılandırmanızdaki URL'yi veya Authorization başlığını güncelleyin ve yeniden bağlanın.
Kendi sunucumda barındırıyorum: MCP uç noktasını nasıl kullanıma açarım?
MCP sunucusu Postiz arka ucunun bir parçası olarak başlar ve /mcp (Bearer kimlik doğrulaması), /mcp/:apiKey (URL'de anahtar) ve /mcp-oauth (OAuth korumalı) adreslerinde erişilebilir. Ters proxy'niz bu yolları arka uca yönlendirmeli ve akışlı HTTP'yi (Transfer-Encoding: chunked) desteklemelidir. Ters Proxy'ler bölümüne bakın.
MCP yorumları okuyabilir veya yorumlara yanıt verebilir mi?
Şu anda hayır. Mevcut araç kümesi entegrasyonlarda yalnızca okuma, gönderilerde ve medyada ise yalnızca yazma işlemlerini destekler. MCP üzerinden herhangi bir getComments veya replyToComment sunulmaz. Yorum yanıtları Postiz arayüzü üzerinden başlatılmalıdır.
Bu dokümantasyon, geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulur ve barındırılır.