Postiz MCP

oficial

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

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 posts, gerando imagens e vídeos — tudo por meio de uma interface padronizada de chamada de ferramentas.

Isso significa que você pode conectar o Claude, ChatGPT, Cursor ou qualquer cliente compatível com MCP à sua conta do Postiz e gerenciar suas redes sociais através de linguagem natural.

Como Funciona

O Postiz expõe um servidor MCP que fornece 9 ferramentas para agentes de IA. O agente descobre essas ferramentas, entende 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`	Lista todas as contas de redes sociais conectadas (opcionalmente filtradas por grupo)
`groupList`	Lista todos os grupos (clientes) da sua organização
`integrationSchema`	Obtém regras de postagem específicas da plataforma e esquema de configurações
`triggerTool`	Executa auxiliares específicos da plataforma (ex.: listar canais do Discord)
`schedulePostTool`	Agenda, cria rascunho ou publica posts imediatamente
`generateImageTool`	Gera imagens de IA para posts
`generateVideoOptions`	Lista opções disponíveis de geração de vídeo
`videoFunctionTool`	Obtém configurações do gerador de vídeo (ex.: vozes disponíveis)
`generateVideoTool`	Gera vídeos para posts

Autenticação

Existem duas maneiras de autenticar no servidor MCP:

Chave de API

Obtenha sua chave de API em Configurações > Desenvolvedores > API Pública no Postiz. Use-a diretamente na URL do endpoint MCP ou como um token Bearer.

Token OAuth

Se você está construindo 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 as chaves de API.

Conectando

Use o endpoint `/mcp` com sua chave de API ou token OAuth como um 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 incorporada na URL:

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

Para instâncias auto-hospedadas, substitua `https://api.postiz.com` pelo seu `NEXT_PUBLIC_BACKEND_URL`.

Exemplo Rápido

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

Agente chama integrationList — obtém suas contas conectadas (X, LinkedIn, etc.)
Agente chama integrationSchema com platform: "x" — aprende os limites de caracteres, configurações e regras do X
Agente chama schedulePostTool — agenda seu post com o formato correto

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

"Agende um post no X para amanhã às 10h: Animado para anunciar nossa nova funcionalidade!"

Perguntas Frequentes

Preciso de uma chave da 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 recursos de IA próprios do Postiz (geração de imagem, copiloto), que são separados das ferramentas MCP disponibilizadas 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 que usa a chave antiga para de funcionar até que você atualize 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 está 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 HTTP streaming (Transfer-Encoding: chunked). Veja Proxies Reversos.

O MCP pode ler ou responder a comentários?

Não atualmente. O conjunto de ferramentas atual é somente leitura em integrações e somente escrita em posts/mídia — não há getComments ou replyToComment expostos via MCP. Respostas a comentários devem ser acionadas através da interface do Postiz.