Servidores MCP oficiais

allPost, SellerPay e HelpyGo publicam dois tipos de servidor MCP: um para consultar a documentação localmente e outro para executar operações reais. Precode e Portal do Seller não anunciam MCP nas fontes consultadas.

MCP de documentação

O servidor de documentação funciona localmente via stdio, usa JSON-RPC 2.0, requer Node.js 18+ e não precisa de token nem internet depois que os arquivos e dependências estiverem disponíveis.

  • listar_endpoints — lista método, rota e descrição.
  • consultar_endpoint — detalha parâmetros, corpo e resposta.
  • consultar_introducao — retorna padrões, autenticação e códigos HTTP.
  • consultar_webhooks — retorna eventos, payloads e retentativas.

Instalação local

Em cada portal, baixe a pasta api/doc/mcp/, instale suas dependências e aponte seu cliente MCP para o arquivo index.js. 

cd caminho/para/api/doc/mcp
npm install
{
  "mcpServers": {
    "helpygo-api": {
      "command": "node",
      "args": ["caminho/para/api/doc/mcp/index.js"]
    }
  }
}

Arquivos usuais: .kiro/settings/mcp.json, .cursor/mcp.json, .vscode/mcp.json, claude_desktop_config.json e .windsurf/mcp.json.

MCP operacional

O servidor em api/doc/mcp-operacional/ faz chamadas HTTP reais e pode criar, alterar ou remover dados. Ele exige internet e o token API da loja.

  • allPost: usa ALLPOST_TOKEN e, para cotações, ALLPOST_TOKEN_COTACAO; publica 10 tools para autenticação, webhook, cotação, pedido, fila e transportadoras.
  • SellerPay: usa SELLERPAY_TOKEN; publica 10 tools para autenticação, webhook, ciclos, fila e pedidos.
  • HelpyGo: usa HELPYGO_TOKEN; publica 8 tools para pedidos, fila, agentes e webhook.
{
  "mcpServers": {
    "allpost-operacional": {
      "command": "node",
      "args": ["caminho/para/api/doc/mcp-operacional/index.js"],
      "env": {
        "ALLPOST_TOKEN": "SEU_TOKEN_API",
        "ALLPOST_TOKEN_COTACAO": "SEU_TOKEN_COTACAO"
      }
    }
  }
}

Segurança

  • Use sempre o Token API da loja, nunca o Token da Aplicação, no MCP operacional.
  • Mantenha segredos fora do arquivo versionado; injete-os pelo ambiente.
  • Revise a tool e os argumentos antes de autorizar operações de escrita.
  • Prefira o MCP de documentação quando a tarefa exigir apenas consulta.

Fontes oficiais