# Agent Platforms

Agent Platforms are the AI agent runtimes that plug into Cakewalk's MCP Gateway: Cursor, Claude, ChatGPT, Codex, Copilot and more. They all connect the same way: point the client at the gateway, then sign in through Cakewalk on first connect. What differs is the install method, how each client gets pointed at the gateway.

This page covers the connection pattern and the per-method install reference. To set up, add and manage your own agents, see [My Agents](/docs/ai-agent-access/how-to-guides/agents/my-agents.md).

### 📖 Key Concepts

* **Agent Platform**: An AI agent runtime (Cursor, Claude, ChatGPT, Codex, Copilot and others).
* **Install method**: How Cakewalk hands the gateway values to a given agent. Five methods: Deep Link, JSON Config, YAML Config, Custom Form and CLI.
* **Gateway URL**: The single shared endpoint the agent client points at. Filled into the install flow automatically, never copy-pasted by hand.

:bulb: *Why this matters*: Cakewalk supports the agent runtimes employees already use: no swap-out, no migration. One connection pattern covers every agent, and the right install path is shown per agent.

***

### 🔌 The Connection Pattern

Every supported Agent Platform connects the same way. What differs is how the client takes the values Cakewalk gives it.

#### Definition

The MCP Gateway exposes a single MCP server endpoint, shared across every organization. To bring an agent under governance, the client needs the **Gateway URL** in its MCP config. Form-based clients also take a server name, transport type and auth method.

On first connect the employee signs in through Cakewalk. That sign-in binds the agent to the employee's identity and sets the tenant. From then on the agent calls the Gateway, the Gateway proxies to the downstream Agent Connection and every decision is recorded.

#### How it works

1. In **My Agents**, the employee clicks **Connect** on the agent.
2. The employee follows the install steps Cakewalk shows for that agent: one click, a config snippet or a command.
3. The employee signs in through Cakewalk to link the agent to their identity.
4. The agent shows as **Active**. Every tool call now flows through the Gateway.

If the session credential later expires or the agent client is reinstalled, the employee signs in again. The same install method applies.

{% hint style="info" %}
Every organization shares one gateway endpoint, `https://mcp-gateway.getcakewalk.io/mcp`. There is no per-org URL. Tenant identity comes from the employee's Cakewalk sign-in, and the install flow fills the endpoint in automatically, so employees never copy a raw URL by hand.
{% endhint %}

#### Why this matters

* **One pattern, every agent.** Cursor, Claude Desktop, Copilot, ChatGPT and Codex all use the same connection model.
* **No raw secrets.** The employee signs in through Cakewalk; they never paste or handle credentials directly.
* **Governance from the first call.** Default policies apply immediately: no extra setup, no waiting period.

***

### 🚀 Deep Link Install

The fastest path, used by agents like Cursor. One click hands the agent a deep link that carries the Gateway URL.

#### How it works

* Cakewalk generates the one-click link.
* The employee clicks **Open**; the agent opens and configures itself automatically.
* The agent shows as **Active** once it connects.

A **Copy link** fallback covers browsers that block deep-link handlers.

***

### 📄 JSON Config Install

For agent clients that read MCP servers from a config file.

#### How it works

* Cakewalk shows a pre-filled config snippet.
* The employee pastes it into the agent's MCP config file and saves.
* The employee restarts the agent. Cakewalk then appears in its MCP servers list.

***

### 🧾 YAML Config Install

Same as JSON Config, with a YAML snippet instead of JSON.

#### How it works

* Cakewalk shows a pre-filled YAML snippet.
* The employee pastes it into the agent's config file, saves and restarts the agent.

***

### 📝 Custom Form Install

For agent clients with their own guided MCP setup screen.

#### How it works

* Cakewalk shows the values the agent's form needs: **Server name**, **Server URL**, **Transport type** and **Auth method**.
* The employee adds the server in the agent, saves, then signs in through Cakewalk when redirected.

***

### 💻 CLI Install

For agents installed with a shell command.

#### How it works

* Cakewalk pre-fills the command with the Gateway URL.
* The employee copies it and runs it in a terminal.
* The agent connects and shows as **Active**.

Commands are shaped like:

```
claude mcp add cakewalk --url <gateway-url>
```

The exact syntax depends on the agent CLI; Cakewalk fills in the right one.

***

### 📚 Related

* [Agent Connections](/docs/ai-agent-access/connections-and-integrations/agent-connections.md): the downstream MCPs agents access
* [My Agents](/docs/ai-agent-access/how-to-guides/agents/my-agents.md): the employee surface that runs setup
* [The MCP Gateway](/docs/ai-agent-access/concepts/the-mcp-gateway.md): architecture and trust model
* [Connection and Agent Statuses](/docs/ai-agent-access/concepts/connection-and-agent-statuses.md): what each status means
* [Employee Setup](/docs/ai-agent-access/introduction/get-going-with-agent-access/employee-setup.md): first-time setup walk-through


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-platforms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
