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. Criar o token
Seção intitulada “1. Criar o token”- No console, abra o time e vá em Configurações, depois Tokens de API.
- Clique para criar um novo token e use o botão Preset agente (24 h): validade de 24 horas e sem o escopo
destroy. - 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. - Restrinja o token aos projetos que o Claude vai usar.
- Se for restringir as ações permitidas, inclua
me.readeapproval.read, senão o Claude não consegue consultar quem é nem o estado de uma aprovação. - 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.
2. Guardar o token numa variável
Seção intitulada “2. Guardar o token numa variável”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.
3. Registrar o conector
Seção intitulada “3. Registrar o conector”claude mcp add --transport http nebular https://mcp.nebularws.com/mcp \ --header "Authorization: Bearer $NEBULAR_TOKEN"4. Conferir
Seção intitulada “4. Conferir”claude mcp listA 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.
Se algo der errado
Seção intitulada “Se algo der errado”| 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.