> Markdown version of [Setup Guide](https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools). Section index: [llms.txt](https://vaadin.com/docs/next/building-apps/llms.txt)

# MCP Setup Guide

This guide provides configuration instructions for connecting your AI development tool to the Vaadin MCP server. The Vaadin MCP server gives AI assistants direct access to comprehensive Vaadin documentation, enabling accurate and context-aware responses.

## <a id="choose-your-ai-tool"></a>Choose Your AI Tool

Select your AI development tool for specific configuration instructions:

### <a id="claude-code"></a>Claude Code

Anthropic’s official CLI tool with native HTTP MCP support.

[See setup guide for Claude Code](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/claude-code.md# >)

### <a id="cursor"></a>Cursor

AI-powered code editor with native HTTP MCP support.

[See setup guide for Cursor](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/cursor.md# >)

### <a id="windsurf"></a>Windsurf

Codeium’s AI-native IDE with built-in HTTP MCP support.

[See setup guide for Windsurf](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/windsurf.md# >)

### <a id="junie"></a>Junie

JetBrains’s AI assistant (requires stdio-to-HTTP adapter).

[See setup guide for Junie](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/junie.md# >)

### <a id="github-copilot"></a>GitHub Copilot

GitHub’s AI pair programmer in VS Code and JetBrains IDEs Agent mode.

[See setup guide for GitHub Copilot](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/github-copilot.md# >)

### <a id="codex-openai"></a>Codex (OpenAI)

OpenAI’s code generation tool with native HTTP support.

[See setup guide for Codex](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/codex.md# >)

### <a id="gemini-cli-google"></a>Gemini CLI (Google)

Google’s Gemini CLI with native HTTP support.

[See setup guide for Gemini CLI](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/gemini-cli.md# >)

### <a id="other-clients"></a>Other Clients

Configuration for any MCP-compatible client.

[See setup guides for other MCP-compatible clients](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/other-tools.md# >)

## <a id="transport-types"></a>Transport Types

> **Important:** The Vaadin MCP server uses **HTTP transport (streamable-http)**. This is natively supported by Claude Code, Cursor, Windsurf, GitHub Copilot (VS Code and JetBrains IDEs), Codex, and Gemini CLI.
>
> For stdio-only tools like Junie, you can use [@pyroprompts/mcp-stdio-to-streamable-http-adapter](https://github.com/pyroprompts/mcp-stdio-to-streamable-http-adapter) as a bridge between the two transport types.

## <a id="general-setup-steps"></a>General Setup Steps

Most tools follow these general steps:

1. Locate your tool’s MCP configuration file (varies by tool)

2. Add the Vaadin MCP server configuration

3. Restart your tool to load the MCP server

4. Start asking questions about Vaadin development

See the specific instructions for your tool in the tabs above for exact configuration details.

> **Tip:** If you use Claude Code or Codex, you can skip manual configuration. The [Vaadin Skills](https://vaadin.com/docs/next/building-apps/agentic-development/agent-skills.md) plugin, installed from the [Vaadin Agent Marketplace](https://github.com/vaadin/agent-marketplace), sets up the Vaadin MCP server and Vaadin development skills together. See the [Claude Code](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/claude-code.md# >) and [Codex](<https://vaadin.com/docs/next/building-apps/agentic-development/mcp/supported-tools/codex.md# >) setup guides for the install commands.

## <a id="resources"></a>Resources

### <a id="vaadin-agent-marketplace"></a>Vaadin Agent Marketplace

- [Vaadin Agent Marketplace](https://github.com/vaadin/agent-marketplace) — the marketplace for Vaadin’s Claude Code and Codex plugins, including Vaadin Skills, which bundles the MCP server and skills

### <a id="vaadin-mcp-server"></a>Vaadin MCP Server

- [MCP Server Endpoint](https://mcp.vaadin.com/docs)

### <a id="model-context-protocol"></a>Model Context Protocol

- [MCP Documentation](https://modelcontextprotocol.io)

- [MCP Specification](https://modelcontextprotocol.io/specification)