Postiz MCP
oficialSimplifique suas redes sociais com o Postiz. Agende postagens, analise o desempenho e gerencie todas as
O que você pode fazer com Postiz MCP?
- Listar contas conectadas — Peça ao agente para listar suas contas de redes sociais conectadas, com a opção de filtrar por grupo.
- Verificar regras da plataforma — Obtenha as regras de publicação e o esquema de configurações específicos da plataforma antes de redigir uma publicação.
- Agendar ou publicar publicações — Agende, salve como rascunho ou publique imediatamente uma publicação em uma conta conectada.
- Revisar publicações agendadas — Liste as publicações da sua organização agendadas entre duas datas, com as configurações atuais.
- Gerar mídia — Gere imagens ou vídeos com IA para publicações e liste as opções disponíveis de geração de vídeo.
- Recortar vídeos longos — Transforme um vídeo longo do YouTube em clipes verticais legendados e rascunhos de publicações; depois, verifique o status do recorte.
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 publicações, gerando imagens e vídeos e transformando vídeos longos em clipes curtos, tudo por meio de uma interface padronizada de chamadas 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 redes sociais usando linguagem natural.
Como funciona
O Postiz disponibiliza 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 (com filtro opcional por grupo) |
groupList | Lista todos os grupos (clientes) da sua organização |
integrationConnectTool | Obtém um link para conectar uma nova conta de rede social |
integrationSchema | Obtém as regras de publicação e o esquema de configurações específicos da plataforma |
triggerTool | Executa auxiliares específicos da plataforma (por exemplo, lista canais do Discord) |
schedulePostTool | Agenda, salva como rascunho ou publica publicações imediatamente |
postsListTool | Lista as publicações da organização agendadas entre duas datas (com as configurações atuais) |
postSettingsTool | Atualiza as configurações do provedor de uma publicação agendada ou de um rascunho ainda não publicado |
generateImageTool | Gera imagens com IA para publicações |
generateVideoOptions | Lista as opções disponíveis para geração de vídeos |
videoFunctionTool | Obtém as configurações do gerador de vídeos (por exemplo, vozes disponíveis) |
generateVideoTool | Gera vídeos para publicações |
clippingTool | Transforma um vídeo longo do YouTube em clipes verticais com legendas e cria rascunhos de publicações |
clippingStatusTool | Verifica o processo de recorte e obtém os clipes finalizados |
Autenticação
Há duas maneiras de se autenticar no servidor MCP:
Chave de API
Use-a diretamente na URL do endpoint MCP ou como um token Bearer.
Token OAuth
Se você estiver 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.
Conexão
[tab] Token Bearer
Use o endpoint
/mcpcom sua chave de API ou token OAuth como token Bearer:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyEste método aceita tanto chaves de API quanto tokens OAuth (com o prefixo
pos_).
[tab] Chave de API na URL
Use o endpoint
/mcp/:apiKeycom sua chave de API incluída na URL: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
integrationListe recebe suas contas conectadas (X, LinkedIn etc.) - O agente chama
integrationSchemacomplatform: "x"e descobre os limites de caracteres, as configurações e as regras do X - O agente chama
schedulePostToole agenda sua publicação no formato correto
Tudo isso acontece automaticamente quando você diz ao seu agente de IA algo como:
"Agende uma publicação no X para amanhã às 10h: Estamos muito animados para anunciar nosso novo recurso!"
Perguntas frequentes
Preciso de uma chave da OpenAI para usar o Postiz MCP?
Não. O servidor MCP apenas disponibiliza 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 imagens, copiloto), que são separados das ferramentas MCP disponibilizadas ao seu cliente.
O que acontece quando minha chave de API expira ou é substituída?
As chaves de API do Postiz não são substituídas automaticamente, mas, se você gerar uma nova em Settings → Developers → Public API, todos os clientes MCP que usam a chave antiga deixarão de funcionar até que você atualize a configuração. Atualize a URL ou o cabeçalho Authorization na configuração do cliente e conecte-se novamente.
Hospedagem própria: como exponho o endpoint MCP?
O servidor MCP é iniciado como parte do backend do Postiz e pode ser acessado 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 oferecer suporte a HTTP com streaming (Transfer-Encoding: chunked). Consulte Proxies reversos.
O MCP pode ler ou responder a comentários?
Ainda não. O conjunto atual de ferramentas permite apenas leitura nas integrações e apenas gravação em publicações/mídia. Não há nenhum getComments ou replyToComment disponibilizado pelo MCP. As respostas a comentários devem ser feitas pela interface do Postiz.
Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.