Skip to main content
O PostClean tem um servidor MCP (Model Context Protocol) próprio, que deixa assistentes de IA cuidarem do agendamento das suas redes sociais. O assistente pode criar, agendar, colocar na fila e publicar posts, cuidar das aprovações, organizar ideias, ler as análises e o relatório de tráfego pago, e gerenciar assinaturas, etiquetas, horários de postagem, webhooks, reposts e chaves de API, tudo em linguagem natural.

​
O que é MCP?

MCP é um protocolo aberto que conecta assistentes de IA a ferramentas e fontes de dados externas. Em vez de você copiar e colar chamadas de API, o assistente conversa direto com o PostClean.

​
Ferramentas disponíveis

O servidor oferece 82 ferramentas. Veja a referência de ferramentas para conhecer cada argumento e o fluxo recomendado.

​
O que o MCP não faz

  • Gerar conteúdo com IA. Não existe ferramenta MCP para gerar ou reescrever conteúdo. O próprio assistente escreve o texto e envia para o PostClean; o assistente de escrita com IA fica no app web. O Repost pode encurtar legendas com IA em segundo plano, inclusive nas regras criadas pelo MCP.
  • Conectar, reconectar ou desconectar canais, transformar ideias em posts, gerenciar modelos, membros, convites, cobrança ou as automações do Instagram. Para isso, use o app web.

​
Como funciona

O MCP precisa de uma conta com acesso ao app (assinatura ativa). Veja Planos e cobrança.
1

Adicione o servidor MCP do PostClean no seu assistente

Na configuração de MCP do assistente, adicione um servidor HTTP remoto apontando para https://post.chatclean.com.br/mcp/trypost. Cada guia de cliente, no fim desta página, traz o comando ou o arquivo de configuração exato.
2

Entre na sua conta e escolha um workspace

Na primeira conexão, o PostClean abre uma janela do navegador. Entre na sua conta, escolha o Workspace que essa conexão pode usar e clique em Autorizar. A partir daí o assistente guarda o token OAuth e o renova sozinho.
3

Comece a usar em linguagem natural

Peça ao assistente para cuidar da sua conta do PostClean. Por exemplo: “Coloque um post do LinkedIn no próximo horário livre da fila” ou “Liste os meus posts aguardando aprovação”.

​
URL do servidor

O caminho termina mesmo em /mcp/trypost. O PostClean é construído sobre o TryPost, de código aberto, e mantém o mesmo caminho do servidor.

​
Autenticação

O servidor MCP do PostClean usa OAuth 2.1 com Dynamic Client Registration (DCR), PKCE e o escopo mcp:use. Os clientes MCP atuais detectam isso sozinhos pelos endpoints de descoberta .well-known: você só informa a URL e o login no navegador resolve o resto. Cada conexão fica presa ao workspace escolhido na tela de consentimento (“Esta conexão terá acesso somente ao workspace selecionado.”). Para trabalhar em outro workspace, conecte de novo e escolha esse workspace. Os assistentes conectados ficam em Configurações → MCP do workspace, onde você também pode desconectá-los.
As chaves de Configurações → API Keys autenticam apenas a API REST. Elas não são aceitas em /mcp/trypost. O MCP exige uma autorização OAuth com o escopo mcp:use (login no navegador a partir de um cliente compatível).

​
Permissões

Qualquer membro do workspace pode conectar um assistente, não só os admins (a API REST aceita apenas chaves de admins). O assistente pode fazer o que você faz no app:
  • Qualquer membro pode escrever posts, notas, ideias, etiquetas e assinaturas e ler as análises.
  • Membros que precisam de aprovação: os posts que eles agendam, colocam na fila ou publicam ficam como pending_approval até alguém que publica direto aprovar. Peça ao assistente para chamar get-workspace-tool e saber qual é o seu caso.
  • Membros que publicam direto também podem aprovar e rejeitar posts, mudar a ordem da fila, definir recorrência e usar o Repost.
  • Admins também podem mudar os horários de postagem e gerenciar webhooks e chaves de API.
Veja Membros e permissões e Aprovações.

​
Solução de problemas

A autorização OAuth é válida e a configuração está certa, mas a conta não tem assinatura ativa. Abra o PostClean, escolha um plano e conecte o servidor MCP de novo.
A sessão OAuth expirou e a renovação falhou; o token de acesso está faltando, malformado ou foi revogado (sair do workspace revoga o token); ou o workspace ligado a ele foi excluído (No workspace selected.). Rode de novo o fluxo de conexão do assistente para entrar outra vez.
A requisição usou uma chave de API (Personal Access Token) ou um token OAuth sem o escopo mcp:use. Tire qualquer chave de API Authorization: Bearer … da configuração do MCP e conecte com OAuth. Para scripts e CI, use a API REST com uma chave de API (só admins do workspace), não o endpoint do MCP.
A conexão está ligada a um workspace ao qual você não tem mais acesso. Conecte de novo e escolha um workspace do qual você faz parte.
Rode o teste de conexão que o seu assistente oferece (por exemplo claude mcp list ou devin mcp list). O status HTTP do teste mostra qual é o caso: 402 → veja acima; 401 → autentique de novo; 403 → veja os dois itens de 403 acima (use OAuth, não chave de API; ou conecte de novo a um workspace do qual você faz parte); qualquer outro → escreva para contato@chatclean.com.br.
Alguns clientes imprimem a URL de autorização no terminal em vez de abrir o navegador quando rodam por SSH ou dentro de um container. Copie a URL para um navegador local, conclua o fluxo e o assistente recebe o retorno sozinho. Se a porta de retorno estiver bloqueada, use um cliente que conclua o OAuth localmente ou use o PostClean pela API REST com uma chave de API (só admins do workspace).

​
Próximos passos

Todas as páginas de Construa com IA estão aqui: a referência de ferramentas e os 18 guias de configuração.

Referência de ferramentas

Todas as ferramentas MCP, os parâmetros e o fluxo de publicação.

Claude web

Claude na web (claude.ai).

Claude Code

Assistente de terminal da Anthropic.

Claude Desktop

App de desktop da Anthropic.

ChatGPT

ChatGPT da OpenAI com apps MCP.

Muse AI Agent

Agente pessoal da Meta.

Muse Code

Assistente de terminal da Meta.

Perplexity

Chat e Computer do Perplexity.

Grok

Grok na web, no iOS e no Android.

Cursor

Editor de código com IA.

Devin

Engenheiro de software com IA da Cognition.

VS Code

Suporte nativo a MCP no Copilot Chat.

GitHub Copilot

Modo agente do Copilot.

Gemini CLI

Assistente de terminal do Google.

OpenCode

Assistente de terminal de código aberto.

OpenClaw

Gateway de assistente pessoal de IA.

Hermes

Hermes Agent da Nous Research.

Codex

Agente de terminal da OpenAI.

Antigravity

Agente de IA do Google.