Como usar o servidor MCP do Postoria

O servidor MCP do Postoria permite que ferramentas de IA compatíveis com MCP criem e gerenciem posts no Postoria por meio da API pública do Postoria.

Você pode se conectar ao Postoria de duas formas:

Servidor MCP local via npm — é executado na sua máquina e usa sua chave da API pública do Postoria.
Endpoint MCP hospedado do Postoria — é executado na infraestrutura do Postoria em https://mcp.postoria.io/mcp e aceita login via OAuth ou autenticação com chave da API pública, dependendo do que seu cliente MCP oferece.

O servidor MCP pode ajudar uma ferramenta de IA a listar espaços de trabalho, encontrar contas sociais e filas, importar ou enviar mídia, publicar posts, agendar posts, adicionar posts a filas, listar posts existentes, verificar o status de posts e excluir posts no Postoria.

O suporte a MCP depende da ferramenta de IA que você usa. As ferramentas compatíveis podem incluir Claude Desktop, Cursor, Claude Code e apps personalizados do ChatGPT nos ambientes em que conexões MCP personalizadas estão disponíveis.

Antes de começar

Veja os pontos principais antes de usar o servidor MCP do Postoria:

O acesso ao servidor MCP está disponível nos planos Pro e Agency.
O servidor MCP usa a API pública do Postoria internamente.
O servidor MCP local via npm exige uma chave da API pública do Postoria.
O endpoint MCP hospedado do Postoria pode usar login via OAuth quando o cliente MCP oferece descoberta OAuth.
O endpoint MCP hospedado do Postoria também aceita uma chave da API pública do Postoria como token bearer.
As chaves da API pública pertencem à conta, não ao espaço de trabalho.
O uso local permite enviar arquivos da sua máquina quando o cliente MCP oferece acesso a arquivos.
O endpoint MCP hospedado do Postoria não exige a instalação local do pacote npm.

Você também pode consultar o artigo de ajuda da API pública do Postoria para saber como configurar a chave de API e entender o comportamento da API.

Escolha entre uso local e hospedado

Escolha o método de conexão compatível com seu cliente MCP.

Servidor MCP local via npm

Use o servidor MCP local via npm quando seu cliente compatível com MCP puder executar um comando local.

Essa configuração é comum em ferramentas de desktop e IDE, como Claude Desktop, Cursor e Claude Code.

No modo local:

O servidor MCP é executado na sua máquina por meio do pacote npm.
Sua chave da API pública do Postoria é fornecida pela configuração local do cliente MCP.
O envio de arquivos locais pode funcionar quando o cliente MCP permite que o servidor MCP acesse um caminho de arquivo local.

O pacote npm é:

@postoria/mcp-server

O comando local é:

npx -y @postoria/mcp-server

Endpoint MCP hospedado do Postoria

Use o endpoint MCP hospedado do Postoria quando seu cliente compatível com MCP puder se conectar a servidores MCP hospedados.

No modo hospedado:

Você não instala o pacote npm localmente.
O cliente MCP se conecta a https://mcp.postoria.io/mcp.
Clientes compatíveis com OAuth podem conduzir você pelo login no Postoria.
Clientes que aceitam tokens bearer podem usar uma chave da API pública do Postoria.

O endpoint MCP hospedado do Postoria é:

https://mcp.postoria.io/mcp

Crie uma chave da API pública

Crie uma chave da API pública para o servidor MCP local via npm ou para clientes MCP hospedados que usam autenticação com token bearer.

O fluxo de login via OAuth do endpoint MCP hospedado do Postoria não usa uma chave da API pública.

Para criar uma chave da API pública:

Abra o Postoria.
Acesse Configurações.
Encontre a seção API pública, servidor MCP e integração com n8n.
Clique em Criar chave de API.
Copie a chave e guarde-a com segurança.

O Postoria mostra a chave de API completa apenas uma vez. Depois de fechar a janela, você verá somente o prefixo da chave.

Se perder a chave, revogue-a e crie uma nova.

Configuração do cliente MCP local

A configuração exata depende do seu cliente MCP.

Para clientes que aceitam configuração de servidores MCP em JSON, use o pacote com a chave de API do Postoria nas variáveis de ambiente.

Exemplo:

{
  "mcpServers": {
    "postoria": {
      "command": "npx",
      "args": ["-y", "@postoria/mcp-server"],
      "env": {
        "POSTORIA_API_KEY": "pst_live_your_postoria_api_key_here"
      }
    }
  }
}

Depois de salvar a configuração, reinicie ou atualize seu cliente MCP e peça para ele usar o Postoria.

Endpoint MCP hospedado do Postoria

Para conexões MCP hospedadas, use este endpoint:

https://mcp.postoria.io/mcp

O endpoint hospedado aceita dois métodos de autenticação. O método usado depende do seu cliente MCP.

Alguns clientes MCP oferecem descoberta OAuth para servidores MCP hospedados. Nesse caso, adicione o endpoint MCP hospedado do Postoria ao cliente MCP e entre no Postoria quando solicitado.

https://mcp.postoria.io/mcp

Chave da API pública como token bearer

Alguns clientes MCP aceitam tokens bearer personalizados. Nesse caso, use sua chave da API pública do Postoria como token bearer.

Authorization: Bearer pst_live_your_postoria_api_key_here

Se o cliente pedir o valor do token e, separadamente, o esquema do cabeçalho, insira apenas a chave de API como valor do token e escolha Bearer como esquema.

Não cole a palavra Bearer no campo do token, a menos que o cliente MCP peça explicitamente o valor completo do cabeçalho.

Depois de conectar, peça ao cliente para procurar ou carregar as ferramentas disponíveis.

Ferramentas disponíveis

O servidor MCP do Postoria oferece ferramentas para os fluxos de publicação mais comuns.

Ferramentas de espaços de trabalho e contas

list_workspaces — lista os espaços de trabalho disponíveis no Postoria.
list_social_accounts — lista as contas sociais de um espaço de trabalho.
list_queues — lista as filas de um espaço de trabalho.

Essas ferramentas ajudam o cliente de IA a encontrar os IDs do espaço de trabalho, das contas sociais e das filas de que precisa antes de criar um post.

Ferramentas de mídia

import_media_from_url — importa mídia de uma URL pública.
create_media_upload — cria uma URL assinada para envio de mídia.
complete_media_upload — conclui um envio de mídia após o envio dos bytes brutos do arquivo.
upload_media_from_file — envia um arquivo local da máquina que executa o servidor MCP local.
get_media — consulta o status e os detalhes da mídia.

Ferramentas de posts

publish_post_now — publica um post imediatamente.
schedule_post — agenda um post para um horário específico.
add_post_to_queue — adiciona um post a uma fila.
list_posts — lista posts de um espaço de trabalho com filtros e paginação opcionais.
get_post — consulta o status e os detalhes de um post.
delete_post — exclui um post no Postoria. Isso não remove o conteúdo já publicado nas redes sociais.

Opções de mídia

O fluxo de mídia adequado depende de onde o arquivo está e do que seu cliente MCP permite fazer.

Importe mídia de uma URL pública

Use essa opção quando a imagem ou o vídeo já estiver disponível em uma URL pública.

Ela é útil para mídias armazenadas em um site, CMS, biblioteca de arquivos ou outra fonte pública.

O cliente de IA pode chamar import_media_from_url e depois get_media para verificar se o processamento foi concluído.

Envie mídia com uma URL de upload assinada

Use essa opção quando o cliente puder enviar os bytes brutos de um arquivo para uma URL de upload assinada.

O fluxo é:

Chame create_media_upload.
Envie os bytes brutos do arquivo para a URL de upload retornada usando PUT.
Chame complete_media_upload.
Chame get_media para verificar o status da mídia.

Chame complete_media_upload somente depois que os bytes brutos do arquivo tiverem sido efetivamente enviados.

Envie um arquivo local

Use essa opção em fluxos MCP locais de desktop quando quiser enviar um arquivo pelo caminho local.

O cliente de IA pode chamar upload_media_from_file com um caminho de arquivo local. O servidor MCP local envia o arquivo para o Postoria, conclui o upload e retorna o status da mídia.

Exemplos de fluxos de trabalho

Os exemplos de prompts devem soar como pedidos normais de publicação, e não como instruções de API. O cliente MCP pode decidir quais ferramentas do Postoria chamar internamente.

Encontre espaços de trabalho

Peça ao seu cliente MCP:

Mostre os espaços de trabalho do Postoria aos quais tenho acesso.

O cliente deve listar os espaços de trabalho disponíveis para você escolher onde trabalhar.

Encontre contas sociais

Peça ao seu cliente MCP:

Mostre as contas sociais conectadas ao espaço de trabalho ACME Studio.

O cliente deve primeiro encontrar o espaço de trabalho correspondente e depois listar as contas sociais conectadas para você escolher onde publicar.

Publique um post de texto

Peça ao seu cliente MCP:

Publique isto na página do LinkedIn da ACME Studio: Acabamos de publicar um guia de planejamento de lançamentos para equipes pequenas. Ele mostra como organizar os materiais da campanha, as aprovações e os posts agendados antes do dia do lançamento.

Revise o espaço de trabalho, a conta e o texto do post selecionados antes de confirmar a ação.

Agende um post

Peça ao seu cliente MCP:

Agende um post no Instagram para a ACME Studio amanhã às 10h usando a imagem que anexei. Legenda: Uma lista de verificação simples para lançamentos pode economizar horas quando sua equipe prepara conteúdo para vários canais.

O cliente deve preparar o post agendado e mostrar a conta, a mídia e o horário selecionados antes da confirmação da publicação.

Adicione um post a uma fila

Peça ao seu cliente MCP:

Adicione este post de imagem à fila Dicas semanais da ACME Studio usando a imagem que anexei. Legenda: Mantenha uma lista de verificação de lançamento reutilizável para cada campanha, para que sua equipe saiba o que está aprovado, agendado e pronto para publicar.

O cliente deve encontrar a fila, preparar o post com a mídia selecionada e adicioná-lo à fila de publicação escolhida.

Liste posts existentes

Peça ao seu cliente MCP:

Mostre os posts do Instagram agendados no espaço de trabalho ACME Studio.

O cliente pode usar list_posts com filtros como IDs de contas, ID da fila, status do post, redes sociais, intervalo de datas, limite de resultados e cursor de paginação.

Segurança e confirmação

Clientes de IA podem ajudar a preparar ações de publicação, mas você ainda deve revisar os detalhes importantes antes de publicar ou agendar.

Antes de confirmar uma ação de publicação, confira:

Espaço de trabalho
Contas sociais
Filas, se usadas
Legenda
Mídia
Horário agendado e fuso horário do espaço de trabalho
Se a ação publica agora ou agenda para depois

delete_post exclui o post correspondente no Postoria. Ele não remove conteúdo já publicado nas redes sociais. Use essa ferramenta somente quando tiver certeza de que o post deve ser excluído do Postoria.

Código-fonte e pacote

O servidor MCP do Postoria tem código aberto no GitHub:

https://github.com/postoria-app/postoria-mcp-server

O pacote npm está disponível aqui:

https://www.npmjs.com/package/@postoria/mcp-server

Como usar o servidor MCP do Postoria

Antes de começar

Escolha entre uso local e hospedado

Servidor MCP local via npm

Endpoint MCP hospedado do Postoria

Crie uma chave da API pública

Configuração do cliente MCP local

Endpoint MCP hospedado do Postoria

Chave da API pública como token bearer

Ferramentas disponíveis

Ferramentas de espaços de trabalho e contas

Ferramentas de mídia

Ferramentas de posts

Opções de mídia

Importe mídia de uma URL pública

Envie mídia com uma URL de upload assinada

Envie um arquivo local

Exemplos de fluxos de trabalho

Encontre espaços de trabalho

Encontre contas sociais

Publique um post de texto

Agende um post

Adicione um post a uma fila

Liste posts existentes

Segurança e confirmação

Código-fonte e pacote

Empresa

Produto

Suporte

Suporte

Como usar o servidor MCP do Postoria

Antes de começar

Escolha entre uso local e hospedado

Servidor MCP local via npm

Endpoint MCP hospedado do Postoria

Crie uma chave da API pública

Configuração do cliente MCP local

Endpoint MCP hospedado do Postoria

Login via OAuth

Chave da API pública como token bearer

Ferramentas disponíveis

Ferramentas de espaços de trabalho e contas

Ferramentas de mídia

Ferramentas de posts

Opções de mídia

Importe mídia de uma URL pública

Envie mídia com uma URL de upload assinada

Envie um arquivo local

Exemplos de fluxos de trabalho

Encontre espaços de trabalho

Encontre contas sociais

Publique um post de texto

Agende um post

Adicione um post a uma fila

Liste posts existentes

Segurança e confirmação

Código-fonte e pacote