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:
| Ferramenta | O que faz |
|---|---|
list_integrations | Mostra contas sociais conectadas |
create_post | Publica ou agenda um post em uma ou mais plataformas |
list_posts / get_post / delete_post | Navega e gerencia posts |
list_scheduled_posts / reschedule_post / cancel_scheduled_post | Gerencia a fila de publicação |
get_analytics | Métricas de posts entre plataformas |
ai_write_content / ai_generate_image | Assistentes de IA para legendas e imagens |
get_pinterest_boards | Necessário antes de publicar no Pinterest |
get_tiktok_creator_info | Necessário antes de publicar no TikTok |
create_profile / list_profiles / update_profile | Gerenciamento de perfis multi-tenant |
create_app / list_apps | Gerencia 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_boardspara escolher um board e passe o id do board comoplatformSpecificData.boardIdemcreate_post. Os pins precisam estar em um board. - TikTok — chame
get_tiktok_creator_infoe passeplatformSpecificData.privacyLevelusando um dosprivacyLevelOptionsretornados. 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):
Authorization: Bearer <key>— recomendado.x-access-key: <key>— mesmo cabeçalho usado pela API REST.?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.