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üle

Postiz MCP ile neler yapabilirsiniz?

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

Dokümantasyon

Giriş

Model Bağlam Protokolü (MCP) ile yapay zeka ajanlarını Postiz'e bağlayın

MCP (Model Bağlam Protokolü), yapay zeka ajanlarının Postiz ile doğrudan etkileşime girmesini sağlar — entegrasyonları listeleme, gönderileri zamanlama, görüntü ve video oluşturma — tüm bunlar standart bir araç çağırma arayüzü üzerinden gerçekleşir.

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

Nasıl Çalışır

Postiz, yapay zeka ajanlarına 9 araç sağlayan bir MCP sunucusu sunar. Ajan bu araçları keşfeder, şemalarını anlar ve sizin adınıza bunları ç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ı listele (isteğe bağlı olarak gruba göre filtrele)
`groupList`	Kuruluşunuz için tüm grupları (müşterileri) listele
`integrationSchema`	Platforma özgü gönderi kurallarını ve ayar şemasını al
`triggerTool`	Platforma özgü yardımcıları çalıştır (örn. Discord kanallarını listele)
`schedulePostTool`	Gönderileri zamanla, taslak olarak kaydet veya hemen yayınla
`generateImageTool`	Gönderiler için yapay zeka görüntüleri oluştur
`generateVideoOptions`	Mevcut video oluşturma seçeneklerini listele
`videoFunctionTool`	Video oluşturucu ayarlarını al (örn. mevcut sesler)
`generateVideoTool`	Gönderiler için videolar oluştur

Kimlik Doğrulama

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

API Anahtarı

API anahtarınızı Postiz'de Ayarlar > Geliştiriciler > Genel API bölümünden alın. Bunu doğrudan MCP uç nokta URL'sinde veya Bearer belirteci olarak kullanın.

OAuth Belirteci

Diğer Postiz kullanıcıları için bir uygulama geliştiriyorsanı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

API anahtarınız veya OAuth belirtecinizle `/mcp` uç noktasını 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 ekiyle) destekler.

API anahtarınızın URL'ye gömülü olduğu `/mcp/:apiKey` uç noktasını kullanın:

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

Kendi barındırdığınız örnekler için, `https://api.postiz.com` yerine `NEXT_PUBLIC_BACKEND_URL` kullanın.

Hızlı Örnek

Bir yapay zeka ajanı Postiz MCP'yi kullandığında tipik bir etkileşim şöyle görünür:

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

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

"Yarın saat 10:00 için X'e bir gönderi zamanla: 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ı sunar — yapay zeka istemciniz (Claude, ChatGPT, Cursor, vb.) modeli sağlar. Postiz'in yalnızca, istemcinize sunulan MCP araçlarından ayrı olan kendi yapay zeka özelliklerini (görüntü oluşturma, yardımcı pilot) kullanırsanız bir OPENAI_API_KEY ihtiyacı olur.

API anahtarımın süresi dolduğunda veya döndürüldüğünde ne olur?

Postiz API anahtarları otomatik olarak dönmez, ancak Ayarlar → Geliştiriciler → Genel API bölümünden bir anahtarı yeniden oluşturursanız, eski anahtarı kullanan her MCP istemcisi, 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 barındırdığım: MCP uç noktasını nasıl sunarı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ı) adreslerinden erişilebilir. Ters proxy'niz bu yolları arka uca iletmeli ve akış HTTP'sini (Transfer-Encoding: chunked) desteklemelidir. Bkz. Ters Proxy'ler.

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 durumdadır — MCP aracılığıyla sunulan bir getComments veya replyToComment yoktur. Yorum yanıtları Postiz kullanıcı arayüzü üzerinden tetiklenmelidir.