Postiz MCP

oficial

Simplifique 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

FerramentaDescrição
integrationListLista todas as contas de redes sociais conectadas (com filtro opcional por grupo)
groupListLista todos os grupos (clientes) da sua organização
integrationConnectToolObtém um link para conectar uma nova conta de rede social
integrationSchemaObtém as regras de publicação e o esquema de configurações específicos da plataforma
triggerToolExecuta auxiliares específicos da plataforma (por exemplo, lista canais do Discord)
schedulePostToolAgenda, salva como rascunho ou publica publicações imediatamente
postsListToolLista as publicações da organização agendadas entre duas datas (com as configurações atuais)
postSettingsToolAtualiza as configurações do provedor de uma publicação agendada ou de um rascunho ainda não publicado
generateImageToolGera imagens com IA para publicações
generateVideoOptionsLista as opções disponíveis para geração de vídeos
videoFunctionToolObtém as configurações do gerador de vídeos (por exemplo, vozes disponíveis)
generateVideoToolGera vídeos para publicações
clippingToolTransforma um vídeo longo do YouTube em clipes verticais com legendas e cria rascunhos de publicações
clippingStatusToolVerifica 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 /mcp com sua chave de API ou token OAuth como token Bearer:

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

Este método aceita tanto chaves de API quanto tokens OAuth (com o prefixo pos_).

[tab] Chave de API na URL

Use o endpoint /mcp/:apiKey com 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:

  1. O agente chama integrationList e recebe suas contas conectadas (X, LinkedIn etc.)
  2. O agente chama integrationSchema com platform: "x" e descobre os limites de caracteres, as configurações e as regras do X
  3. O agente chama schedulePostTool e 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.