Pular para o conteúdo

Conectar pelo Claude Code

Para programas que rodam no terminal, a conexão usa um token de API da Nebular (começa com nbk_). Você cria o token com só o poder necessário, guarda numa variável de ambiente e registra o conector com um comando.

  1. No console, abra o time e vá em Configurações, depois Tokens de API.
  2. Clique para criar um novo token e use o botão Preset agente (24 h): validade de 24 horas e sem o escopo destroy.
  3. Marque só os escopos que a tarefa precisa. Para publicar e mexer em variáveis, por exemplo: projects:read, projects:write, deploy, env:read, env:write, logs:read.
  4. Restrinja o token aos projetos que o Claude vai usar.
  5. Se for restringir as ações permitidas, inclua me.read e approval.read, senão o Claude não consegue consultar quem é nem o estado de uma aprovação.
  6. Copie o token na hora: ele aparece uma vez só.

Para o Claude poder apagar ou reverter, o token precisa de destroy e da regra de aprovação humana, assim cada ação destrutiva espera a sua decisão. Veja Ações que pedem aprovação e Tokens e escopos.

Janela do terminal
export NEBULAR_TOKEN="nbk_EXEMPLO"

Troque nbk_EXEMPLO pelo seu token, só no terminal. Nunca grave o token em arquivo do repositório nem cole no chat com o Claude.

Janela do terminal
claude mcp add --transport http nebular https://mcp.nebularws.com/mcp \
--header "Authorization: Bearer $NEBULAR_TOKEN"
Janela do terminal
claude mcp list

A linha nebular deve aparecer conectada. Dentro do Claude Code, o comando /mcp mostra o mesmo. Teste pedindo “quem sou eu na Nebular?”; o Claude usa a ferramenta whoami e mostra o token, os escopos e o time.

Em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), com a variável expandida pelo Cursor:

{
"mcpServers": {
"nebular": {
"url": "https://mcp.nebularws.com/mcp",
"headers": {
"Authorization": "Bearer ${env:NEBULAR_TOKEN}"
}
}
}
}

O token só vai no cabeçalho Authorization, nunca na URL: o servidor ignora token na URL.

Sintoma O que fazer
401 ou conector sem conexão Token ausente, expirado (o preset agente dura 24 h) ou revogado. Crie outro e registre de novo.
403 ao usar uma ferramenta O token não tem o escopo daquela ferramenta. Crie outro com o escopo certo.
A ferramenta de apagar não funciona É o esperado no preset agente, que não tem destroy.

Mais casos em Problemas comuns.