PostPeer

API Unificada de Mídias Sociais

Documentação

Servidor MCP

Conecte Claude, Cursor, ChatGPT e outros agentes de IA ao PostPeer por meio do Model Context Protocol.

O PostPeer executa um servidor MCP (Model Context Protocol) hospedado em https://mcp.postpeer.dev/mcp. Adicione uma URL ao seu cliente de IA e ele terá 34 ferramentas cobrindo todos os endpoints do PostPeer — publicação, agendamento, análises, integrações, perfis, assistentes de IA e muito mais.

Nada para instalar. Nada rodando localmente.

O que é MCP?

Model Context Protocol é um padrão aberto da Anthropic para permitir que assistentes de IA chamem ferramentas externas. Quando você adiciona o servidor MCP do PostPeer a um cliente compatível, a IA pode publicar posts, agendar conteúdo, buscar análises e gerenciar suas contas sociais diretamente.

Conecte seu cliente de IA

Você precisará de uma chave de acesso do PostPeer — obtenha uma no Dashboard.

Claude.ai (web)

No Claude, vá em Customize → Connectors → Add custom connector e cole esta URL no campo Remote MCP:

https://mcp.postpeer.dev/mcp?access_key=YOUR_POSTPEER_API_KEY

Substitua YOUR_POSTPEER_API_KEY pela sua chave de acesso do Dashboard.

Claude Desktop / Claude Code / Cursor

Adicione o seguinte à sua configuração MCP:

{
    "mcpServers": {
        "postpeer": {
            "url": "https://mcp.postpeer.dev/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_POSTPEER_API_KEY"
            }
        }
    }
}

Reinicie o cliente. As ferramentas do PostPeer (create_post, list_integrations, get_analytics, etc.) aparecerão na lista de ferramentas disponíveis.

ChatGPT (e outros clientes MCP Streamable-HTTP)

Mesma estrutura — aponte o cliente para https://mcp.postpeer.dev/mcp e passe Authorization: Bearer YOUR_POSTPEER_API_KEY. Se o seu cliente não suportar cabeçalhos personalizados, acrescente ?access_key=YOUR_POSTPEER_API_KEY à URL.

Ferramentas disponíveis

O servidor MCP expõe uma ferramenta por operação da API pública. As mais comuns:

FerramentaO que faz
list_integrationsMostra contas sociais conectadas
create_postPublica ou agenda um post em uma ou mais plataformas
list_posts / get_post / delete_postNavega e gerencia posts
list_scheduled_posts / reschedule_post / cancel_scheduled_postGerencia a fila de publicação
get_analyticsMétricas de posts entre plataformas
ai_write_content / ai_generate_imageAssistentes de IA para legendas e imagens
get_pinterest_boardsNecessário antes de publicar no Pinterest
get_tiktok_creator_infoNecessário antes de publicar no TikTok
create_profile / list_profiles / update_profileGerenciamento de perfis multi-tenant
create_app / list_appsGerencia aplicativos OAuth BYOK

A lista completa está no repositório MCP: github.com/geiger01/postpeer-mcp.

Experimente

Depois de conectado, pergunte ao seu cliente de IA coisas como:

  • "Liste minhas contas sociais conectadas."
  • "Elabore um tweet anunciando nosso novo produto e agende para amanhã às 9h no horário do leste."
  • "Como foram meus últimos 5 posts no LinkedIn?"
  • "Gere uma imagem para um post sobre os resultados do Q3 e publique no Twitter e no LinkedIn."

A IA chama as ferramentas relevantes, o PostPeer publica e você recebe uma confirmação inline.

Pré-requisitos da plataforma

Antes de publicar em determinadas plataformas, a IA deve chamar uma ferramenta auxiliar primeiro:

  • Pinterest — chame get_pinterest_boards para escolher um board e passe o id do board como platformSpecificData.boardId em create_post. Os pins precisam estar em um board.
  • TikTok — chame get_tiktok_creator_info e passe platformSpecificData.privacyLevel usando um dos privacyLevelOptions retornados. Exigido pelas regras de compartilhamento de conteúdo do TikTok.

A descrição da ferramenta de create_post aponta o modelo para esses pré-requisitos automaticamente, então você não deve precisar solicitá-los.

Autenticação

O servidor MCP aceita sua chave de acesso de três formas (em ordem de prioridade):

  1. Authorization: Bearer <key> — recomendado.
  2. x-access-key: <key> — mesmo cabeçalho usado pela API REST.
  3. ?access_key=<key> na query string — para clientes sem suporte a cabeçalhos personalizados.

O servidor MCP nunca valida a chave em si — ele encaminha cada chamada para api.postpeer.dev, que lida com autenticação, créditos e limite de taxa. Portanto, uso de créditos, limites do plano e permissões da chave de acesso se comportam de forma idêntica à REST.

Auto-hospedagem

Se você precisar do MCP na sua própria infraestrutura (conformidade, domínio personalizado, etc.), o código-fonte é aberto: github.com/geiger01/postpeer-mcp. É um servidor pequeno em Node + Express + @modelcontextprotocol/sdk — roda em qualquer lugar onde Node roda (Railway, Fly, Render, seu próprio VPS).

Solução de problemas

  • 401 Unauthorized — sua chave de acesso está ausente ou inválida. Confirme se o token Bearer está definido na configuração do cliente e se a chave funciona com a API REST.
  • 429 Too Many Requests — limite de taxa do seu plano. Faça upgrade ou espaçe as chamadas.
  • As ferramentas não aparecem no cliente — reinicie o cliente de IA após editar a configuração. Alguns clientes também precisam que o MCP seja habilitado explicitamente nas configurações.

[

Agent Skills

Instale as Agent Skills do PostPeer para que agentes de codificação possam publicar, agendar, enviar mídia, listar contas e buscar análises por meio do PostPeer.

](https://www.postpeer.dev/docs/ai-agents/skills)