PostSider

A plataforma definitiva de agendamento para redes sociais

Servidor MCP hospedado

npx add-mcp 'https://mcp.postsider.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Conecte agentes de IA ao PostSider por meio das ferramentas do servidor MCP

O servidor MCP do PostSider expõe 19 ferramentas para agentes de IA. Ele é distribuído como o pacote npm @postsider/mcp e roda localmente via stdio; não há página de painel.

O PostSider inclui um servidor MCP, @postsider/mcp, que expõe 19 ferramentas por meio da API REST pública. Ele implementa o Model Context Protocol e roda localmente via stdio. Funciona com o PostSider Cloud ou qualquer instância auto-hospedada.

Nota

O servidor MCP é um servidor stdio local que seu cliente MCP inicia. Ele é distribuído como o pacote npm @postsider/mcp, não é uma página de painel e não é hospedado pelo PostSider Cloud. Sua chave de API permanece na configuração do seu próprio cliente MCP e é enviada apenas para sua instância do PostSider. O servidor requer Node.js 20.17 ou mais recente.

Antes de começar

No painel do PostSider, vá em **Configurações → API** e crie uma chave de API da organização. Copie-a agora; ela é exibida apenas uma vez. Consulte [Autenticação](/agent/authentication) para detalhes. Conecte Claude Code, Claude Desktop, Cursor, Codex ou qualquer cliente compatível com MCP usando os comandos abaixo. `npx` baixa o pacote publicado na primeira execução, então não há nada para clonar ou compilar.

Conecte o Claude Code

Use claude mcp add com npx e passe sua chave como uma variável de ambiente:

claude mcp add postsider -e POSTSIDER_API_KEY=your-api-key -- npx -y @postsider/mcp

Reinicie o Claude Code para que ele aplique a alteração e peça para "listar meus canais do PostSider" para confirmar a conexão.

Dica

O Claude Code também pode instalar o servidor como um plugin, que inclui um fluxo de trabalho com skill de leitura e rascunho primeiro:
claude plugin marketplace add lumizone/postsider
claude plugin install postsider@postsider
Passe a chave no momento da instalação com --config api_key=your-api-key ou defina-a depois com /plugin configure postsider@postsider.

Conecte o Codex

O Codex — o CLI, o aplicativo de desktop do ChatGPT e a extensão do IDE — compartilham uma única configuração de MCP. Registre o PostSider com codex mcp add e passe sua chave como uma variável de ambiente:

codex mcp add postsider --env POSTSIDER_API_KEY=your-api-key -- npx -y @postsider/mcp

Em seguida, inicie uma nova sessão do Codex e peça para "listar meus canais do PostSider". Execute codex mcp list para confirmar que o servidor está registrado ou /mcp dentro do TUI do Codex. No aplicativo de desktop do ChatGPT e na extensão do IDE, abra Configurações → Servidores MCP → Adicionar servidor, escolha STDIO e forneça npx -y @postsider/mcp com a mesma variável de ambiente.

Conecte Claude Desktop, Cursor e outros clientes

A maioria dos clientes MCP usa a mesma estrutura JSON. Adicione o PostSider sob a chave mcpServers do seu cliente, executando o servidor com npx:

{
  "mcpServers": {
    "postsider": {
      "command": "npx",
      "args": ["-y", "@postsider/mcp"],
      "env": {
        "POSTSIDER_API_KEY": "your-api-key"
      }
    }
  }
}

Configuração

O servidor é configurado inteiramente por meio de variáveis de ambiente.

Variável	Obrigatória	Padrão	Descrição
`POSTSIDER_API_KEY`	Sim	(nenhum)	Chave de API da organização em Configurações → API
`POSTSIDER_API_URL`	Não	`https://api.postsider.com`	URL base da sua instância do PostSider

Nota

No PostSider Cloud, o padrão está correto. Em uma instância auto-hospedada, a API pública é servida em /api atrás do nginx incluído, então defina POSTSIDER_API_URL para o seu domínio mais /api, por exemplo https://social.example.com/api. O servidor acrescenta /public/v1 ao que você definir. HTTP simples é aceito apenas em loopback (localhost, 127.0.0.1, [::1]).

Ferramentas disponíveis

O PostSider expõe 19 ferramentas. Consulte a Referência de ferramentas para parâmetros completos e exemplos.

Ferramenta	Descrição
`postsider_list_channels`	Lista canais conectados com ids, nomes e plataformas
`postsider_get_agency_overview`	Obtém contagens operacionais da organização e erros recentes
`postsider_get_customer_report`	Obtém um relatório de agência com escopo por cliente
`postsider_list_groups`	Lista grupos de canais
`postsider_find_slot`	Retorna o próximo slot de fila livre para um canal (UTC)
`postsider_list_posts`	Lista publicações dentro de um intervalo de datas
`postsider_get_post_missing_fields`	Validação por canal para uma publicação antes de publicar
`postsider_get_post`	Obtém uma publicação por id
`postsider_get_post_analytics`	Análises de uma única publicação
`postsider_get_channel_analytics`	Análises em nível de conta para um canal
`postsider_get_notifications`	Notificações recentes, como falhas de publicação
`postsider_get_publishing_state`	Indica se a publicação está ativa ou pausada para a organização
`postsider_upload_media_from_url`	Importa uma imagem ou vídeo para a biblioteca de mídia
`postsider_create_post`	Cria, agenda ou publica uma publicação em vários canais
`postsider_update_post_status`	Altera o status de uma publicação
`postsider_delete_post`	Exclui uma publicação e todas as outras versões dela em outros canais
`postsider_request_approval`	Solicita aprovação para uma publicação
`postsider_get_approval_status`	Lê o status de aprovação de uma publicação
`postsider_pause_publishing`	Parada de emergência para a organização: publicações na fila são retidas e novas publicações são recusadas. A retomada é exclusiva para humanos

Dica

Comece todo fluxo de trabalho com postsider_list_channels. Os ids de canais retornados por ele são necessários para as ferramentas de agendamento, análises e publicação.

A partir do código-fonte (opcional)

Para compilar o servidor a partir do repositório em vez de usar o pacote publicado, clone-o e compile apps/mcp:

git clone https://github.com/lumizone/postsider.git
cd postsider
pnpm install
pnpm --filter @postsider/mcp build

Em seguida, aponte seu cliente para apps/mcp/dist/index.js com node:

{
  "mcpServers": {
    "postsider": {
      "command": "node",
      "args": ["/absolute/path/to/apps/mcp/dist/index.js"],
      "env": {
        "POSTSIDER_API_KEY": "your-api-key"
      }
    }
  }
}

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.