MCP
1. Visión General
La pantalla de MCP Server conecta asistentes de IA (Claude, GitHub Copilot, etc.) directamente a tu cuenta en la plataforma Nukk a través del Model Context Protocol (MCP). En lugar de describirle a la IA lo que existe en tu entorno, ella pasa a consultar y operar la plataforma de verdad, en tiempo real, a través de las herramientas expuestas por el servidor MCP.
En la práctica, esto convierte al asistente de IA en un operador con acceso directo a tu cuenta — capaz de leer el estado actual de la plataforma y ejecutar acciones, siempre restringido al ámbito de tu propia cuenta.
2. Conexión
La pantalla muestra los datos necesarios para conectar un cliente MCP a tu cuenta:
| Campo | Descripción |
|---|---|
| Status | Enabled / OAuth ready — indica que el servidor MCP está activo y listo para la autenticación vía OAuth. |
| Endpoint | URL del servidor MCP de tu cuenta (ej: https://br-1.nukk.com.br/account/nukk/mcp). |
| Client ID | Identificador del cliente OAuth usado en la conexión. |
| Client secret | Secreto del cliente OAuth. Queda oculto por defecto (Reveal para mostrarlo, Rotate para generar uno nuevo). |
| Issuer | URL del emisor de autenticación OAuth (ej: https://auth.br-1.nukk.com.br). |
El botón Refresh actualiza los datos de conexión mostrados en la pantalla.
3. Cómo Conectar
Agrega el Endpoint como un conector personalizado (custom connector) en tu cliente MCP — por ejemplo, en Claude, en Claude Code, o en GitHub Copilot — y autentícate con tu cuenta Nukk. La autenticación usa OAuth (Authorization Code + PKCE), así que no hace falta copiar/pegar credenciales sensibles manualmente en cada conexión: autorizas una vez, mediante el flujo estándar de login.
Una vez conectado, tu asistente de IA pasa a "ver" tu cuenta Nukk a través de las herramientas provistas por el MCP, cubriendo secrets, config maps, artifacts, deploys, routes, consumers y observabilidad — siempre restringidas a tu propia cuenta. No se expone ninguna operación de eliminación (delete), así que el asistente puede consultar y actuar, pero no borrar recursos de la plataforma.
4. Qué se puede hacer con el MCP conectado
Con el MCP habilitado, un asistente como Claude Code deja de ser solo un par de programación sobre código local y pasa a operar la plataforma junto contigo:
- Programar tu aplicación desde el propio asistente — pedirle que escriba, revise o ajuste el código de un Flow, Backend App o Frontend App, ya con el contexto real de lo que está publicado en la plataforma.
- Subir un Flow o hacer el deploy de un app directamente desde la conversación, sin cambiar de pantalla.
- Consultar Config Maps y Secrets vinculados a un entorno para entender rápidamente cómo está configurada una aplicación, sin navegar manualmente por la plataforma.
- Inspeccionar Artifacts, Routes y Consumers para entender qué está expuesto, en qué entorno y con qué configuración de seguridad.
- Consultar observabilidad (logs, métricas) para investigar un problema sin salir del flujo de trabajo del asistente.
Por qué esto importa
- Para quien desarrolla: reduce el ida y vuelta entre el editor de código y la plataforma — el asistente ya sabe qué está implementado, qué secrets/config maps existen, y puede actuar sobre eso directamente, acelerando el debugging y la iteración.
- Para quien gestiona el proyecto: permite pedir una foto del estado actual del entorno (qué está deployado, con qué recursos, qué rutas expuestas) en lenguaje natural, sin depender de que otra persona navegue por la plataforma para responder.
- Para squads enteros: estandariza cómo la IA interactúa con la infraestructura de Nukk — cualquier asistente compatible con MCP pasa a tener el mismo nivel de contexto y capacidad de acción, dentro de los límites de seguridad de la cuenta conectada.
5. Preguntas frecuentes
¿El acceso del MCP se limita a mi cuenta, o se pueden ver datos de otras cuentas/squads? El acceso siempre está restringido al ámbito de la propia cuenta conectada.
¿El asistente de IA puede borrar recursos por el MCP? No — ninguna operación de eliminación (delete) es expuesta por las herramientas del MCP.