> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# MCP no Claude Code

## Prepare o client público

Solicite um client OAuth público com PKCE S256. Para o exemplo abaixo, ele precisa aceitar **`http://localhost:8765/callback`**. O client do piloto do ChatGPT usa outro callback e não deve ser presumido compatível.

O exemplo é para uma versão atual do Claude Code que suporta client OAuth pré-cadastrado. Confira `claude mcp add --help` se suas opções diferirem.

## Adicione e autentique

```bash
claude mcp add --transport http   --client-id "$ORBITA_MCP_CLIENT_ID"   --callback-port 8765   orbita https://mcp.nexxo.tec.br/mcp
```

Abra o Claude Code, execute **`/mcp`** e conclua o login no navegador. Para conferir o cadastro:

```bash
claude mcp get orbita
claude mcp list
```

O client público não usa a flag `--client-secret`. Se a porta estiver ocupada, escolha outra e registre o callback correspondente no provedor antes de autenticar.

## Arquivo de projeto

Quando quiser compartilhar apenas o cadastro do servidor com a equipe, use `.mcp.json` na raiz do projeto:

```json
{
  "mcpServers": {
    "orbita": {
      "type": "http",
      "url": "https://mcp.nexxo.tec.br/mcp",
      "oauth": {
        "clientId": "CLIENT_ID_CADASTRADO_PARA_CLAUDE",
        "callbackPort": 8765,
        "scopes": "openid profile email offline_access"
      }
    }
  }
}
```

O arquivo contém o ID público e o endpoint. A sessão OAuth permanece vinculada à pessoa; não inclua access tokens ou refresh tokens nele. O Claude pode pedir a aprovação do cadastro de projeto antes de conectar.

Referência do cliente: [MCP no Claude Code](https://code.claude.com/docs/en/mcp).
