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?

Listar contas conectadas — Peça ao seu assistente para mostrar todos os perfis de mídia social vinculados usando integrationList, opcionalmente filtrados por grupo.
Agendar ou publicar posts — Instrua seu assistente a criar rascunhos, agendar ou publicar conteúdo imediatamente via schedulePostTool.
Gerar imagens com IA — Solicite visuais gerados por IA para seus posts diretamente por meio de generateImageTool.
Criar clipes de vídeo — Transforme um vídeo longo do YouTube em shorts verticais legendados e rascunhos de posts usando clippingTool.
Verificar regras da plataforma — Pergunte sobre limites de publicação e configurações para uma plataforma específica via integrationSchema antes de agendar.

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, transformando vídeos longos em shorts, 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 Postiz e gerenciar suas redes sociais por meio de linguagem natural.

Como Funciona

O Postiz expõe um servidor MCP que fornece 13 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 postagens imediatamente
`postsListTool`	Lista as postagens da organização agendadas entre duas datas (com suas configurações atuais)
`postSettingsTool`	Atualiza as configurações do provedor de uma postagem agendada ou rascunho que ainda não foi publicado
`generateImageTool`	Gera imagens de IA para postagens
`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 postagens
`clippingTool`	Transforma um vídeo longo do YouTube em clipes verticais legendados e cria postagens de rascunho
`clippingStatusTool`	Verifica um clipe e obtém os clipes finalizados

Autenticação

Existem duas formas de autenticar com o servidor MCP:

Chave de API

Use-a 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. Os 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 token Bearer:

```text theme={null}
URL: https://mcp.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:

```text theme={null}
URL: https://mcp.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, obtém 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 ao seu agente de IA algo como:

"Agende uma postagem para o X amanhã às 10h: 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 recursos de IA do próprio Postiz (geração de imagens, 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 é 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). Consulte Reverse Proxies.

O MCP pode ler ou responder comentários?

Ainda não. O conjunto atual de ferramentas é somente leitura em integrações e somente escrita 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.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.