Onepostly MCP

Servidor MCP

Servidor MCP remoto para Onepostly — publique, agende e meça a partir de qualquer cliente MCP.

Copiar Markdown

A Onepostly fornece um servidor MCP remoto via HTTP Streamable.

https://mcp.onepostly.com

https://mcp.onepostly.com/mcp também está disponível como um alias.

Autenticação

Autentique-se com uma chave de API do workspace. Crie uma em Dashboard → Configurações → Chaves de API.

Authorization: Bearer op_YOUR_KEY

x-api-key: op_YOUR_KEY

Para clientes que não podem definir cabeçalhos (ex.: Claude.ai web), use o parâmetro de consulta:

https://mcp.onepostly.com?access_key=op_YOUR_KEY

Chaves read_only podem chamar ferramentas list_* e get_*; ferramentas de escrita retornam FORBIDDEN.

Ferramentas

Ferramenta	Descrição
list_connections	Listar contas conectadas (filtrar por plataforma)
publish_post	Publicar imediatamente — todas as plataformas, validação por plataforma, débito na carteira
schedule_post	Agendar para o futuro (scheduledFor horário local + fuso horário)
list_posts	Listar posts, mais recentes primeiro
get_post_status	Obter status do post e do destino
get_insights	Obter métricas normalizadas para um post
delete_post	Excluir um destino publicado
get_pinterest_boards	Listar quadros do Pinterest (chamar antes de publicar no Pinterest)
get_tiktok_creator_info	Obter opções de privacidade do criador do TikTok (chamar antes de publicar no TikTok)

publish_post e schedule_post compartilham a mesma validação que POST /v1/posts. O uso de X é cobrado diretamente da sua carteira. 402 INSUFFICIENT_WALLET significa recarregar em Configurações → Cobrança.

Conectar

Claude Desktop, Claude Code, Cursor

{
  "mcpServers": {
    "onepostly": {
      "url": "https://mcp.onepostly.com",
      "headers": {
        "Authorization": "Bearer op_YOUR_KEY"
      }
    }
  }
}

Claude.ai (web)

Cole a URL com ?access_key:

Inspector

npx @modelcontextprotocol/inspector@latest

• URL: https://mcp.onepostly.com
• Header: Authorization: Bearer op_YOUR_KEY
• Header: MCP-Protocol-Version: 2025-11-25

Exemplos

Listar conexões

tool: list_connections

Publicar

{
  "tool": "publish_post",
  "arguments": {
    "text": "Hello from Onepostly",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Agendar

{
  "tool": "schedule_post",
  "arguments": {
    "text": "Hello tomorrow",
    "scheduledFor": "2026-08-10T09:00:00",
    "timezone": "America/New_York",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Protocolo

• Transporte: HTTP Streamable (POST JSON-RPC 2.0).
• Versão: 2025-11-25 (cabeçalho MCP-Protocol-Version e params._meta["io.modelcontextprotocol/protocolVersion"]).
• Descoberta: server/discover retorna supportedVersions e capabilities.

Notas

• Sem notificações iniciadas pelo servidor; consulte get_post_status ou use webhooks.
• Os limites de taxa e carteira são idênticos aos da API REST.

Introdução

Uma API para todas as redes sociais.

Início rápido

Publique seu primeiro post com uma chave de API.