Vaadin MCP Server

El servidor Vaadin Model Context Protocol (MCP) proporciona a los asistentes de codificación de IA acceso directo a la documentación completa de Vaadin, permitiendo asistencia inteligente de código para aplicaciones Vaadin Java y React.

Ver en vaadin.comPrueba este MCPPatrocinado

Documentación

🚀 Servidor MCP de Vaadin

El servidor del Model Context Protocol (MCP) de Vaadin proporciona a los asistentes de codificación con IA acceso directo a la documentación completa de Vaadin, permitiendo asistencia inteligente de código para aplicaciones Vaadin Java y React.

⚡ Instrucciones de Configuración

Haz clic en tu herramienta de codificación con IA para expandir las instrucciones de configuración:

Claude Code

HTTP

Soporte HTTP nativo ›

Añade el servidor MCP de Vaadin usando la CLI o la configuración manual.

Opción 1: Comando CLI (Recomendado)

CopiarEjecutar en terminal:

claude mcp add vaadin --transport http https://mcp.vaadin.com/docs

Opción 2: Configuración Manual

CopiarConfiguración:

{ "mcpServers": { "vaadin": { "type": "http", "url": "https://mcp.vaadin.com/docs" } } }

Ubicaciones de archivos:

  • A nivel de proyecto: .mcp.json (en la raíz del proyecto)
  • Global: ~/.claude.json

Nota: Reinicia Claude Code después de realizar cambios en la configuración.

Cursor

HTTP

Añade el servidor MCP de Vaadin a la configuración de tu proyecto o global.

  • A nivel de proyecto: .cursor/mcp.json
  • Global: ~/.cursor/mcp.json

Nota: Reinicia Cursor después de realizar cambios en la configuración.

Windsurf

HTTP

Añade el servidor MCP de Vaadin a través de la Configuración de Windsurf (abajo a la derecha) o Cmd+Shift+P → "Abrir Configuración de Windsurf".

CopiarConfiguración (~/.codeium/windsurf/mcp_config.json):

Nota: Haz clic en el icono de Martillo en la barra de herramientas de Cascade para ver las herramientas MCP conectadas.

Junie (IDEs JetBrains)

vía proxy

Requiere adaptador HTTP ›

Junie solo admite servidores MCP basados en stdio. Usa @pyroprompts/mcp-stdio-to-streamable-http-adapter para puentear stdio al servidor MCP de Vaadin basado en HTTP.

  1. Abre la configuración del IDE: Ctrl+Alt+S (Windows/Linux) o Cmd+, (macOS)
  2. Navega a Herramientas → Junie → Configuración MCP
  3. Haz clic en el botón Añadir y agrega la configuración a continuación

{ "mcpServers": { "vaadin": { "command": "npx", "args": ["@pyroprompts/mcp-stdio-to-streamable-http-adapter"], "env": { "URI": "https://mcp.vaadin.com/docs", "MCP_NAME": "vaadin" } } } }

Nota: El adaptador usa variables de entorno para configurar la conexión. URI apunta al endpoint del servidor MCP de Vaadin, y MCP_NAME es un identificador para el servidor.

  • A nivel de proyecto: .junie/mcp/mcp.json
  • Global: ~/.junie/mcp.json

GitHub Copilot (IDEs JetBrains)

HTTP

Modo agente requerido (Vista previa pública) ›

⚠️ Importante: Los servidores MCP solo funcionan cuando GitHub Copilot se usa en modo Agente. El Chat regular de Copilot no admite MCP.

El modo agente con soporte MCP ahora está en vista previa pública para IDEs JetBrains (a partir de mayo de 2025).

  1. Crea .copilot/mcp-config.json en la raíz de tu proyecto (los IDEs JetBrains usan el mismo formato que VS Code)
  2. Añade la configuración a continuación
  3. Cambia al modo Agente: Haz clic en el icono de GitHub Copilot → Cambiar al modo Agente
  4. Configura los servidores MCP: Haz clic en el icono de Herramientas → Añadir más herramientas → Editar mcp.json
  5. Alternativa: Haz clic en el icono de GitHub Copilot → Editar configuración → Sección de Servidores MCP

CopiarConfiguración (.copilot/mcp-config.json):

{ "servers": { "vaadin": { "url": "https://mcp.vaadin.com/docs" } } }

Problema conocido: Algunos usuarios informan que las herramientas pueden no aparecer si los servidores MCP se configuran después de que el IDE haya iniciado. Para mejores resultados, crea el archivo mcp-config.json antes de iniciar tu IDE.

Nota empresarial: Las organizaciones con Copilot Business o Enterprise deben habilitar la política "Servidores MCP en Copilot" (deshabilitada por defecto).

Aprende más:

  • Guía MCP de GitHub Copilot
  • Anuncio MCP de JetBrains

GitHub Copilot (VS Code)

HTTP

Modo agente requerido (VS Code 1.99+) ›

Requiere VS Code 1.99 o posterior.

  1. Crea .vscode/mcp.json en la raíz de tu proyecto
  2. Añade la configuración a continuación
  3. Haz clic en el botón Iniciar que aparece en la parte superior de la lista de servidores MCP
  4. Cambia al modo Agente: Abre Copilot Chat → Haz clic en el selector de modo → Selecciona "Agente"
  5. Haz clic en el icono de herramientas en el modo Agente para ver los servidores MCP disponibles

CopiarConfiguración (.vscode/mcp.json):

{ "servers": { "vaadin": { "type": "http", "url": "https://mcp.vaadin.com/docs" } } }

Aprende más:

  • Documentación MCP de VS Code
  • Guía MCP de GitHub Copilot

Codex (OpenAI)

HTTP

Añade el servidor MCP de Vaadin a tu configuración de Codex. Funciona tanto con la CLI de Codex como con la extensión del IDE.

  1. Abre o crea ~/.codex/config.toml
  2. Añade la configuración del servidor a continuación
  3. Reinicia Codex para cargar el nuevo servidor MCP

CopiarConfiguración (~/.codex/config.toml):

[mcp_servers.vaadin] url = "https://mcp.vaadin.com/docs"

Requisito de versión: Los servidores MCP basados en HTTP requieren la versión 0.43 o posterior de la CLI de Codex. Si ves errores de "campo de comando faltante", actualiza con: npm install -g @openai/codex@latest

Aprende más:

  • Documentación MCP de Codex
  • Repositorio de GitHub de Codex

CLI de Gemini (Google)

HTTP

Añade el servidor MCP de Vaadin a tu configuración de la CLI de Gemini. Gemini usará automáticamente las herramientas de documentación de Vaadin cuando sea relevante.

  1. Abre o crea ~/.gemini/settings.json
  2. Añade la configuración del servidor a continuación
  3. Reinicia la CLI de Gemini para cargar el nuevo servidor MCP

CopiarConfiguración (~/.gemini/settings.json):

{ "mcpServers": { "vaadin": { "httpUrl": "https://mcp.vaadin.com/docs" } } }

Nota: La CLI de Gemini invocará automáticamente las herramientas de Vaadin cuando hagas preguntas sobre desarrollo de Vaadin (por ejemplo, "¿Qué es una prueba unitaria de UI de TestBench?").

Aprende más:

  • Repositorio de GitHub de la CLI de Gemini
  • Documentación MCP de la CLI de Gemini

Opencode

HTTP

Añade el servidor MCP de Vaadin a tu configuración de Opencode.

  1. Abre o crea opencode.json en la raíz de tu proyecto
  2. Añade la configuración del servidor a continuación
  3. Reinicia Opencode para cargar el nuevo servidor MCP

CopiarConfiguración (opencode.json):

{ "$schema": "https://opencode.ai/config.json", "mcp": { "vaadin": { "type": "remote", "url": "https://mcp.vaadin.com/docs", "enabled": true } } }

Aprende más:

  • Documentación MCP de Opencode

Otros Clientes MCP

HTTP o stdio

Consulta la documentación de tu herramienta ›

El servidor MCP de Vaadin se puede usar con cualquier cliente compatible con MCP. Elige la configuración apropiada según el soporte de transporte de tu herramienta:

Si tu herramienta admite HTTP/SSE de forma nativa:

Simplemente apúntala a nuestro endpoint HTTP:

Endpoint HTTP:

https://mcp.vaadin.com/docs

El formato exacto de configuración depende de tu herramienta específica. Busca configuraciones como "URL del servidor MCP", "transporte HTTP" o "HTTP transmisible" en la documentación de tu herramienta.

Si tu herramienta solo admite stdio:

Usa un adaptador HTTP para puentear stdio a HTTP. Esto funciona con cualquier cliente MCP basado en stdio:

Configuración genérica de stdio:

Adapta la estructura JSON para que coincida con el formato de configuración de tu herramienta. El adaptador usa variables de entorno: URI para el endpoint del servidor y MCP_NAME como identificador.

🔧 Tipos de Transporte

Importante: El servidor MCP de Vaadin usa transporte HTTP (streamable-http). Esto es compatible de forma nativa con Claude Code, Cursor y Windsurf. Para herramientas solo-stdio como Junie, puedes usar @pyroprompts/mcp-stdio-to-streamable-http-adapter como puente entre los dos tipos de transporte.

✨ Lo que Incluye

  • Búsqueda semántica en la documentación de Vaadin
  • Recuperación completa de documentos para contexto completo
  • Información de versiones de componentes y referencias de API
  • Documentación de API específica de componentes (Java, React, Web Components)
  • Información de estilos y temas de componentes
  • Soporte para aplicaciones Java y React
  • Información de la versión actual de Vaadin
  • Manual de desarrollo de Vaadin con mejores prácticas

🔗 Recursos

Comentarios:

https://vaadin.com/forum

Comparte comentarios, reporta problemas y haz preguntas en el foro de Vaadin.

Documentación de Vaadin:

https://vaadin.com/docs

Explora la documentación completa de Vaadin.

Model Context Protocol:

https://modelcontextprotocol.io

Aprende más sobre el estándar del Model Context Protocol.