Criar chaves de API da empresa

Autentique as chamadas da sua integração com uma chave do time. A chave aparece uma vez; depois só é possível revogar.

Quando usar

Crie uma chave quando um sistema da sua empresa (ERP, site ou script) for consultar rastreio, CEP, pedidos, WhatsApp ou logística reversa pela API pública.

Quem pode fazer

Só dono ou admin do time cria, lista e revoga chaves. Membros veem a tela, mas não gerenciam chaves. Times com plano pago e assinatura ativa recebem o histórico completo na API de rastreio; no plano gratuito a API devolve só o último evento.

Pré-requisitos

  • Papel de dono ou admin na empresa.
  • Um nome para identificar a chave (ex.: ERP produção, site da loja).

Passo a passo

  1. 1. Abra Chaves de API. No menu Integrações & API → Chaves de API você vê as chaves ativas do time.

    Abrir Dashboard → Integrações & API → Chaves de API
    Abrir Dashboard → Integrações & API → Chaves de API
  2. 2. Crie a chave. Clique em Criar chave, informe um nome e confirme.

    Clicar em Criar chave e preencher o nome da integração
    Clicar em Criar chave e preencher o nome da integração
  3. 3. Copie o valor agora. A chave começa com sr_live_ e não volta a ser exibida. Copie e guarde no cofre da sua empresa. O uso é o header Authorization: Bearer sr_live_….

    Copiar a chave de staging sr_live_docs_staging_exemplo que aparece uma única vez
    Copiar a chave de staging sr_live_docs_staging_exemplo que aparece uma única vez
  4. 4. Revogue se vazar. Na lista, revogue a chave comprometida e crie outra. Chamadas com a chave antiga passam a ser recusadas.

    Revogar a chave na lista de chaves da empresa
    Revogar a chave na lista de chaves da empresa

Resultado esperado

A integração autentica nas APIs públicas do time. Um primeiro teste está no Início rápido.

Usar no Cursor / Claude

A mesma chave autentica o servidor MCP remoto. Cole um dos JSONs abaixo no cliente e troque sr_live_SUA_CHAVE. Passo a passo, tools e limites: Conectar o MCP remoto.

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"
      }
    }
  }
}

Erros comuns

  • 401. Chave copiada pela metade, já revogada ou enviada sem o prefixo Bearer.
  • Sem botão Criar chave. Você está como membro. Peça a um dono ou admin.
  • Histórico ausente na API de rastreio. O plano gratuito devolve só o último evento. O contrato está na página da API de rastreio.

Relacionados

Caminho no painel: Dashboard → Chaves de API.

atualizadoEm
superficie
dashboard
owner
Technical Writer
printsGeradosEm