Documentação · MCP

Configuração

Entre no app, selecione a organização e abra Configurações → Desenvolvedores → Acesso. Copie a chave de API e o endereço MCP mostrados ali. Se a interface ainda exibir os rótulos em inglês, procure Settings, Developers e Access.

Essa área exige acesso administrativo, como ADMIN ou SUPERADMIN, e a disponibilidade da API pública no plano. Se não aparecer, confirme a organização e as permissões com seu administrador.

Escolha a forma de autenticação

Cabeçalho: endereço terminado em /mcp, com Authorization: Bearer SUA_CHAVE_POSTORA.
Chave no endereço: copie a URL completa terminada em /mcp/SUA_CHAVE_POSTORA. Nesse caso, o cabeçalho não é necessário. A URL inteira é uma credencial, não a compartilhe.

Use o host real exibido no app. Os valores abaixo são marcadores para substituir, não endereços de produção. O servidor também tem transporte SSE legado, mas estes exemplos usam HTTP. A configuração por chave não depende de uma listagem em marketplace nem de OAuth automático.

Claude Code

No terminal, substitua os dois marcadores. O endereço de cabeçalho é a URL terminada em /mcp.

claude mcp add --transport http \
  --header "Authorization: Bearer SUA_CHAVE_POSTORA" \
  postora "ENDERECO_MCP_COPIADO_DO_APP"

Para a alternativa com chave no endereço, omita --header e use a URL completa copiada do app. Execute claude mcp list ou abra /mcp na sessão para conferir o servidor.

Codex

Adicione ao arquivo ~/.codex/config.toml. Disponibilize a variável POSTORA_API_KEY no ambiente que inicia o Codex, com a chave copiada do app.

[mcp_servers.postora]
url = "ENDERECO_MCP_COPIADO_DO_APP"
bearer_token_env_var = "POSTORA_API_KEY"

Para usar a URL com chave, copie essa URL em url e remova bearer_token_env_var. Confira o servidor com codex mcp list.

Cursor

Adicione ao arquivo ~/.cursor/mcp.json. A variável POSTORA_API_KEY precisa estar disponível no ambiente que inicia o Cursor.

{
  "mcpServers": {
    "postora": {
      "url": "ENDERECO_MCP_COPIADO_DO_APP",
      "headers": {
        "Authorization": "Bearer ${env:POSTORA_API_KEY}"
      }
    }
  }
}

Para usar a chave no endereço, substitua url pela URL completa e remova headers. Confira o status nas configurações de ferramentas MCP do Cursor.

ChatGPT

Na versão web, confira se sua conta permite criar apps MCP personalizados e executar ações de escrita. Em workspaces, o administrador precisa liberar esses recursos. A disponibilidade varia por plano; consulte a documentação de apps MCP do ChatGPT.

Abra as configurações de Apps e a opção de criar um app personalizado, com o modo de desenvolvedor habilitado.
Informe o nome Postora e a URL HTTPS completa com chave, terminada em /mcp/SUA_CHAVE_POSTORA, copiada do app.
Para essa URL com chave, selecione a opção sem autenticação adicional. A credencial já está no endereço. Não insira a chave como segredo de cliente OAuth.
Carregue as ferramentas, salve o app e habilite-o na conversa. Comece com a consulta de canais descrita abaixo.

Este é um caminho de configuração manual a verificar no seu ambiente, não uma conexão Postora já homologada pelo ChatGPT. Se a conta permitir apenas leitura, ela não poderá criar rascunhos nem agendamentos.

Claude

Nas configurações de personalização do Claude, abra Conectores e escolha adicionar um conector personalizado. Dê o nome Postora e informe a URL HTTPS completa com chave copiada do app. Não preencha campos OAuth para essa forma de conexão. Habilite o conector na conversa e teste a consulta aos canais antes de criar posts.

Em contas de equipe, um administrador pode precisar cadastrar o conector para a organização antes de você habilitá-lo. Confira a disponibilidade e as etapas na documentação de conectores remotos do Claude.

Claude Cowork

Configure o conector remoto do Postora conforme os passos para o Claude acima. No Cowork, disponibilize esse conector para a tarefa e confira as permissões de uso das ferramentas. Comece pedindo apenas a lista de canais, depois forneça o briefing e peça uma proposta de calendário.

Arquivos acessíveis à tarefa não são enviados automaticamente ao Postora. Para publicar mídia, use arquivos da biblioteca ou uma URL pública aceita pela ferramenta de importação. Consulte os recursos da sua conta no guia do Cowork.

Conectores remotos precisam alcançar o servidor

ChatGPT, Claude e Cowork precisam alcançar o endpoint HTTPS público do Postora. Um endereço localhost na sua máquina não atende a esse acesso remoto. Estes guias não usam os conectores oficiais do Postiz: cadastre o endereço da sua própria organização no Postora. A URL com chave é uma credencial; não a publique em documentos, mensagens ou repositórios.

Confira a conexão sem publicar

Peça: “Use integrationList para listar meus canais. Não crie nem altere posts.” Compare o resultado com os canais da organização no app. Estes passos descrevem a configuração suportada; a conexão com o endpoint da sua organização ainda precisa passar por essa verificação.

Se não conectar

Chave inválida: confira se a chave pertence à organização selecionada e se não há espaços extras. No cabeçalho, mantenha o prefixo Bearer.
Chave rotacionada: substitua a chave em todos os clientes. Se usava a chave na URL, copie também o novo endereço. Reinicie ou reconecte o cliente.
Configurações ausentes: confira a organização, a função administrativa e o acesso à API no plano.
Servidor indisponível: confira o endereço no app e a disponibilidade do serviço Postora. Não substitua por um endpoint do Postiz.

Evite salvar chaves em arquivos versionados ou em capturas de tela. Uma chave no comando também pode ficar no histórico do terminal.

Documentação dos clientes

Sintaxe conferida em 22 de setembro de 2026. Referências oficiais: ChatGPT, Codex, Cursor, Claude, Claude Code, Claude Cowork.