Conecte o MCP da W8 Hub

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.

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.

Adicione o servidor ao Claude Code:

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

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.

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:

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.

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.

No painel, abra a sua conta e vá à seção "Tokens pessoais". Ali você cria, lista e revoga tokens.
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.
Copie o valor na criação.

O token nunca pode mais do que você pode.

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

O token de organização, descrito em 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.

Anterior← Tokens de API PróximoCLI →