How to Set Up a Gateway
Connect a Gateway you've already created to Cursor, Claude, Claude Code, or any other MCP-compatible client.
Once you've created a Gateway, the next step is connecting it to the tools you actually work in, like Cursor, Claude Desktop, Claude Code, Windsurf, or any other MCP-compatible client.
This page covers connecting a Gateway you've already created. If you haven't set one up yet, start with Gateway/Deployment Creation.
Open Client Setup
Navigate to Secure → Gateway → MCP Gateway, find the Gateway you want to connect, and click Client Setup on its card.
Pick the tab for Cursor, Claude Code, or Claude. Each one walks you through the exact steps for that client. If your client isn't one of those three, everything you need is still just the Gateway's URL. See Connect other clients below.
You don't need to open Client Setup just to grab the connection address. Copy MCP Gateway URL, available from the card's menu, copies it directly. This is handy if you're following a client's own setup docs and only need the address.
Connecting to a Tenant-level Gateway is still something each person does individually. There's no single login or key shared between coworkers. Everyone who wants to use a Tenant Gateway from their own client opens Client Setup and authenticates with their own account.
Connect Cursor
Open Client Setup on your Gateway and select the Cursor tab.
Cursor opens automatically with a prompt to install the connection. Confirm the install.
Cursor opens your browser to complete sign-in the first time it needs to connect.
Connect Claude Desktop
The Claude tab in Client Setup gives you two ways to connect.
Remote config (recommended)
In Claude, open your profile menu, then go to Settings → Feature Preview → Custom Connectors.
Click Add Connector and enter a name along with your Gateway's URL, both shown in the Client Setup dialog.
Claude handles sign-in automatically the first time you use the connector.
Local config with OAuth
Copy the configuration shown in Client Setup and add it to your Claude MCP settings file:
{
"mcpServers": {
"my-gateway": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-gateway.airia.com/gateway/{your-gateway-id}/mcp"]
}
}
}Fully restart Claude Desktop. It won't pick up the new server until you do.
Sign in when prompted. OAuth is handled automatically once Claude connects.
Your Claude MCP settings file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows. Restart Claude Desktop completely after any change. Closing the window alone isn't enough.
Connect Claude Code
Open Client Setup and select the Claude Code tab, then run the command it shows you in your terminal:
claude mcp add --scope user --transport http my-gateway "https://mcp-gateway.airia.com/gateway/{your-gateway-id}/mcp"Exit Claude Code completely and relaunch it. The new server won't show up until you do.
Inside Claude Code, run /mcp, select your Gateway, and complete the sign-in flow in your browser.
See Anthropic's MCP authentication documentation for more on how that flow works from Claude Code's side.
Connect other clients
Cursor, Claude Desktop, and Claude Code get dedicated setup screens because they're the most common clients Airia customers use. A Gateway's endpoint is standards-compliant, so it works with any MCP client that supports remote HTTP servers, including Windsurf, VS Code, and others.
Get it from Client Setup, or use Copy MCP Gateway URL on the Gateway's card menu.
Add the URL as a remote MCP server, following that client's own instructions for doing so.
If your client prompts for authentication, choose OAuth. Your client walks you through a one-time sign-in in your browser and takes care of the rest automatically.
The exact wording and steps for signing in vary a bit from client to client, but every one of them is connecting to the same underlying Gateway the same way.
Gateways with Radar enabled
If a Gateway has Radar turned on, every step above still applies exactly as written. Client Setup automatically points your client at the right endpoint. If you're adding a client manually and building the URL yourself, use /radar instead of /mcp at the end.
About connection names
Airia generates a short name for the Gateway automatically wherever a client needs one to label the connection, based on the Gateway's own name. If that name looks abbreviated or unfamiliar once it shows up in your client, that's expected. You can rename the entry locally in your own configuration. Renaming it on your end never affects the Gateway itself or anyone else connected to it.