# Conecte o MCP da W8 Hub

> Conecte o MCP da W8 Hub ao Claude Code com OAuth, que alcança várias organizações numa conexão, ou com um token pessoal de permissões granulares.

_Fonte: https://w8hub.com.br/docs/conectar-mcp_

A W8 Hub tem um servidor MCP. Ele deixa um assistente, como o Claude Code, chamar ferramentas da W8 Hub por você. Esta página mostra como conectar, com o login pelo navegador (OAuth) ou com um token pessoal.

## Duas formas de autenticar

O MCP aceita dois métodos. Você escolhe o que combina com o seu uso, e os dois funcionam no Claude Code.

| | Login pelo navegador (OAuth) | Token pessoal |
|---|---|---|
| Como entra | Você autoriza no navegador, na tela da W8 Hub | Você cria o token na sua conta e passa no cabeçalho `Authorization` |
| Alcance | Todas as organizações que você marcar na tela de autorização, numa conexão só | As organizações que você escolheu ao criar o token |
| Limite | O escopo que o agente pedir, limitado ao seu próprio acesso em cada organização marcada | Você escolhe, por organização, por recurso e por ação, e pode limitar a projetos. O token nunca pode mais do que você |
| Indicado para | Uso pessoal e interativo, no seu computador | Permissões granulares, scripts e máquinas sem navegador |

O token pessoal existe para permissões granulares: você escolhe, por organização, por recurso e por ação, e pode limitar a projetos. O OAuth é para uso pessoal e interativo e não tem granularidade escolhida por você: vale o escopo que o agente pedir, limitado ao seu próprio acesso em cada organização marcada.

Nos dois métodos, cada chamada de ferramenta leva o argumento `org`, e a W8 Hub confere sua permissão na organização escolhida antes de executar.

## Conectar com login pelo navegador (OAuth)

O servidor MCP fica em `https://api.w8hub.com.br/mcp`. Ele publica os metadados de OAuth e aceita registro dinâmico de cliente com PKCE. Por isso o cliente não precisa de `client_id` nem de segredo.

1. Adicione o servidor ao Claude Code:

```bash
claude mcp add --transport http w8hub https://api.w8hub.com.br/mcp
```

2. Dentro do Claude Code, rode `/mcp`, escolha o servidor `w8hub` e autentique. O navegador abre na tela de autorização da W8 Hub. Marque uma ou mais organizações, aprove e volte ao Claude Code.

Um caso real: um Claude Code no WSL com Ubuntu autenticou por OAuth na primeira tentativa e foi usado para diagnosticar uma lentidão. O diagnóstico passou por CPU e memória dos containers, ranking de rotas por latência, PostgreSQL, bucket e log de auditoria.

> [!TIP]
> Uma conexão OAuth alcança todas as organizações que você marcar na tela de autorização, numa conexão só. Cada chamada continua limitada ao seu papel na organização do argumento `org`.

## Conectar com token pessoal

O token pessoal troca o login pelo navegador por um cabeçalho `Authorization`. É o caminho quando você quer escolher exatamente o que a credencial pode fazer em cada organização. Crie o token na próxima seção e depois rode:

```bash
claude mcp add --transport http w8hub https://api.w8hub.com.br/mcp --header "Authorization: Bearer w8_..."
```

Não precisa de `?org=` na URL. A organização vai no argumento `org` de cada chamada de ferramenta.

> [!WARNING]
> Esse comando leva o token como texto e ele pode ficar no histórico do seu shell. Trate o token como uma senha.

## Criar o token pessoal

O token pessoal fica na sua conta, não em uma organização.

1. No painel, abra a sua conta e vá à seção "Tokens pessoais". Ali você cria, lista e revoga tokens.
2. Um token alcança várias organizações. Em cada uma, você escolhe o que ele pode fazer: por recurso e por ação, para a organização toda ou só para projetos escolhidos.
3. Copie o valor na criação.

O token nunca pode mais do que você pode.

> [!WARNING]
> O valor completo aparece uma única vez, na criação. Guarde em local seguro. Se o token vazar, revogue na mesma seção.

> [!TIP]
> O token de organização, descrito em [Tokens de API](https://w8hub.com.br/docs/tokens-de-api), é outra coisa e continua valendo.

## Como o assistente escolhe a organização

Cada chamada de ferramenta leva o argumento `org`, que é o id da organização. Ele é obrigatório, exceto na ferramenta `organization_list`, que devolve as organizações que a credencial alcança, com id e nome. Use a `organization_list` para conferir o que o seu token ou a sua conexão alcança. Organização fora do alcance da credencial é recusada.

Para usar o mesmo token pessoal no CLI, veja [CLI da W8 Hub](https://w8hub.com.br/docs/cli).