Conectar o MCP remoto (Cursor e Claude)

Quando usar

Conecte o MCP quando o lojista ou o integrador quiser consultar rastreio, CEP, pedidos, logística reversa, WhatsApp e webhooks pelo Cursor ou pelo Claude, usando a mesma chave sr_live_ do time. O agente chama as tools; você não monta a requisição HTTP.

Quem pode fazer

Só dono ou admin do time gera a chave. Qualquer pessoa com essa chave no cliente MCP age em nome do time. Não há plano separado só para MCP: vale o plano e a assinatura da empresa. No plano gratuito a consulta de rastreio devolve só o evento mais recente — o MCP não libera o histórico que a API recusa.

Pré-requisitos

• Uma chave de API do time (sr_live_). Passo a passo e prints estão em Criar chaves de API da empresa.
• Cursor ou Claude com suporte a servidor MCP remoto (HTTP).

Passo a passo

1. Copie a chave do time. No painel: Integrações & API → Chaves de API. A chave aparece uma vez. Não cole em ticket nem em print. Os prints desta etapa estão no capítulo de chaves.
2. Cole o JSON no Cursor. Em MCP / servidores remotos, adicione o bloco abaixo e troque sr_live_SUA_CHAVE pela chave real.
3. Ou cole no Claude. Use o snippet com type: "http". A URL é a mesma.
4. Peça um rastreio de teste. O agente deve chamar consultar_rastreio. Se a chave estiver errada, a resposta é 401.

URL do servidor

Streamable HTTP em https://seurastreio.com.br/mcp. Esse endereço é o servidor, não uma página de conversão. Auth: header Authorization: Bearer sr_live_…. Não há OAuth neste v1.

Authorization: Bearer sr_live_SUA_CHAVE

Cursor

{
  "mcpServers": {
    "seurastreio": {
      "url": "https://seurastreio.com.br/mcp",
      "headers": {
        "Authorization": "Bearer sr_live_SUA_CHAVE"
      }
    }
  }
}

Claude

{
  "mcpServers": {
    "seurastreio": {
      "type": "http",
      "url": "https://seurastreio.com.br/mcp",
      "headers": {
        "Authorization": "Bearer sr_live_SUA_CHAVE"
      }
    }
  }
}

Tools e API equivalente

Cada tool espelha uma rota pública. Parâmetros, status e exemplos ficam na página REST — esta tabela só mapeia o nome. Tools que alteram dados exigem confirmação no cliente.

Limites de plano e rate limit

O MCP não tem cota própria. Cada tool herda plano, cota e rate limit da rota REST correspondente:

• Rastreio e CEP: 10/min por IP. Histórico completo de rastreio só em plano pago com assinatura ativa.
• Pedidos: 60/min por IP; pedido novo consome a cota do plano.
• Logística reversa: 10/min por IP; criar consome a cota de reversas.
• WhatsApp: 30/min por chave; exige plano com WhatsApp e instância conectada.

O que o MCP não faz

• Atendimento (inbox), NPS pós-compra e qualquer tela do painel da loja.
• OAuth 2.1, pacote de terminal (npx) ou servidor local.
• Plano ou cobrança só para MCP.
• GET em /mcp não abre chat nem landing — o v1 aceita POST JSON-RPC.

Resultado esperado

O Cursor ou o Claude lista as tools do Seu Rastreio e consulta um código de rastreio com a chave do time. Sem segundo segredo.

Erros comuns

• 401. Chave ausente, copiada pela metade, já revogada ou sem o prefixo Bearer. Gere outra em chaves de API.
• Histórico de rastreio incompleto. Plano gratuito devolve só o último evento. O contrato está na API de rastreio.
• GET /mcp devolve 405. Use o cliente MCP (POST). A conversão humana é esta página, não o path /mcp.
• Descoberta / robots. /mcp e /.well-known/mcp ficam acessíveis; /api/ e o painel continuam bloqueados para crawlers. O manual é /api-docs/mcp.

Relacionados

• Criar chaves de API da empresa
• API de rastreio
• API de CEP
• API de pedidos
• Logística reversa (API)
• API WhatsApp
• Webhooks de rastreio

atualizadoEm

2026-08-21

superficie

api

owner

Technical Writer

printsGeradosEm

2026-08-20