# 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

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](/mcp/acoes-destrutivas/) e [Tokens e escopos](/seguranca/tokens-e-escopos/).

## 2. Guardar o token numa variável

```bash
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

```bash
claude mcp add --transport http nebular https://mcp.nebularws.com/mcp \
  --header "Authorization: Bearer $NEBULAR_TOKEN"
```

## 4. Conferir

```bash
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.

## Cursor

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

```json
{
  "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

| 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](/mcp/problemas-comuns/).

## Próximos passos

- [Presets e permissões](/mcp/presets-e-permissoes/)
- [O que o Claude pode fazer](/mcp/ferramentas/)
- [Referência técnica para agentes](/agents/mcp/)
