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?

Postiz MCP ile, yapay zeka asistanınızdan sosyal medya gönderilerini yönetmesini ve doğrudan medya oluşturmasını isteyebilirsiniz.

Bağlı hesapları listele — integrationList aracılığıyla tüm bağlı sosyal medya hesaplarını sorun, isteğe bağlı olarak gruba göre filtrelenmiş.
Platform kurallarını al — X gibi bir platform için gönderi kurallarını ve ayarlarını getirmek üzere integrationSchema kullanın.
Gönderileri planla — Gönderileri hemen planlamak, taslak olarak kaydetmek veya yayınlamak için schedulePostTool kullanın.
Planlanan gönderileri listele — İki tarih arasında planlanan gönderileri görüntülemek için postsListTool kullanın.
Görseller oluştur — Gönderiler için yapay zeka görselleri oluşturmak üzere generateImageTool kullanın.
Videolar oluştur — generateVideoOptions seçenekleriyle videolar üretmek için generateVideoTool kullanın.

Dokümantasyon

Giriş

Model Context Protocol (MCP) kullanarak AI ajanlarını 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 işlemlerini standartlaştırılmış bir araç çağırma arayüzü üzerinden gerçekleştirir.

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 11 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

Mevcut 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`	Kuruluşunuz 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 (örn. Discord kanallarını listeler)
`schedulePostTool`	Gönderileri planlar, taslak olarak kaydeder veya anında yayınlar
`postsListTool`	Kuruluşun iki tarih arasında planlanan 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 (örn. mevcut sesler)
`generateVideoTool`	Gönderiler için videolar oluşturur

Kimlik Doğrulama

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

API Anahtarı

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

OAuth Belirteci

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

Bağlanma

`/mcp` uç noktasını API anahtarınız veya OAuth belirtecinizle Bearer belirteci olarak kullanın:

```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

Bu yöntem hem API anahtarlarını hem de OAuth belirteçlerini (`pos_` ön ekli) destekler.

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

```
URL: https://api.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 biçimde planlar

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

"Yarın saat 10'da X'e bir gönderi planla: Yeni özelliğimizi duyurmaktan heyecan duyuyoruz!"

SSS

Postiz MCP'yi kullanmak için bir OpenAI anahtarına ihtiyacım var mı?

Hayır. MCP sunucusu yalnızca Postiz'in araçlarını kullanıma sunar. Modeli, AI istemciniz (Claude, ChatGPT, Cursor vb.) sağlar. Postiz yalnızca, istemcinize sunulan MCP araçlarından ayrı olan kendi AI özelliklerini (görsel oluşturma, yardımcı pilot) kullanıyorsanız bir OPENAI_API_KEY gerektirir.

API anahtarımın süresi dolarsa veya yenilenirse ne olur?

Postiz API anahtarları otomatik yenilenmez; ancak Ayarlar → Geliştiriciler → Genel API bölümünde bir anahtarı 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 sunucunuzda barındırma: MCP uç noktasını nasıl kullanıma sunarım?

MCP sunucusu Postiz arka uç sisteminin 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 an 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ı yalnızca Postiz arayüzü üzerinden tetiklenmelidir.