Docs

Documentation versions (currently viewingVaadin 24)
Documentation translations (currently viewingEnglish)

Setup Guide

Learn how to configure Google Gemini CLI to access Vaadin documentation through the Model Context Protocol server

Google Gemini CLI provides native HTTP MCP support, allowing direct integration with the Vaadin MCP server for enhanced AI-assisted development.

Configuration

Add the following to ~/.gemini/settings.json:

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

After configuration, restart Gemini CLI to load the MCP server.

Note

Gemini CLI automatically invokes Vaadin tools when you ask questions about Vaadin development (e.g., "What is a TestBench UI unit test?").

Configuration File Location

The configuration file location varies by operating system:

  • macOS: ~/.gemini/settings.json

  • Linux: ~/.gemini/settings.json

  • Windows: %USERPROFILE%\.gemini\settings.json

If the directory doesn’t exist, create it before adding the configuration file.

Automatic Tool Invocation

Gemini CLI features intelligent tool selection:

  • When you ask Vaadin-related questions, it automatically queries the Vaadin MCP server

  • No manual tool invocation required

  • The assistant determines when documentation lookup would be helpful

  • Responses are grounded in current Vaadin documentation

Verify the Setup

After restarting Gemini CLI:

  1. Start a new conversation

  2. Ask a Vaadin-specific question (e.g., "How to implement data binding in Vaadin?")

  3. Observe the tool invocation in the response

  4. Gemini fetches relevant documentation from the Vaadin MCP server

You can also explicitly request documentation by asking "What does the Vaadin documentation say about…​?"