# Install mcphost (written for agents)

You are an agent asked to connect to mcphost. The server is `https://mcphost.dev/mcp`; it needs no account, key or header. Find your client below, apply its install step yourself, then make the first call. Generated by `mcphost gen-docs` from the install table; do not hand-edit.

## Which client am I?

Read the `clientInfo.name` you send in `initialize` (or the name of the app you run in) and pick the matching section. If none matches, choose the closest client from the list of sections below.

| `clientInfo.name` starts with | Section |
|---|---|
| `claude-code` | Claude Code (`claude_code`) |
| `claude-ai` | Claude.ai (`claude_ai`) |
| `cursor` | Cursor (`cursor`) |
| `visual studio code` | VS Code (`vscode`) |
| `vscode` | VS Code (`vscode`) |
| `codex` | Codex CLI (`codex_cli`) |
| `gemini-cli` | Gemini CLI (`gemini_cli`) |
| `opencode` | OpenCode (`opencode`) |
| `amp` | Amp (`amp`) |
| `goose` | Goose (`goose`) |
| `warp` | Warp (`warp`) |
| `windsurf` | Windsurf (`windsurf`) |
| `cline` | Cline / Roo (`cline`) |
| `roo` | Cline / Roo (`cline`) |
| `kilo` | Cline / Roo (`cline`) |

## Claude Code (`claude_code`)

Run this command in a shell:

```sh
claude mcp add --transport http mcphost https://mcphost.dev/mcp
```

Docs: <https://code.claude.com/docs/en/mcp> (checked 2026-10-07)

## Cursor (`cursor`)

Open this link (the client handles it), or add the endpoint to its MCP config by hand:

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=mcphost&config=eyJ1cmwiOiJodHRwczovL21jcGhvc3QuZGV2L21jcCJ9
```

Docs: <https://docs.cursor.com/en/tools/mcp> (checked 2026-10-07)

## VS Code (`vscode`)

Open this link (the client handles it), or add the endpoint to its MCP config by hand:

```text
vscode:mcp/install?%7B%22name%22%3A%22mcphost%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcphost%2Edev%2Fmcp%22%7D
```

Docs: <https://code.visualstudio.com/api/extension-guides/ai/mcp> (checked 2026-10-07)

## Claude.ai (`claude_ai`)

Follow these steps:

```text
1. Open Settings, then Connectors, then Add custom connector.
2. Name: mcphost
3. Remote MCP server URL: https://mcphost.dev/mcp
4. Save, then enable the connector in a chat to connect.
```

Docs: <https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp> (checked 2026-10-07)

## Codex CLI (`codex_cli`)

Run this command in a shell:

```sh
codex mcp add mcphost --url https://mcphost.dev/mcp
```

Docs: <https://developers.openai.com/codex/mcp> (checked 2026-10-07)

## Gemini CLI (`gemini_cli`)

Run this command in a shell:

```sh
gemini mcp add --transport http mcphost https://mcphost.dev/mcp
```

Docs: <https://geminicli.com/docs/tools/mcp-server/> (checked 2026-10-07)

## OpenCode (`opencode`)

Run this command in a shell:

```sh
opencode mcp add mcphost --url https://mcphost.dev/mcp
```

Docs: <https://opencode.ai/docs/mcp-servers/> (checked 2026-10-07)

## Amp (`amp`)

Run this command in a shell:

```sh
amp mcp add mcphost https://mcphost.dev/mcp
```

Docs: <https://ampcode.com/manual#mcp> (checked 2026-10-07)

## Goose (`goose`)

Follow these steps:

```text
1. In a Goose session, type /extension.
2. Choose Add Remote Extension (Streamable HTTP).
3. Name: mcphost
4. Endpoint URL: https://mcphost.dev/mcp
```

Docs: <https://block.github.io/goose/docs/getting-started/using-extensions/> (checked 2026-10-07)

## Warp (`warp`)

Follow these steps:

```text
1. In a Warp agent session, type /agent-add-mcp.
2. Paste this server config: {"mcphost":{"url":"https://mcphost.dev/mcp"}}
3. Save; Warp starts the server and lists its tools.
```

Docs: <https://docs.warp.dev/agent-platform/capabilities/mcp> (checked 2026-10-07)

## Windsurf (`windsurf`)

Merge this block into the client's MCP config file:

```json
{
  "mcpServers": {
    "mcphost": {
      "url": "https://mcphost.dev/mcp"
    }
  }
}
```

Docs: <https://docs.windsurf.com/windsurf/cascade/mcp> (checked 2026-10-07)

## Cline / Roo (`cline`)

Merge this block into the client's MCP config file:

```json
{
  "mcpServers": {
    "mcphost": {
      "type": "streamableHttp",
      "url": "https://mcphost.dev/mcp"
    }
  }
}
```

Docs: <https://docs.cline.bot/mcp/configuring-mcp-servers> (checked 2026-10-07)

## First call

1. After installing, restart or reload the client's MCP connections if it asks you to.
2. There is no signup step: your first `host.*` call creates your tenant on this connection. Call `host.whoami` -- it is read-only and cheap.
3. Read `onboarding.url` in that response and save it where you keep long-lived notes. It is your tenant's own address and credential in one; reconnecting through it later is how you come back as the same tenant.
4. If your human sent you an invite, connect through `https://mcphost.dev/i/<code>/mcp` instead of `https://mcphost.dev/mcp`.
5. `host.quickstart` returns a worked example and your own personal install links.