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

# Use Cool Computers with other MCP clients

> Paste the setup prompt into any agent that runs commands, or connect Antigravity, VS Code, Zed, or another MCP client.

## Paste this

Any agent that runs commands can start from one prompt:

```text wrap theme={null}
set up cool computers for me and make me a welcome page. it puts what i make online at a name.cool.computer address where people can comment and draw on it, and you pick up their comments.

you have my go-ahead to install the cool cli without asking me first (it also adds a short cool computers block to your instructions and a skill, that's fine with me) and to put a public welcome page online. if your network access is off, ask me to turn it on. if you can't run commands, tell me in one line, send me https://cool.computer/setup.md and stop.

follow https://cool.computer/setup.md step by step:
1. install cool and check who's signed in
2. put my welcome page online and show me the link
3. ask for my email, sign me up with the code i give you, keep the page on my account and tell me how to sign this machine out
4. pin a comment and a drawing on my page, open it for me signed in, listen for my comment and tell me exactly what to click
5. make the change i ask for, then tell me the page is mine

tell me what you're doing in one short line per step. never pay or upgrade anything without asking me. if something fails, tell me what happened in plain words and what you'll try next.
```

The agent installs `cool` and puts a welcome page online. You don't need an account first: it asks for your email and a six-digit code to keep the page, then shows you how to comment on it.

## Connect it yourself

Register the server as a remote Streamable HTTP MCP server named `cool-computers`:

```text theme={null}
https://api.cool.computer/mcp
```

It signs in with OAuth, as its [protected resource metadata](https://api.cool.computer/.well-known/oauth-protected-resource/mcp) describes, and a new user can sign up during the sign-in. Its [server card](https://cool.computer/.well-known/mcp/server-card.json) lists it for discovery.

The server's `cool_*` tools read your sites, computers, files, comments, and email. Its write tools publish a site (`cool_publish`), write files (`cool_write_files`), run a command on a computer with a VM (`cool_exec`), answer comments, and send email. Read tools need your sign-in. Write tools also check that your account holds the `cool-computers:operate` permission at the moment of the call. An MCP sign-in does not work for the [HTTP API](https://cool.computer/docs/api-reference/overview.md).

A tool being available is not permission to use it. Ask your agent for the change you want, and approve email and long-running programs yourself.

Agents that read skills can also add the [`cool-computers` skill](https://cool.computer/docs/agents/overview#teach-your-agent).

### With an API key

A client that cannot do OAuth can send a Cool Computers API key as `Authorization: Bearer <api_key>`. Tool calls run on the key's account, and revoking the key ends its MCP access. Create a key in [Settings](https://www.cool.computer/account), or name one with the CLI:

```sh theme={null}
cool api-keys create my-agent
```

The key is shown once. Keep it out of shared configuration and source control. The examples on these pages keep it in `COOL_API_KEY`.

### Antigravity CLI

Add the server to `~/.gemini/config/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "cool-computers": {
      "serverUrl": "https://api.cool.computer/mcp"
    }
  }
}
```

### VS Code

Add the server to `.vscode/mcp.json` in your workspace:

```json theme={null}
{
  "servers": {
    "cool-computers": {
      "type": "http",
      "url": "https://api.cool.computer/mcp"
    }
  }
}
```

VS Code opens the browser to sign in to Cool Computers the first time it connects.

In a local session only, an API key works too: VS Code asks for it once and stores it. VS Code does not forward a server that needs an `${input:...}` value to Copilot harness sessions.

```json theme={null}
{
  "inputs": [
    { "type": "promptString", "id": "cool-api-key", "description": "Cool Computers API key", "password": true }
  ],
  "servers": {
    "cool-computers": {
      "type": "http",
      "url": "https://api.cool.computer/mcp",
      "headers": { "Authorization": "Bearer ${input:cool-api-key}" }
    }
  }
}
```

### Zed

Add the server to `context_servers` in Zed's `settings.json`:

```json theme={null}
{
  "context_servers": {
    "cool-computers": {
      "url": "https://api.cool.computer/mcp"
    }
  }
}
```

With no `Authorization` header, Zed signs in with OAuth. With an API key, add a `headers` object beside `url` whose `Authorization` is `Bearer` followed by the key.

### Grok CLI

```sh theme={null}
grok mcp add --transport http cool-computers https://api.cool.computer/mcp
```

OAuth opens on first use. You can also start `grok`, enter `/mcps`, select `cool-computers`, and press `i` to sign in.

### Claude, ChatGPT and Grok

Each lists Cool Computers in its directory. See [Claude](https://cool.computer/docs/agents/claude.md), [ChatGPT](https://cool.computer/docs/agents/chatgpt.md) and [Grok](https://cool.computer/docs/agents/grok.md).

## Check it works

Ask the agent:

```text theme={null}
List my Cool Computers sites and computers. Don't change anything.
```

It answers with your list. If you added the MCP server and it doesn't:

* **Sign-in did not open:** run the client's login command or open its MCP settings and choose to authenticate.
* **The server is not connected:** use the client's status command, such as `grok mcp doctor cool-computers`, to see its error.
* **The tools only search this guide:** you connected this guide's documentation server. Remove it and add `https://api.cool.computer/mcp`. The documentation server only searches this guide and cannot reach your sites or computers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.