Saltar al contenido principal

​
Por qué son importantes los plugins personalizados

Los plugins MCP personalizados permiten a tu equipo conectar a Kody con sistemas internos: bases de conocimiento, paneles de incidencias, motores de políticas, entre otros. Una vez instalados, cada interacción de Kody puede llamar a esas herramientas con datos en tiempo real, de modo que los revisores dejan de copiar capturas de pantalla o fragmentos desactualizados en los pull requests. Esta guía muestra el flujo recomendado para cualquier plugin personalizado, ya sea un endpoint de solo lectura sencillo (como el MCP de Kodus Docs) o un pipeline más avanzado con autenticación.
Kodus admite únicamente servidores MCP remotos, lo que significa que el plugin debe ser accesible desde la infraestructura de Kodus.

​
Prepara la información de tu plugin

Reúne estos datos antes de abrir el catálogo de Plugins:
CampoPor qué importa
URL públicaEndpoint donde está alojado el manifiesto MCP (p. ej., https://acme-internal-tools.com/mcp).
ProtocoloTipo de implementación MCP (HTTP o SSE).
AlojamientoDebe ser un servidor remoto accesible desde Kodus (sin localhost ni endpoints MCP de escritorio).
AutenticaciónSi el plugin requiere claves de API, OAuth, o está abierto a las IPs de tu workspace.
Descripción / LogoAyuda a otros ingenieros a entender qué hace el plugin al navegar por el catálogo.
¿Buscas servidores MCP remotos para probar?
  • Smithery.ai ofrece servicios MCP desplegables junto con un lanzador fácil que puedes apuntar a tu propia infraestructura.
  • Awesome Remote MCP Servers lista endpoints mantenidos por la comunidad que abarcan búsqueda de documentación, escáneres de seguridad y bots de flujo de trabajo.

​
Instala el plugin en Kodus

  1. Ve a Configuración de Code Review → Plugins (beta) dentro de tu workspace de Kodus.
  2. Haz clic en Agregar Plugin.
  3. Completa el formulario: 
    Plugin Name: Etiqueta descriptiva (p. ej., "Security Runbooks MCP")
Description: Qué datos/acciones expone
Logo URL: Opcional, pero útil para identificación
URL: https://your-domain.com/mcp
Protocol: HTTP o SSE
Authorization / Headers: Añade si tu host MCP los requiere (p. ej., clave de API, OAuth, etc.) (opcional)
  4. Haz clic en Crear Plugin. Una vez que aparezca en la lista, estará disponible de inmediato para todo el workspace.
Los plugins personalizados se ejecutan con los mismos permisos que el workspace. Solo instala endpoints en los que tu organización confíe y que pueda monitorear.

​
Verifica la conexión

  1. Abre cualquier pull request donde Kody esté habilitado.
  2. Menciona @kody e incluye una pregunta que obligue al plugin a responder. 
    @kody ¿puedes obtener la lista de verificación de despliegue desde nuestro MCP y confirmar si se requieren feature flags?
  3. En el panel lateral, revisa la sección Plugins. Deberías ver una llamada a tu nuevo plugin. Si falla, expande el error para inspeccionar el código de estado o el mensaje de validación.
El MCP de Kodus Docs (https://docs.kodus.io/mcp) es una prueba de verificación rápida: puedes instalarlo primero para asegurarte de que tu workspace puede alcanzar hosts externos.

​
Lista de verificación rápida

  • El manifiesto del plugin está alojado y es accesible.
  • El modelo de autenticación (si existe) está documentado y probado.
  • El plugin está instalado mediante Agregar Plugin Personalizado con la URL y los encabezados correctos.
  • Un PR de prueba confirmó que Kody puede llamar al plugin.
  • Los responsables saben cómo monitorear y actualizar la integración.