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 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
integrationListBağlı tüm sosyal medya hesaplarını listeler (isteğe bağlı olarak gruba göre filtrelenebilir)
groupListKuruluşunuzdaki tüm grupları (müşterileri) listeler
integrationConnectToolYeni bir sosyal medya hesabı bağlamak için bağlantı alır
integrationSchemaPlatforma özgü gönderi kurallarını ve ayar şemasını alır
triggerToolPlatforma özgü yardımcıları çalıştırır (ör. Discord kanallarını listeleme)
schedulePostToolGönderileri planlar, taslak olarak kaydeder veya hemen yayımlar
postsListToolKuruluşun iki tarih arasında planlanmış gönderilerini (mevcut ayarlarıyla birlikte) listeler
postSettingsToolHenüz yayımlanmamış planlanmış bir gönderinin veya taslağın sağlayıcı ayarlarını günceller
generateImageToolGönderiler için yapay zekâ ile görsel oluşturur
generateVideoOptionsKullanılabilir video oluşturma seçeneklerini listeler
videoFunctionToolVideo oluşturucu ayarlarını (ör. kullanılabilir sesleri) alır
generateVideoToolGönderiler için video oluşturur
clippingToolUzun bir YouTube videosunu altyazılı dikey kliplere dönüştürür ve gönderi taslakları oluşturur
clippingStatusToolBir 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

/mcp uç 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-key

Bu 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/:apiKey uç 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:

  1. Ajan integrationList çağrısını yapar ve bağlı hesaplarınızı (X, LinkedIn vb.) alır
  2. Ajan integrationSchema çağrısını platform: "x" ile yapar ve X'in karakter sınırlarını, ayarlarını ve kurallarını öğrenir
  3. 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.