Saltar al contenido principal

MCP Server

Abrir en ChatGPT

El servidor del Protocolo de Contexto de Modelo webforJ (MCP) 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 de Modelo es un estándar abierto que permite a los asistentes de IA conectarse con herramientas externas y documentación. El servidor MCP de webforJ implementa este protocolo para proporcionar:

  • Búsqueda de Conocimiento - 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 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?​

Si bien los asistentes de codificación de IA son excelentes para 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
  • Hacer referencia 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 real de webforJ, ejemplos de código y patrones del 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 pueden seguir cometiendo errores en escenarios complejos. Siempre verifica el código generado y prueba a fondo antes de usarlo en producción.

Instalación​

El servidor MCP de webforJ se aloja en https://mcp.webforj.com con dos puntos finales:

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

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 realizas una 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 contextual.

Esta herramienta proporciona capacidades de búsqueda semántica en 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 Button 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 responsive de FlexLayout"

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

Esquematiza aplicaciones completas de webforJ utilizando arquetipos de Maven oficiales. La herramienta crea una disposición estándar de directorios de proyectos 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:

"Crea un proyecto webforJ llamado CustomerPortal usando el arquetipo hello-world"

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

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

"Genera un proyecto webforJ en blanco llamado TestApp con groupId com.example"

"Crea un proyecto webforJ llamado InventorySystem usando 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 las 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 del marco):

  • webforj - Aplicación webforJ estándar
  • 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 completos de propiedades CSS personalizadas con variantes de color primario, secundario, éxito, advertencia, peligro y neutro.

Solicitudes de ejemplo:

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

"Crea un tema accesible de webforJ llamado 'ocean' con color primario #0066CC"

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

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

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

Prompts disponibles​

Los prompts son instrucciones preconfiguradas de 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 entregar 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) - Elige 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 extensivamente
  2. Escribir código completo listo para producción
  3. Compilar el proyecto usando mvn compile para verificar que no haya errores de construcción
  4. Corregir errores de manera iterativa hasta que todo funcione

Cómo usar 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 te lo soliciten

Mejores prácticas​

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

Asegurando el uso del servidor MCP​

Los modelos de IA pueden omitir el servidor MCP si creen que ya conocen 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 en funcionamiento" 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

Redacción de prompts específicos​

Ejemplos buenos:

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

"Crea un proyecto webforJ llamado InventorySystem usando 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"

Ejemplos pobres:

"¿Cómo funcionan los botones?"

"Haz una app"

"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. Preguntar por referencias de documentación: "Encuentra en la documentación de webforJ cómo [consulta]"
  3. Solicitar 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 utilizan 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 usen el servidor MCP, sigan los estándares de documentación de webforJ y proporcionen respuestas precisas y actualizadas que coincidan con 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:

## Usa el servidor MCP de webforJ para responder cualquier pregunta sobre webforJ

- Siempre llama a la herramienta "webforj-knowledge-base" para obtener documentación relevante a la pregunta
- Verifica todas las firmas de la API contra la documentación oficial
- Nunca supongas que los nombres o parámetros de los métodos 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 los 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 su datos de entrenamiento en lugar de consultar el servidor MCP.

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

Usa el inspector MCP para depurar conexiones:

npx @modelcontextprotocol/inspector

Espera el mensaje: 🔍 MCP Inspector está en funcionamiento 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 conexión
  3. Visualiza las herramientas disponibles y prueba consultas
  4. Monitorea los registros de solicitudes/respuestas para depurar

El servidor MCP de webforJ proporciona dos puntos finales:

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

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

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

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

Alternativa: Usa 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 obtener detalles.

Reportar problemas: Plantilla de Problemas MCP de webforJ

Problemas comunes para reportar:

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

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