Postiz MCP

resmi

Postiz 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.pro üzerinde görüntüleBu MCP'yi deneyinSponsorlu

Postiz MCP ile neler yapabilirsiniz?

Bağlı hesapları listele — Asistanınızdan, integrationList kullanarak tüm bağlı sosyal medya profillerini göstermesini isteyin; isteğe bağlı olarak gruba göre filtreleyebilirsiniz.
Gönderi planla veya yayınla — Asistanınıza, schedulePostTool aracılığıyla taslak oluşturma, planlama veya içeriği hemen yayınlama talimatı verin.
AI görselleri oluştur — Gönderileriniz için doğrudan generateImageTool ile AI destekli görseller talep edin.
Video klipleri oluştur — Uzun bir YouTube videosunu, clippingTool kullanarak altyazılı dikey kısa videolara dönüştürün ve gönderi taslakları hazırlayın.
Platform kurallarını kontrol et — Planlama yapmadan önce, integrationSchema aracılığıyla belirli bir platform için gönderim limitlerini ve ayarlarını sorun.

Dokümantasyon

Giriş

AI ajanlarını Model Context Protocol (MCP) kullanarak Postiz'e bağlayın

MCP (Model Context Protocol), AI ajanlarının Postiz ile doğrudan etkileşime girmesini sağlar; entegrasyonları listeleme, gönderi planlama, görsel ve video oluşturma, uzun videoları kısa videolara dönüştürme gibi işlemleri standart bir araç çağırma arayüzü üzerinden yapar.

Bu, Claude, ChatGPT, Cursor veya MCP uyumlu herhangi bir istemciyi Postiz hesabınıza bağlayabileceğiniz ve sosyal medyanızı doğal dil ile yönetebileceğiniz anlamına gelir.

Nasıl Çalışır

Postiz, AI ajanlarına 13 araç sağlayan bir MCP sunucusu sunar. 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 filtrelenir)
`groupList`	Organizasyonunuz için tüm grupları (müşterileri) listeler
`integrationSchema`	Platforma özel gönderi kurallarını ve ayar şemasını alır
`triggerTool`	Platforma özel yardımcıları çalıştırır (ör. Discord kanallarını listeler)
`schedulePostTool`	Gönderileri planlar, taslak olarak kaydeder veya anında yayınlar
`postsListTool`	İki tarih arasında planlanan organizasyon gönderilerini (mevcut ayarlarıyla birlikte) listeler
`postSettingsTool`	Henüz yayınlanmamış planlanmış bir gönderinin veya taslağın sağlayıcı ayarlarını günceller
`generateImageTool`	Gönderiler için AI görselleri oluşturur
`generateVideoOptions`	Mevcut video oluşturma seçeneklerini listeler
`videoFunctionTool`	Video oluşturucu ayarlarını alır (ör. mevcut sesler)
`generateVideoTool`	Gönderiler için videolar oluşturur
`clippingTool`	Uzun bir YouTube videosunu altyazılı dikey kliplere dönüştürür ve taslak gönderiler oluşturur
`clippingStatusTool`	Bir kırpma işlemini kontrol eder ve tamamlanmış klipleri alır

Kimlik Doğrulama

MCP sunucusuyla kimlik doğrulamanın iki yolu vardır:

API Anahtarı

Bunu doğrudan MCP uç noktası URL'sinde veya Bearer token olarak kullanın.

OAuth Token

Diğer Postiz kullanıcıları için bir uygulama oluşturuyorsanız, token almak için OAuth2 kullanın. OAuth token'ları pos_ ile başlar ve API anahtarlarıyla aynı şekilde çalışır.

Bağlanma

API anahtarınızı veya OAuth token'ınızı Bearer token olarak kullanarak `/mcp` uç noktasını kullanın:

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

Bu yöntem hem API anahtarlarını hem de OAuth token'larını (`pos_` ön ekiyle) destekler.

API anahtarınızı URL'ye gömerek `/mcp/:apiKey` uç noktasını kullanın:

```text theme={null}
URL: https://mcp.postiz.com/mcp/your-api-key
```

Hızlı Örnek

Bir AI ajanının Postiz MCP'yi kullandığı tipik bir etkileşim şuna benzer:

Ajan integrationList çağırır, bağlı hesaplarınızı (X, LinkedIn vb.) geri alır
Ajan integrationSchema çağırır platform: "x" ile ve X'in karakter sınırlarını, ayarlarını ve kurallarını öğrenir
Ajan schedulePostTool çağırır, gönderinizi doğru formatta planlar

Tüm bunlar, AI ajanınıza şöyle bir şey söylediğinizde otomatik olarak gerçekleşir:

"Yarın saat 10:00'da X'e 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'in araçlarını sunar. AI istemciniz (Claude, ChatGPT, Cursor vb.) modeli sağlar. Postiz'in yalnızca kendi AI özelliklerini (görsel oluşturma, yardımcı pilot) kullanıyorsanız bir OPENAI_API_KEY gerekir; bunlar istemcinize sunulan MCP araçlarından ayrıdır.

API anahtarımın süresi dolduğunda veya değiştirildiğinde ne olur?

Postiz API anahtarları otomatik olarak değişmez, ancak Ayarlar → Geliştiriciler → Genel API bölümünde bir tane yeniden oluşturursanız, eski anahtarı kullanan tüm MCP istemcileri, yapılandırması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 sunucunda barındırma: MCP uç noktasını nasıl açığa çıkarırım?

MCP sunucusu, Postiz arka uçunun bir parçası olarak başlar ve /mcp (Bearer kimlik doğrulama), /mcp/:apiKey (URL'de anahtar) ve /mcp-oauth (OAuth korumalı) adreslerinden erişilebilir. Ters proxy'niz bu yolları arka uca iletmeli ve akışlı HTTP'yi (Transfer-Encoding: chunked) desteklemelidir. Ters Proxy'ler bölümüne bakın.

MCP yorumları okuyabilir veya yanıtlayabilir mi?

Şu anda hayır. Mevcut araç seti entegrasyonlarda salt okunur ve gönderiler/medyada salt yazılır. MCP üzerinden getComments veya replyToComment sunulmamaktadır. Yorum yanıtları Postiz arayüzü üzerinden tetiklenmelidir.

Bu dokümantasyon, bir geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulmuş ve barındırılmaktadır.