Instalación
hackÜ expone un servidor MCP en https://mcp.hacku.com. Conectarlo toma dos
minutos, no requiere instalar nada en tu máquina ni pedirle una clave a nadie:
autorizás con tu propia cuenta de hackÜ, elegís tu empresa, y el asistente queda
con acceso de lectura a los datos de esa empresa.
Conectarlo
Sección titulada «Conectarlo»Hace falta el modo desarrollador, que es lo que habilita agregar un servidor MCP por dirección. Está disponible en los planes Pro, Plus, Business, Enterprise y Edu, solo en la versión web. En Business y Enterprise puede que tu administrador tenga que habilitarlo antes para todo el espacio de trabajo.
-
Abrí Settings → Security and login y activá Developer mode.
-
Andá a Plugins y pulsá el botón + para crear una app de modo desarrollador.
-
Pegá la dirección del servidor:
https://mcp.hacku.com -
Elegí OAuth como método de autenticación. No hay ninguna clave que pegar: el servidor la negocia solo.
-
Se abre la pantalla de autorización de hackÜ. Si no tenés sesión iniciada, te la va a pedir ahí — nunca en el chat.
-
Revisá los permisos y elegí tu empresa en el desplegable. Es la decisión que más importa: el acceso queda fijado a esa empresa y no se puede cambiar sin volver a autorizar.
-
Pulsá Autorizar. La app te queda en Drafts, donde podés prender y apagar herramientas y refrescar la lista si el servidor cambia.
En el chat se usa desde la herramienta Developer mode del compositor. Para llamarlo, nombralo al principio del mensaje:
@hackÜ ¿cómo se llama mi empresa y cuántos colaboradores tenemos?Desde la terminal, con la CLI de Codex:
-
Registrá el servidor:
Ventana de terminal codex mcp add hacku --url https://mcp.hacku.com -
Autenticá:
Ventana de terminal codex mcp login hacku --oauth-client-registration dcrdcres registro dinámico de cliente: Codex se da de alta solo contra hackÜ, así que no hay que pedir ni pegar unclient_id. -
Codex imprime una URL de autorización. Abrila, iniciá sesión en hackÜ, elegí tu empresa en la pantalla de consentimiento y autorizá.
-
El token vuelve por el callback y queda guardado por el cliente. No lo pegues en el chat.
Para confirmar que quedó registrado:
codex mcp listSi querés acotar el alcance desde el principio, pasale los permisos que necesitás y nada más:
codex mcp login hacku --oauth-client-registration dcr \ --scopes users:read,courses:read,communications:read,learning:readEso deja afuera los nombres y correos (users:pii) y el pedido de reportes
(reports:generate). Ver Permisos.
-
Abrí Configuración → Conectores → Agregar conector personalizado.
-
Pegá la dirección del servidor:
https://mcp.hacku.com -
Claude te lleva a la pantalla de autorización de hackÜ. Iniciá sesión si hace falta, elegí tu empresa y autorizá.
-
Volvés a Claude con el conector activo.
Comprobar que quedó bien
Sección titulada «Comprobar que quedó bien»Preguntá esto:
@hackÜ ¿cómo se llama nuestra empresa?Si responde con el nombre de tu empresa, está listo. Si dice que no puede confirmarlo o que no tiene acceso, revisá Problemas comunes.
Si administrás varias empresas
Sección titulada «Si administrás varias empresas»Al autorizar te aparecen todas las que administrás, marcadas. Desmarcá las que no quieras que el asistente pueda consultar y autorizá una sola vez.
A partir de ahí te movés entre ellas en la misma conversación, sin volver a entrar ni a autorizar:
@hackÜ ¿cuánta gente tenemos en Éxito 2?@hackÜ ¿y en Éxito 3?Cada respuesta es de una sola empresa: el servidor nunca mezcla dos. Si la pregunta no deja claro a cuál te referís, el asistente te va a preguntar en lugar de elegir.
Para agregar una empresa que no marcaste, volvé a autorizar y marcala.
Quitar el acceso
Sección titulada «Quitar el acceso»Podés revocar la autorización en cualquier momento desde la configuración de tu cliente, borrando la app o el conector. En Codex:
codex mcp logout hackucodex mcp remove hackuEl acceso también se corta solo si dejás de administrar esa empresa en hackÜ: no hay que acordarse de revocarlo cuando alguien cambia de rol.
Entornos
Sección titulada «Entornos»Además del servidor de producción existe el de QA, que apunta al entorno de pruebas. Se agrega igual, con su propia dirección, así que los dos pueden convivir sin confundirse — en Codex, con otro nombre:
codex mcp add hacku-qa --url https://mcp.qa.hacku.comLos datos que devuelve QA no son los de producción y no sirven para tomar decisiones.
Si tu organización trabaja con hackÜ en un entorno dedicado, pedí la dirección de tu servidor a tu contacto en hackÜ y usala en lugar de la de producción.
