Vaadin MCP Server

O servidor Vaadin Model Context Protocol (MCP) fornece assistentes de codificação de IA com acesso direto à documentação abrangente do Vaadin, permitindo assistência inteligente de código para aplicações Vaadin Java e React.

Ver em vaadin.comExperimente este MCPPatrocinado

Documentação

🚀 Vaadin MCP Server

O servidor Vaadin Model Context Protocol (MCP) fornece aos assistentes de codificação com IA acesso direto à documentação abrangente do Vaadin, permitindo assistência inteligente de código para aplicações Vaadin Java e React.

⚡ Instruções de Configuração

Clique na sua ferramenta de codificação com IA para expandir as instruções de configuração:

Claude Code

HTTP

Suporte HTTP nativo ›

Adicione o servidor Vaadin MCP usando a CLI ou configuração manual.

Opção 1: Comando CLI (Recomendado)

Copiar Executar no terminal:

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

Opção 2: Configuração Manual

Copiar Configuração:

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

Locais dos arquivos:

  • Escopo do projeto: .mcp.json (na raiz do projeto)
  • Global: ~/.claude.json

Observação: Reinicie o Claude Code após fazer alterações na configuração.

Cursor

HTTP

Adicione o servidor Vaadin MCP à configuração do seu projeto ou global.

  • Escopo do projeto: .cursor/mcp.json
  • Global: ~/.cursor/mcp.json

Observação: Reinicie o Cursor após fazer alterações na configuração.

Windsurf

HTTP

Adicione o servidor Vaadin MCP por meio das Configurações do Windsurf (canto inferior direito) ou Cmd+Shift+P → "Open Windsurf Settings".

Copiar Configuração (~/.codeium/windsurf/mcp_config.json):

Observação: Clique no ícone de Martelo na barra de ferramentas do Cascade para visualizar as ferramentas MCP conectadas.

Junie (IDEs JetBrains)

via proxy

Requer adaptador HTTP ›

O Junie suporta apenas servidores MCP baseados em stdio. Use @pyroprompts/mcp-stdio-to-streamable-http-adapter para fazer a ponte entre stdio e o servidor Vaadin MCP baseado em HTTP.

  1. Abra as configurações da IDE: Ctrl+Alt+S (Windows/Linux) ou Cmd+, (macOS)
  2. Navegue até Tools → Junie → MCP Settings
  3. Clique no botão Add e adicione a configuração abaixo

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

Observação: O adaptador usa variáveis de ambiente para configurar a conexão. URI aponta para o endpoint do servidor Vaadin MCP, e MCP_NAME é um identificador para o servidor.

  • Escopo do projeto: .junie/mcp/mcp.json
  • Global: ~/.junie/mcp.json

GitHub Copilot (IDEs JetBrains)

HTTP

Modo agente obrigatório (Pré-visualização Pública) ›

⚠️ Importante: Os servidores MCP só funcionam quando o GitHub Copilot é usado no modo Agente. O Copilot Chat regular não suporta MCP.

O modo agente com suporte a MCP agora está em pré-visualização pública para IDEs JetBrains (a partir de maio de 2025).

  1. Crie .copilot/mcp-config.json na raiz do seu projeto (as IDEs JetBrains usam o mesmo formato do VS Code)
  2. Adicione a configuração abaixo
  3. Mude para o modo Agente: Clique no ícone do GitHub Copilot → Change to Agent mode
  4. Configure os servidores MCP: Clique no ícone de Ferramentas → Add More Tools → Edit mcp.json
  5. Alternativa: Clique no ícone do GitHub Copilot → Edit settings → seção MCP Servers

Copiar Configuração (.copilot/mcp-config.json):

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

Problema conhecido: Alguns usuários relatam que as ferramentas podem não aparecer se os servidores MCP forem configurados após a IDE ter sido iniciada. Para melhores resultados, crie o arquivo mcp-config.json antes de iniciar sua IDE.

Observação para empresas: Organizações com Copilot Business ou Enterprise devem habilitar a política "MCP servers in Copilot" (desabilitada por padrão).

Saiba mais:

  • GitHub Copilot MCP Guide
  • JetBrains MCP Announcement

GitHub Copilot (VS Code)

HTTP

Modo agente obrigatório (VS Code 1.99+) ›

Requer VS Code 1.99 ou posterior.

  1. Crie .vscode/mcp.json na raiz do seu projeto
  2. Adicione a configuração abaixo
  3. Clique no botão Start que aparece no topo da lista de servidores MCP
  4. Mude para o modo Agente: Abra o Copilot Chat → Clique no seletor de modo → Selecione "Agent"
  5. Clique no ícone de ferramentas no modo Agente para visualizar os servidores MCP disponíveis

Copiar Configuração (.vscode/mcp.json):

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

Saiba mais:

  • VS Code MCP Documentation
  • GitHub Copilot MCP Guide

Codex (OpenAI)

HTTP

Adicione o servidor Vaadin MCP à sua configuração do Codex. Funciona tanto com a CLI do Codex quanto com a extensão da IDE.

  1. Abra ou crie ~/.codex/config.toml
  2. Adicione a configuração do servidor abaixo
  3. Reinicie o Codex para carregar o novo servidor MCP

Copiar Configuração (~/.codex/config.toml):

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

Requisito de versão: Servidores MCP baseados em HTTP exigem a versão 0.43 ou posterior da CLI do Codex. Se você vir erros de "missing field command", faça upgrade com: npm install -g @openai/codex@latest

Saiba mais:

  • Codex MCP Documentation
  • Codex GitHub Repository

Gemini CLI (Google)

HTTP

Adicione o servidor Vaadin MCP à sua configuração do Gemini CLI. O Gemini usará automaticamente as ferramentas de documentação do Vaadin quando relevante.

  1. Abra ou crie ~/.gemini/settings.json
  2. Adicione a configuração do servidor abaixo
  3. Reinicie o Gemini CLI para carregar o novo servidor MCP

Copiar Configuração (~/.gemini/settings.json):

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

Observação: O Gemini CLI invocará automaticamente as ferramentas do Vaadin quando você fizer perguntas sobre desenvolvimento Vaadin (por exemplo, "O que é um teste de unidade de UI do TestBench?").

Saiba mais:

  • Gemini CLI GitHub Repository
  • Gemini CLI MCP Documentation

Opencode

HTTP

Adicione o servidor Vaadin MCP à sua configuração do Opencode.

  1. Abra ou crie opencode.json na raiz do seu projeto
  2. Adicione a configuração do servidor abaixo
  3. Reinicie o Opencode para carregar o novo servidor MCP

Copiar Configuração (opencode.json):

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

Saiba mais:

  • Opencode MCP Documentation

Outros Clientes MCP

HTTP ou stdio

Consulte a documentação da sua ferramenta ›

O servidor Vaadin MCP pode ser usado com qualquer cliente compatível com MCP. Escolha a configuração apropriada com base no suporte de transporte da sua ferramenta:

Se sua ferramenta suporta HTTP/SSE nativamente:

Basta apontá-la para nosso endpoint HTTP:

Endpoint HTTP:

https://mcp.vaadin.com/docs

O formato exato da configuração depende da sua ferramenta específica. Procure por configurações como "MCP Server URL", "HTTP transport" ou "Streamable HTTP" na documentação da sua ferramenta.

Se sua ferramenta suporta apenas stdio:

Use um adaptador HTTP para fazer a ponte entre stdio e HTTP. Isso funciona com qualquer cliente MCP baseado em stdio:

Configuração genérica de stdio:

Adapte a estrutura JSON para corresponder ao formato de configuração da sua ferramenta. O adaptador usa variáveis de ambiente: URI para o endpoint do servidor e MCP_NAME como identificador.

🔧 Tipos de Transporte

Importante: O servidor Vaadin MCP usa transporte HTTP (streamable-http). Isso é suportado nativamente por Claude Code, Cursor e Windsurf. Para ferramentas somente stdio, como o Junie, você pode usar @pyroprompts/mcp-stdio-to-streamable-http-adapter como ponte entre os dois tipos de transporte.

✨ O Que Está Incluído

  • Busca semântica na documentação do Vaadin
  • Recuperação completa de documentos para contexto integral
  • Informações de versão de componentes e referências de API
  • Documentação de API específica de componentes (Java, React, Web Components)
  • Informações de estilização e temas de componentes
  • Suporte para aplicações Java e React
  • Informações da versão atual do Vaadin
  • Guia de desenvolvimento Vaadin com melhores práticas

🔗 Recursos

Feedback:

https://vaadin.com/forum

Compartilhe feedback, relate problemas e faça perguntas no fórum do Vaadin.

Documentação do Vaadin:

https://vaadin.com/docs

Navegue pela documentação completa do Vaadin.

Model Context Protocol:

https://modelcontextprotocol.io

Saiba mais sobre o padrão Model Context Protocol.