MCP Server
El servidor del Protocolo de Contexto de Modelo (MCP) de webforJ integra asistentes de codificación de IA en la documentación, las API, los tokens de diseño y las herramientas de scaffolding de webforJ. En lugar de adivinar las convenciones del marco, el asistente consulta al servidor y obtiene respuestas fundamentadas en el verdadero webforJ.
A menos que sepas que solo quieres el servidor MCP, instala el plugin de IA de webforJ en su lugar, ya que agrupa este servidor con las Habilidades de Agente correspondientes en una sola instalación.
¿Qué es un MCP?
El Protocolo de Contexto de Modelo es un estándar abierto que permite a los asistentes de IA llamar a herramientas externas bajo demanda. El servidor MCP de webforJ implementa este protocolo para que tu asistente pueda:
- Consultar la documentación de webforJ en lugar de inventar nombres de métodos.
- Crear nuevos proyectos de webforJ a partir de arquetipos de Maven oficiales.
- Generar temas de DWC accesibles a partir de un color de marca.
- Leer la verdadera superficie de estilo de un componente de DWC y validar cualquier token
--dwc-*antes de que llegue a tu CSS.
El servidor MCP mejora significativamente la precisión, pero los asistentes de IA aún pueden producir código incorrecto en escenarios complejos. Siempre revisa y prueba el código generado antes de implementarlo.
Instalación
Para la experiencia completa, instala el plugin de IA de webforJ, ya que configura este servidor junto con las Habilidades de Agente que tu asistente necesita para usarlo bien.
Si solo deseas el servidor MCP (sin habilidades), apunta tu cliente a https://mcp.webforj.com/mcp:
- Claude Code
- GitHub Copilot CLI
- VS Code + Copilot
- Gemini CLI
- OpenAI Codex CLI
claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user
El camino recomendado en Copilot CLI es el plugin de IA de webforJ, ya que registra el servidor MCP por ti en un solo paso. Para una configuración básica solo de MCP, consulta las instrucciones para cada cliente en el repositorio de IA de webforJ.
Agrega a la configuración de tu VS Code:
"mcp": {
"servers": {
"webforj-mcp": {
"url": "https://mcp.webforj.com/mcp"
}
}
}
Agrega a ~/.gemini/settings.json:
{
"mcpServers": {
"webforj-mcp": {
"httpUrl": "https://mcp.webforj.com/mcp"
}
}
}
Agrega a ~/.codex/config.toml:
[mcp_servers.webforj-mcp]
url = "https://mcp.webforj.com/mcp"
Otros clientes
Cursor, Kiro, Goose, Junie, Antigravity, y cualquier otro cliente MCP sobre HTTP también funcionan; solo utilizan su propio formato de configuración. Consulta la guía de instalación por cliente para el fragmento exacto para cada uno.
Lo que el servidor puede hacer
Cuando el servidor MCP está conectado, tu asistente de IA gana las siguientes capacidades. Cualquiera de ellas puede ser activada por una solicitud en lenguaje natural: el asistente elige la correcta automáticamente.
Antes de responder preguntas sensibles a la versión (cualquier cosa específica de estilo o API), el asistente resuelve qué versión de webforJ estás utilizando. Lee el pom.xml cuando está disponible y, de lo contrario, te pregunta. Cada respuesta subsiguiente está limitada a esa versión.
El asistente puede consultar toda la base de conocimientos de webforJ para respuestas fundamentadas en el verdadero marco. Los resultados se limitan a lo que preguntas: una pregunta de API, una guía, un ejemplo de código o el DSL de Kotlin.
Ejemplos de solicitudes:
"Encuentra ejemplos de manejo de eventos del componente Button de webforJ"
"¿Cómo configuro el enrutamiento con @Route en webforJ?"
"Muéstrame un ejemplo de validación de formulario en webforJ"
El asistente genera el comando correcto de arquetipo de Maven para una nueva aplicación de webforJ a partir de tus requisitos (arquetipo, integración de Spring, nombre, grupo).
Arquetipos:
hello-world- aplicación inicial con componentes de muestrablank- estructura de proyecto mínimatabs- diseño de interfaz de pestañassidemenu- diseño de navegación lateral
Sabores:
webforj- aplicación estándar de webforJwebforj-spring- webforJ integrado con Spring Boot
Ejemplos de solicitudes:
"Crea un proyecto de webforJ llamado CustomerPortal utilizando el arquetipo de navegación lateral"
"Genera un proyecto de webforJ Spring Boot con el diseño de pestañas llamado Dashboard"
Para la lista completa de arquetipos, consulta el catálogo de arquetipos.
A partir de un solo color de marca, el asistente produce un tema completo de DWC: paletas primarias, de éxito, de advertencia, de peligro, de información, por defecto y gris con contraste de texto automático. La salida incluye la hoja de estilo y el cableado de @AppTheme / @StyleSheet.
Ejemplos de solicitudes:
"Genera un tema de webforJ a partir del color de marca #6366f1"
"Crea un tema accesible con HSL 220, 70, 50 como primario"
El asistente lee la verdadera superficie de estilo de cada componente de DWC: propiedades CSS personalizadas, partes de sombra, atributos reflejados y ranuras, antes de escribir cualquier CSS. También puede enumerar cada etiqueta de DWC y resolver los nombres de clases de Java de webforJ (Button, TextField) a sus equivalentes de DWC.
Ejemplos de solicitudes:
"¿Qué variables CSS y partes expone dwc-button?"
"Muéstrame cada ranura disponible en dwc-dialog"
"¿Qué etiqueta de DWC mapea la clase TextField de webforJ?"
Combina esto con la habilidad de agente de styling-apps para flujos de trabajo de estilo de extremo a extremo.
El asistente puede listar el catálogo autorizado de tokens --dwc-* para tu versión de webforJ: semillas de paleta, tonos, superficies, espaciado, tipografía, bordes, filtrados por prefijo o substring. También validará cualquier CSS, Java o fuente de Markdown que le proporciones contra el verdadero catálogo de tokens y señalará nombres desconocidos con correcciones sugeridas.
Ejemplos de solicitudes:
"Lista cada token --dwc-space-*"
"Valida app.css para tokens --dwc-* desconocidos"
"¿Qué tonos de paleta primaria están disponibles?"
La validación detecta errores tipográficos e inventos de tokens antes de que se envíen como CSS que falla silenciosamente.
Escribiendo buenas solicitudes
El servidor MCP solo se consulta cuando tu asistente cree que es relevante. Algunos hábitos mantienen su compromiso:
- Nombra el marco. Menciona "webforJ" en la solicitud para que el asistente recurra al servidor MCP en lugar de a su conocimiento general de Java.
- Sé específico.
"Crea un proyecto de webforJ llamado InventorySystem con el arquetipo de navegación lateral y Spring Boot"supera a"haz una aplicación". - Pide verificación. Frases como
"verifica contra la documentación de webforJ"o"verifica este CSS por malos tokens --dwc-*"empujan al asistente a usar las herramientas en lugar de adivinar.
Si tu asistente aún responde sin consultar al servidor, instala el plugin de IA de webforJ - incluye Habilidades de Agente correspondientes que obligan al asistente a usar las herramientas MCP automáticamente para tareas de webforJ.
FAQ
¿Por qué el asistente de IA no está utilizando el servidor MCP?
La mayoría de los asistentes solo recurren a MCP cuando creen que la pregunta lo necesita. Dos soluciones:
- Instala el plugin de IA de webforJ, que combina el servidor con Habilidades de Agente que indican al asistente usar MCP para tareas de webforJ.
- Sé explícito en tu solicitud: incluye "webforJ" en la pregunta, y para casos obstinados di "usa el servidor MCP de webforJ para responder".
¿Cómo verificar que la conexión MCP está funcionando?
Usa el inspector MCP:
npx @modelcontextprotocol/inspector
Luego, en el inspector, conéctate a https://mcp.webforj.com/mcp y explora las herramientas disponibles.
¿Cómo reportar problemas?
Abre un ticket usando la plantilla de problema de MCP de webforJ. Incluye la solicitud, el resultado esperado y lo que obtuviste.