Setup

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.

Claude
Claude Code
Cursor
ChatGPT

Go to claude.ai/settings/connectors and click “Add custom connector”
Set the name to “Verial”
Set “Remote MCP server URL” to https://api.verial.ai/mcp
Click “Add” and sign in to Verial when prompted

No API key needed. Claude uses OAuth to connect to your Verial account directly.

Add to your project’s .mcp.json:

{
  "mcpServers": {
    "verial": {
      "type": "url",
      "url": "https://api.verial.ai/mcp",
      "headers": {
        "Authorization": "Bearer vk_your_api_key"
      }
    }
  }
}

Add to your MCP settings in Settings > MCP:

{
  "mcpServers": {
    "verial": {
      "url": "https://api.verial.ai/mcp",
      "headers": {
        "Authorization": "Bearer vk_your_api_key"
      }
    }
  }
}

Go to ChatGPT Settings > Apps > Advanced Settings and enable Developer Mode
Click “Create app”
Set “Name” to “Verial”
Set “MCP Server URL” to https://api.verial.ai/mcp
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.

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.

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

To create an API key, go to Settings > API Keys in the Verial dashboard.

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.

Overview

Tools

Workflows

Reference

Cloud MCP Endpoint

Configuration

Authentication

Verify the Connection

Next Steps

Tools Reference

Workflow Examples

Overview

Tools

Workflows

Reference

​Cloud MCP Endpoint

​Configuration

​Authentication

​Verify the Connection

​Next Steps

Tools Reference

Workflow Examples

Cloud MCP Endpoint

Configuration

Authentication

Verify the Connection

Next Steps