Saltar al contenido

MCP Server

Abrir en ChatGPT

El servidor del Protocolo de Contexto del Modelo (MCP) de webforJ proporciona a los asistentes de IA acceso directo a la documentación oficial de webforJ, ejemplos de código verificados y patrones específicos del marco, permitiendo respuestas con respuestas más precisas y generación automatizada de proyectos específicamente para el desarrollo de webforJ.

¿Qué es un MCP?​

El Protocolo de Contexto del Modelo es un estándar abierto que permite a los asistentes de IA conectarse con herramientas y documentación externas. El servidor MCP de webforJ implementa este protocolo para proporcionar:

  • Búsqueda de Conocimientos - Búsqueda en lenguaje natural a través de la documentación de webforJ, ejemplos de código y patrones
  • Generación de Proyectos - Crear aplicaciones de webforJ a partir de plantillas oficiales con la estructura adecuada
  • Creación de Temas - Generar temas CSS accesibles siguiendo los patrones de diseño de webforJ

¿Por qué usar MCP?​

Mientras que los asistentes de codificación de IA sobresalen en responder preguntas básicas, tienen dificultades con consultas complejas específicas de webforJ que abarcan múltiples secciones de documentación. Sin acceso directo a fuentes oficiales, pueden:

  • Generar métodos que no existen en webforJ
  • Referirse a patrones de API obsoletos o incorrectos
  • Proporcionar código que no compilará
  • Confundir la sintaxis de webforJ con otros marcos de Java
  • Malinterpretar patrones específicos de webforJ

Con la integración de MCP, las respuestas de IA están ancladas a la documentación oficial de webforJ, ejemplos de código y patrones de marco, proporcionando respuestas verificables con enlaces directos a fuentes oficiales para una exploración más profunda.

La IA aún puede cometer errores

Si bien MCP mejora significativamente la precisión al proporcionar acceso a recursos oficiales de webforJ, no garantiza una generación de código perfecta. Los asistentes de IA aún pueden cometer errores en escenarios complejos. Siempre verifica el código generado y prueba exhaustivamente antes de usarlo en producción.

Instalación​

El servidor MCP de webforJ está alojado en https://mcp.webforj.com con dos puntos finales:

  • Punto final de MCP (/mcp) - Para Claude, VS Code, Cursor
  • Punto final de SSE (/sse) - Para clientes heredados

Usa el comando CLI de Claude para registrar el servidor:

claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user

Esto configurará automáticamente el servidor MCP en tu entorno de Claude Code.

Herramientas disponibles​

Las herramientas son funciones especializadas que el servidor MCP proporciona a los asistentes de IA. Cuando haces una pregunta o solicitud, la IA puede llamar a estas herramientas para buscar documentación, generar proyectos o crear temas. Cada herramienta acepta parámetros específicos y devuelve datos estructurados que ayudan a la IA a proporcionar asistencia precisa y contextualizada.

Esta herramienta proporciona capacidades de búsqueda semántica a través de todo el ecosistema de documentación de webforJ. Entiende el contexto y las relaciones entre diferentes conceptos del marco, devolviendo secciones relevantes de documentación, referencias de API y ejemplos de código funcional.

Consultas de ejemplo:

"Buscar documentación de webforJ para el componente Botón con ejemplos de iconos"

"Encontrar patrones de validación de formularios de webforJ en la documentación más reciente"

"Muéstrame la configuración actual de enrutamiento de webforJ con la anotación @Route"

"Buscar en la documentación de webforJ patrones de diseño responsivo de FlexLayout"

"Encontrar integración de componentes web de webforJ en la documentación oficial"

Estructura aplicaciones completas de webforJ utilizando arquetipos oficiales de Maven. La herramienta crea un diseño de directorio de proyecto estandarizado e incluye código inicial basado en la plantilla seleccionada. Los proyectos generados incluyen un sistema de construcción listo para usar, carpetas de recursos y archivos de configuración para desarrollo y despliegue inmediatos.

Prompts de ejemplo:

"Crear un proyecto de webforJ llamado CustomerPortal utilizando el arquetipo hello-world"

"Generar un proyecto de webforJ Spring Boot con diseño de pestañas llamado Dashboard"

"Crear una nueva aplicación webforJ con el arquetipo de menú lateral para el proyecto AdminPanel"

"Generar un proyecto vacío de webforJ llamado TestApp con groupId com.example"

"Crear un proyecto de webforJ InventorySystem utilizando el arquetipo de menú lateral con Spring Boot"

Al usar esta herramienta, puedes elegir entre varias plantillas de proyecto:

Arquetipos (plantillas de proyecto):

  • hello-world - Aplicación básica con componentes de muestra para demostrar características de webforJ
  • blank - Estructura mínima de proyecto para comenzar desde cero
  • tabs - Diseño de interfaz con pestañas preconstruido para aplicaciones de múltiples vistas
  • sidemenu - Diseño de menú de navegación lateral para paneles de administrador o tableros

Sabores (integración de marco):

  • webforj - Aplicación estándar de webforJ
  • webforj-spring - webforJ integrado con Spring Boot para inyección de dependencias y características empresariales
Arquetipos disponibles

webforJ viene con varios arquetipos predefinidos para ayudarte a comenzar rápidamente. Para una lista completa de arquetipos disponibles, consulta el catálogo de arquetipos.

Genera configuraciones de temas de webforJ utilizando DWC HueCraft. La herramienta crea conjuntos de propiedades CSS personalizadas completos con variantes de color primario, secundario, de éxito, de advertencia, de peligro y neutral.

Solicitudes de ejemplo:

"Generar un tema de webforJ con HSL 220, 70, 50 como color primario para nuestra marca corporativa"

"Crear un tema accesible de webforJ llamado 'océano' con color primario #0066CC"

"Generar un tema de webforJ utilizando nuestro color de marca #FF5733"

"Crear un tema de webforJ con HSL 30, 100, 50 llamado 'atardecer' para nuestra aplicación"

"Generar un tema accesible de webforJ con RGB primario 44, 123, 229"

Prompts disponibles​

Los prompts son instrucciones preconfiguradas para la IA que combinan múltiples herramientas y flujos de trabajo para tareas comunes. Guían a la IA a través de pasos y parámetros específicos para ofrecer resultados confiables y repetibles para cada flujo de trabajo admitido.

Argumentos:

  • appName (requerido) - Nombre de la aplicación (por ejemplo, MyApp, TodoList, Dashboard)
  • archetype (requerido) - Elegir entre: blank, hello-world, tabs, sidemenu
  • runServer (opcional) - Ejecutar automáticamente el servidor de desarrollo (sí/no)

Argumentos:

  • primaryColor (requerido) - Color en formato hex (#FF5733), rgb (255,87,51) o hsl (9,100,60)

El prompt configura a la IA para:

  1. Buscar en la base de conocimiento de manera extensa
  2. Escribir código completo y listo para producción
  3. Compilar el proyecto utilizando mvn compile para verificar que no hay errores de construcción
  4. Corregir errores iterativamente hasta que todo funcione

Cómo usar los prompts​

  1. Escribe / en el chat para ver los prompts disponibles
  2. Selecciona un prompt del menú desplegable
  3. Completa los parámetros requeridos cuando se te solicite

Mejores prácticas​

Para obtener la asistencia más precisa y actualizada de webforJ, sigue estas pautas para aprovechar al máximo las funciones del servidor MCP.

Asegurando el uso del servidor MCP​

Los modelos de IA pueden omitir el servidor MCP si creen que ya saben la respuesta. Para asegurarte de que se utilice el servidor MCP:

  • Sé explícito sobre webforJ: Siempre menciona "webforJ" en tu consulta para activar búsquedas específicas del marco
  • Solicita información actual: Incluye frases como "documentación más reciente de webforJ" o "patrones actuales de webforJ"
  • Pide ejemplos verificados: Solicita "ejemplos de código webforJ funcionales" para forzar la búsqueda en la documentación
  • Referencia versiones específicas: Menciona tu versión de webforJ (por ejemplo, "webforJ 25.02") para obtener resultados precisos

Escribir prompts específicos​

Buenos ejemplos:

"Buscar documentación de webforJ para manejo de eventos del componente Botón con ejemplos"

"Crear un proyecto de webforJ llamado InventorySystem utilizando el arquetipo de menú lateral con Spring Boot"

"Generar un tema de webforJ con HSL 220, 70, 50 como color primario para la marca corporativa"

Malos ejemplos:

"¿Cómo funcionan los botones?"

"Haz una aplicación"

"Hazlo azul"

Forzar el uso de herramientas MCP​

Si la IA proporciona respuestas genéricas sin usar el servidor MCP:

  1. Solicita explícitamente: "Usa el servidor MCP de webforJ para buscar [consulta]"
  2. Pide referencias de documentación: "Encuentra en la documentación de webforJ cómo [consulta]"
  3. Solicita verificación: "Verifica esta solución contra la documentación de webforJ"
  4. Sé específico del marco: Siempre incluye "webforJ" en tus consultas

Personalización de IA​

Configura a tus asistentes de IA para que utilicen automáticamente el servidor MCP y sigan las mejores prácticas de webforJ. Agrega instrucciones específicas del proyecto para que tus asistentes de IA siempre utilicen el servidor MCP, sigan los estándares de documentación de webforJ y proporcionen respuestas precisas y actualizadas que se ajusten a los requisitos de tu equipo.

Archivos de configuración del proyecto​

  • Para VS Code y Copilot, crea .github/copilot-instructions.md
  • Para Claude Code, crea CLAUDE.md en la raíz de tu proyecto

Agrega lo siguiente al archivo markdown creado:

## Utiliza el servidor MCP de webforJ para responder a cualquier pregunta sobre webforJ

- Siempre llama a la herramienta "webforj-knowledge-base" para obtener documentación relevante para la pregunta
- Verifica todas las firmas de API contra la documentación oficial
- Nunca supongas que los nombres de los métodos o parámetros existen sin comprobar

Siempre verifica que el código compile con `mvn compile` antes de sugerir.

Preguntas frecuentes​

La mayoría de los asistentes de IA requieren instrucciones explícitas para usar servidores MCP. Configura tu cliente de IA con las instrucciones de la sección Personalización de IA. Sin estas instrucciones, los asistentes de IA pueden recurrir a sus datos de entrenamiento en lugar de consultar el servidor MCP.

Solución rápida: Incluye "usar MCP de webforJ" en tu prompt o crea el archivo de configuración apropiado (.github/copilot-instructions.md o CLAUDE.md).

Usa el inspector de MCP para depurar conexiones:

npx @modelcontextprotocol/inspector

Espera el mensaje: 🔍 MCP Inspector está funcionando en http://127.0.0.1:6274 (el puerto puede variar)

Luego, en el inspector:

  1. Ingresa la URL del servidor MCP: https://mcp.webforj.com/mcp
  2. Haz clic en "Conectar" para establecer la conexión
  3. Visualiza las herramientas disponibles y prueba consultas
  4. Monitorea los registros de solicitud/respuesta para depuración

El servidor MCP de webforJ proporciona dos puntos finales:

  • Punto final de MCP (/mcp) - Protocolo moderno para Claude, VS Code, Cursor
  • Punto final de SSE (/sse) - Eventos enviados por el servidor para clientes heredados como Windsurf

La mayoría de los usuarios deberían usar el punto final de MCP. Solo usa SSE si tu cliente no soporta el protocolo estándar de MCP.

Sí, pero no se recomienda. Sin archivos de configuración, debes solicitar manualmente a la IA que use el servidor MCP en cada conversación. Los archivos de configuración instruyen automáticamente a la IA para que use el servidor MCP en cada interacción, por lo que no tienes que repetir las instrucciones cada vez.

Enfoque manual: Comienza los prompts con: "Usar el servidor MCP de webforJ para..."

Alternativa: usar prompts preconfigurados El servidor MCP proporciona prompts que funcionan sin archivos de configuración:

  • /create-app - Generar nuevas aplicaciones webforJ
  • /create-theme - Crear temas CSS accesibles
  • /search-webforj - Búsqueda avanzada de documentación

Consulta Prompts disponibles para más detalles.

Informar problemas: Comentarios sobre MCP de webforJ

Problemas comunes a informar:

  • Documentación obsoleta en los resultados de búsqueda
  • Métodos o componentes de API faltantes
  • Ejemplos de código incorrectos
  • Errores de ejecución de herramientas

Incluye tu consulta, resultado esperado y resultado real al informar problemas.