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

# Setup

> Connect the Verial MCP server to your AI agent.

## Cloud MCP Endpoint

Verial hosts a cloud MCP server. No infrastructure to run, just point your agent at the endpoint.

```
https://api.verial.ai/mcp
```

## Configuration

Add the Verial MCP server to your agent. Some platforms use OAuth (you'll authorize via your Verial account), while others use an API key in a config file.

<Tabs>
  <Tab title="Claude">
    1. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) and click **"Add custom connector"**
    2. Set the name to **"Verial"**
    3. Set **"Remote MCP server URL"** to `https://api.verial.ai/mcp`
    4. Click **"Add"** and sign in to Verial when prompted

    No API key needed. Claude uses OAuth to connect to your Verial account directly.
  </Tab>

  <Tab title="Claude Code">
    Add to your project's `.mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "verial": {
          "type": "url",
          "url": "https://api.verial.ai/mcp",
          "headers": {
            "Authorization": "Bearer vk_your_api_key"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Add to your MCP settings in **Settings > MCP**:

    ```json theme={null}
    {
      "mcpServers": {
        "verial": {
          "url": "https://api.verial.ai/mcp",
          "headers": {
            "Authorization": "Bearer vk_your_api_key"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="ChatGPT">
    1. Go to [ChatGPT Settings](https://chatgpt.com/settings#settings) > **Apps** > **Advanced Settings** and enable **Developer Mode**
    2. Click **"Create app"**
    3. Set **"Name"** to **"Verial"**
    4. Set **"MCP Server URL"** to `https://api.verial.ai/mcp`
    5. Set **"Authentication"** to **"OAuth"**, check the confirmation box, and click **"Create"**

    No API key needed. ChatGPT uses OAuth to connect to your Verial account directly.
  </Tab>
</Tabs>

## Authentication

The MCP server supports two authentication methods:

* **OAuth 2.1** -- used by Claude, ChatGPT, and other platforms with built-in OAuth support. The platform handles authentication automatically. No API key needed.
* **API keys** -- used by config-file-based clients (Claude Code, Cursor, VS Code). Include your key in the `Authorization` header as a Bearer token.

<Warning>
  Never commit API keys to version control. Use environment variables or a secrets manager to inject the key into your configuration file.
</Warning>

To create an API key, go to **Settings > API Keys** in the [Verial dashboard](https://verial.ai).

## Verify the Connection

Once configured, test with a simple prompt:

```
List my environments.
```

Your agent should call the `environments` tool with `action: "list"` and return your environments. If you see an authentication error, verify your API key is correct and has access to your organization.

## Next Steps

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="wrench" href="/mcp/tools/environments">
    Explore the tools your agent now has access to.
  </Card>

  <Card title="Workflow Examples" icon="route" href="/mcp/workflows/environment-setup">
    See how agents chain tools to set up and run simulations.
  </Card>
</CardGroup>