Instalação

A hackÜ expõe um servidor MCP em https://mcp.hacku.com. Conectar leva dois minutos e não exige instalar nada na sua máquina nem pedir uma chave para ninguém: você autoriza com a sua própria conta da hackÜ, escolhe a sua empresa, e o assistente fica com acesso de leitura aos dados dessa empresa.

Você precisa ser staff

O conector só funciona com uma conta que administre pelo menos uma empresa na hackÜ. Se a sua conta for de estudante, a tela de autorização não vai oferecer nenhuma empresa. Fale com quem administra a hackÜ na sua organização.

A conexão é manual, não vem de um diretório

A hackÜ não está publicada no diretório do ChatGPT, então procurar pelo nome não vai encontrar nada. Você adiciona colando o endereço do servidor, que é o que os passos abaixo descrevem. Quando isso mudar, esta página muda.

Conectar

ChatGPT

É preciso o modo desenvolvedor, que é o que permite adicionar um servidor MCP por endereço. Está disponível nos planos Pro, Plus, Business, Enterprise e Edu, somente na versão web. Em Business e Enterprise, talvez o seu administrador precise habilitá-lo antes para todo o espaço de trabalho.

1. Abra Settings → Security and login e ative o Developer mode.

2. Vá em Plugins e clique no botão + para criar um app de modo desenvolvedor.

3. Cole o endereço do servidor:

   https://mcp.hacku.com

4. Escolha OAuth como método de autenticação. Não há chave nenhuma para colar: o servidor negocia sozinho.

5. Abre a tela de autorização da hackÜ. Se você não estiver logado, ela vai pedir ali — nunca no chat.

6. Revise as permissões e escolha a sua empresa na lista. É a decisão que mais importa: o acesso fica fixado nessa empresa e não dá para trocar sem autorizar de novo.

7. Clique em Autorizar. O app fica em Drafts, onde você pode ligar e desligar ferramentas e atualizar a lista se o servidor mudar.

No chat, você chega nele pela ferramenta Developer mode do compositor. Para chamar, cite no começo da mensagem:

@hackÜ como se chama a minha empresa e quantas pessoas temos?

Codex

No terminal, com a CLI do Codex:

1. Registre o servidor:

   codex mcp add hacku --url https://mcp.hacku.com

2. Autentique:

   codex mcp login hacku --oauth-client-registration dcr

   dcr é registro dinâmico de cliente: o Codex se cadastra sozinho na hackÜ, então não há client_id para pedir nem colar.

3. O Codex imprime uma URL de autorização. Abra, entre na hackÜ, escolha a sua empresa na tela de consentimento e autorize.

4. O token volta pelo callback e fica guardado pelo cliente. Não cole ele no chat.

Para confirmar que ficou registrado:

codex mcp list

Se quiser limitar o alcance desde o começo, peça só as permissões de que precisa:

codex mcp login hacku --oauth-client-registration dcr \
  --scopes users:read,courses:read,communications:read,learning:read

Isso deixa de fora os nomes e e-mails (users:pii) e o pedido de relatórios (reports:generate). Veja Permissões.

Claude

1. Abra Configurações → Conectores → Adicionar conector personalizado.

2. Cole o endereço do servidor:

   https://mcp.hacku.com

3. O Claude leva você para a tela de autorização da hackÜ. Entre se precisar, escolha a sua empresa e autorize.

4. Você volta para o Claude com o conector ativo.

Sobre os dados pessoais

O Claude é da Anthropic. Se a sua organização tem acordos de tratamento de dados que cobrem alguns fornecedores e outros não, verifique qual se aplica antes de autorizar a permissão de nomes e e-mails. A permissão é opcional: sem ela o conector funciona igual e as pessoas aparecem identificadas pelo id.

Conferir se deu certo

Pergunte isto:

@hackÜ como se chama a nossa empresa?

Se responder com o nome da sua empresa, está pronto. Se disser que não consegue confirmar ou que não tem acesso, veja Problemas comuns.

Se você administra várias empresas

Ao autorizar aparecem todas as que você administra, já marcadas. Desmarque as que não quiser que o assistente consulte e autorize uma única vez.

A partir daí você se move entre elas na mesma conversa, sem entrar nem autorizar de novo:

@hackÜ quantas pessoas temos na Éxito 2?
@hackÜ e na Éxito 3?

Cada resposta é de uma só empresa: o servidor nunca mistura duas. Se a pergunta não deixa claro a qual você se refere, o assistente vai perguntar em vez de escolher.

Para acrescentar uma empresa que você não marcou, autorize de novo e marque.

Tirar o acesso

Você pode revogar a autorização a qualquer momento nas configurações do seu cliente, apagando o app ou o conector. No Codex:

codex mcp logout hacku
codex mcp remove hacku

O acesso também se encerra sozinho se você deixar de administrar aquela empresa na hackÜ: ninguém precisa lembrar de revogar quando alguém muda de papel.

Ambientes

Além do servidor de produção existe o de QA, que aponta para o ambiente de testes. Adiciona-se do mesmo jeito, com o endereço dele, então os dois convivem sem confusão — no Codex, com outro nome:

codex mcp add hacku-qa --url https://mcp.qa.hacku.com

Os dados que o QA devolve não são os de produção e não servem para tomar decisões.

Se a sua organização trabalha com a hackÜ em um ambiente dedicado, peça o endereço do seu servidor ao seu contato na hackÜ e use no lugar do de produção.