> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validio.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server Setup Instructions

> Step-by-step instructions for connecting Claude, Antigravity CLI, and other MCP clients to the Validio MCP Server using OAuth authentication and Streamable HTTP transport.

Connect to our MCP server natively in Claude, Antigravity CLI, and various other MCP clients. Validio's MCP server supports HTTP-based transport (Streamable HTTP) with OAuth authentication and dynamic client registration.

The Validio MCP server will inherit the permissions and access of the user account you use to connect to it.

> [!NOTE]
>
> The Validio MCP server provides tools for managing resources, such as sources, validators, and incidents. Read more about key benefits in [Validio MCP Server](https://docs.validio.io/v11.1/docs/integrations/validio-mcp-server.md). For detailed examples and use cases, see [MCP Server User Guide](https://docs.validio.io/v11.1/docs/integrations/validio-mcp-server/mcp-server-user-guide.md).

## Prerequisites for setting up the Validio MCP Server

![The Validio Workspace Settings AI Features section, showing the Enable MCP Server option](https://mintcdn.com/validio/h4NQPs1kJwlpB1Yj/images/docs/integrations/900-mcp-server-setup.png?fit=max\&auto=format\&n=h4NQPs1kJwlpB1Yj\&q=85\&s=bb39fe334a06ca8cc5b5c113519bb73f)

AI Features settings with Enable MCP Server checked

In your [Validio Workspace Settings](https://docs.validio.io/v11.1/docs/access-and-settings/settings/workspace-settings.md),

* Configure the **Application URL**. The Application URL is the URL to your Validio installation, for example: `https://your-validio-instance`.
* Under **AI Features**, check **Enable MCP Server**.

***

## Claude

### Claude.ai and Claude Desktop

On web or desktop,

1. Navigate to **Admin Settings > Connectors**.
2. Click **Add custom connector** and in the dialog:
   1. **Name**: Give the connector a name.
   2. **Remote MCP server URL**: Enter your Validio MCP server URL, which will have the format `https://your-validio-instance/mcp`.
   3. Click **Add**.
3. In **Settings > Connectors**,
   1. Connect to the Validio MCP server.
   2. When prompted, log in to Validio with your user account and password.
4. In a new Claude chat, open the **Search and tools** menu and enable the new connector.

### Claude Code

In the CLI,

1. Run `claude mcp add validio -t http https://your-validio-instance/mcp`
2. Open a Claude Code session,
   1. Run `/mcp` to list all MCP servers.
   2. Select the Validio MCP server and go through the authentication flow.

***

## Antigravity CLI

> [!NOTE]
>
> Antigravity CLI replaces Gemini CLI, which Google retired in June 2026. If you previously connected Validio through Gemini CLI, set up the connection again in Antigravity CLI.

In the CLI,

1. Run `agy mcp add validio --type http https://your-validio-instance/mcp`
2. Start Antigravity by running `agy`,
   1. Run `/mcp` to list all MCP servers. The Validio MCP server shows as `Unauthorized [Auth Needed]`.
   2. Select `validio`, press `Enter` to open **Actions**, and choose the authenticate option.
   3. In your browser, log in to Validio with your user account.
3. Run `/mcp` again to confirm that the Validio MCP server is connected and its tools are listed.