Postiz MCP

oficial

Simplifique suas redes sociais com o Postiz. Agende postagens, analise o desempenho e gerencie todas as

Ver em postiz.proExperimente este MCPPatrocinado

O que você pode fazer com Postiz MCP?

Com o Postiz MCP, você pode pedir ao seu assistente de IA para gerenciar postagens em redes sociais e gerar mídia diretamente.

Listar contas conectadas — Peça todas as contas de redes sociais conectadas via integrationList, opcionalmente filtradas por grupo.
Obter regras da plataforma — Use integrationSchema para buscar regras de postagem e configurações de uma plataforma como o X.
Agendar postagens — Use schedulePostTool para agendar, rascunhar ou publicar postagens imediatamente.
Listar postagens agendadas — Use postsListTool para visualizar postagens agendadas entre duas datas.
Gerar imagens — Use generateImageTool para criar imagens de IA para postagens.
Gerar vídeos — Use generateVideoTool para produzir vídeos, com opções de generateVideoOptions.

Documentação

Introdução

Conecte agentes de IA ao Postiz usando o Model Context Protocol (MCP)

O MCP (Model Context Protocol) permite que agentes de IA interajam diretamente com o Postiz, listando integrações, agendando postagens, gerando imagens e vídeos, tudo por meio de uma interface padronizada de chamada de ferramentas.

Isso significa que você pode conectar Claude, ChatGPT, Cursor ou qualquer cliente compatível com MCP à sua conta do Postiz e gerenciar suas mídias sociais por meio de linguagem natural.

Como Funciona

O Postiz expõe um servidor MCP que fornece 11 ferramentas para agentes de IA. O agente descobre essas ferramentas, compreende seus esquemas e as chama em seu nome.

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

Ferramentas Disponíveis

Ferramenta	Descrição
`integrationList`	Listar todas as contas de mídia social conectadas (opcionalmente filtradas por grupo)
`groupList`	Listar todos os grupos (clientes) da sua organização
`integrationSchema`	Obter regras de postagem e esquema de configurações específicas da plataforma
`triggerTool`	Executar auxiliares específicos da plataforma (ex.: listar canais do Discord)
`schedulePostTool`	Agendar, rascunhar ou publicar postagens imediatamente
`postsListTool`	Listar as postagens da organização agendadas entre duas datas (com suas configurações atuais)
`postSettingsTool`	Atualizar as configurações do provedor de uma postagem agendada ou rascunho que ainda não foi publicado
`generateImageTool`	Gerar imagens de IA para postagens
`generateVideoOptions`	Listar opções disponíveis de geração de vídeo
`videoFunctionTool`	Obter configurações do gerador de vídeo (ex.: vozes disponíveis)
`generateVideoTool`	Gerar vídeos para postagens

Autenticação

Há duas maneiras de autenticar com o servidor MCP:

Chave de API

Use diretamente na URL do endpoint MCP, ou como token Bearer.

Token OAuth

Se você está criando um aplicativo para outros usuários do Postiz, use OAuth2 para obter tokens. Tokens OAuth começam com pos_ e funcionam da mesma forma que chaves de API.

Conectando

Use o endpoint `/mcp` com sua chave de API ou token OAuth como token Bearer:

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

Este método suporta tanto chaves de API quanto tokens OAuth (prefixados com `pos_`).

Use o endpoint `/mcp/:apiKey` com sua chave de API embutida na URL:

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

Exemplo Rápido

Veja como é uma interação típica quando um agente de IA usa o Postiz MCP:

O agente chama integrationList, recebe suas contas conectadas (X, LinkedIn, etc.)
O agente chama integrationSchema com platform: "x" e aprende os limites de caracteres, configurações e regras do X
O agente chama schedulePostTool, agenda sua postagem com o formato correto

Tudo isso acontece automaticamente quando você diz algo como ao seu agente de IA:

"Agende uma postagem para X amanhã às 10h: Estamos animados em anunciar nosso novo recurso!"

FAQ

Preciso de uma chave OpenAI para usar o Postiz MCP?

Não. O servidor MCP apenas expõe as ferramentas do Postiz. Seu cliente de IA (Claude, ChatGPT, Cursor, etc.) fornece o modelo. O Postiz só precisa de um OPENAI_API_KEY se você usar os próprios recursos de IA do Postiz (geração de imagens, copiloto), que são separados das ferramentas MCP expostas ao seu cliente.

O que acontece quando minha chave de API expira ou é rotacionada?

As chaves de API do Postiz não são rotacionadas automaticamente, mas se você regenerar uma em Configurações → Desenvolvedores → API Pública, todo cliente MCP usando a chave antiga para de funcionar até você atualizar sua configuração. Atualize a URL ou o cabeçalho Authorization na configuração do seu cliente e reconecte.

Auto-hospedado: como exponho o endpoint MCP?

O servidor MCP inicia como parte do backend do Postiz e é acessível em /mcp (autenticação Bearer), /mcp/:apiKey (chave na URL) e /mcp-oauth (protegido por OAuth). Seu proxy reverso deve encaminhar esses caminhos para o backend e suportar streaming HTTP (Transfer-Encoding: chunked). Veja Proxies Reversos.

O MCP pode ler ou responder comentários?

Ainda não. O conjunto atual de ferramentas é somente leitura em integrações e somente gravação em postagens/mídia. Não há getComments ou replyToComment expostos via MCP. As respostas a comentários devem ser acionadas pela interface do Postiz.