openthorDocumentação
Abrir o painel

Claude Code e API REST (o caminho da chave)

Scripts, planilhas, integrações e o terminal falam com o OpenThor por uma chave de API — a ot_live_…. Este é o único caminho em que a chave é colada em algum lugar.

Quando usar este caminho

Use a chave quando um programa vai chamar o OpenThor: um script, uma planilha que puxa dados, uma integração, ou o Claude Code no terminal. Para conectar o claude.ai, o ChatGPT ou o Claude Desktop, a chave não serve — esses clientes conectam por login e aprovação, sem chave. Veja Conectar o claude.ai.

Passo 1 — crie a chave

No painel (app.openthor.dev), disponível para administradores da organização:

  1. Abra Chaves & Uso.
  2. Clique em Nova chave.
  3. Preencha o Rótulo da chave (ex.: “planilha de vendas”), marque os Escopos que ela pode acessar e defina o Limite de requisições (rpm).
  4. Clique em Criar chave.

O que você deve ver: a tela “Chave criada com sucesso”, com o valor completo da chave e um botão de copiar.

A chave aparece uma única vez

Copie agora — esta é a única vez que o valor completo é exibido. Guarde em um gerenciador de segredos. Depois, o painel mostra só o prefixo. Perdeu? Revogue e crie outra.

Passo 2 — conecte o Claude Code

No terminal, adicione o OpenThor com a chave no cabeçalho:

terminal
claude mcp add --transport http openthor https://api.openthor.dev/mcp \
  --header "Authorization: Bearer ot_live_SEU_TOKEN_AQUI"

Depois, confirme:

terminal
claude mcp list

O que você deve ver: openthor: connected na lista. A partir daí, é só perguntar em português dentro do Claude Code — ele escolhe a ferramenta certa.

Alternativa sem chave (OAuth)

O Claude Code também aceita o caminho de login: adicione o servidor sem o cabeçalho e rode o comando /mcp dentro da sessão — ele abre o navegador para você entrar no OpenThor e aprovar, como nos clientes de chat.

Passo 3 — chame a API REST

A mesma chave autentica a API REST:

cURL
curl -H "Authorization: Bearer ot_live_SEU_TOKEN_AQUI" \
  "https://api.openthor.dev/v1/agg/sales/summary?from=2026-06-01&to=2026-06-30"

O que você deve ver: um JSON com data e meta. Detalhes de autenticação em Autenticação; filtros, ordenação e paginação em Sintaxe de consulta.

Deu errado?

401 apesar de “connected”, chave revogada e outros sintomas: Problemas de conexão.