# Install Sequel MCP

Step-by-step instructions for installing the Sequel MCP server in Claude Code, Cursor, VS Code, ChatGPT, Codex, Windsurf, Zed, and Gemini.

Sequel exposes a single hosted MCP endpoint. Point any MCP-capable AI tool at it and authenticate with your API key:

<CodeBlock language="bash">https://api.sequel.sh/mcp</CodeBlock>

There are two ways to install it into your agent: the **Sequel CLI** (one command — it creates the API key and writes the config for you) or **manual setup** (copy-paste the config into each tool yourself).

## Fastest: the Sequel CLI

The CLI installs Sequel into a coding agent in a single step. It signs you in, provisions a scoped API key for that agent, and writes the right config to the right place — no keys to copy by hand.

<Steps>
<Step title="Install the CLI">
One line installs the latest CLI (`@sequelsh/cli`) with whatever package manager you have:

<CodeBlock language="bash">curl -fsSL https://sequel.sh/install | sh</CodeBlock>

Prefer npm directly? `npm install -g @sequelsh/cli@latest` works too (or `pnpm add -g`, `bun add -g`, `yarn global add`).
</Step>

<Step title="Sign in">
<CodeBlock language="bash">sequel login</CodeBlock>

This opens your browser to authenticate and pick an organization.
</Step>

<Step title="Install Sequel into your agent">
Run `install` and pick an agent from the list, or pass its slug directly:

<CodeBlock language="bash">sequel install</CodeBlock>

The CLI creates an API key named after the agent, then writes its MCP config. For agents that support it, you'll also be asked for a **scope** — `global` (available everywhere on this machine) or `local` (this project only).

| Agent | Slug | Scopes |
| --- | --- | --- |
| Claude Code | `claude-code` | global, local |
| Claude Desktop | `claude` | global |
| Cursor | `cursor` | global, local |
| VS Code | `vscode` | global, local |
| Windsurf | `windsurf` | global |
| Zed | `zed` | global, local |
| Codex | `codex` | global |
</Step>

<Step title="Verify">
Restart the agent and ask it to **"list my Sequel connections."** If it answers, you're connected.
</Step>
</Steps>

<Callout type="tip">
Already have the CLI? `sequel install claude-code` (or any slug above) re-runs setup for that agent at any time.
</Callout>

## Manual setup

Prefer to wire it up yourself — or using ChatGPT, Claude.ai, or Gemini? Generate a key under **Settings → API Keys** in your Sequel dashboard and drop it into the `Authorization` header shown in each snippet below. Some tools — like ChatGPT and Claude.ai — can also sign in with **OAuth** instead of a static key; see [API keys & authentication](/docs/api-keys-and-auth) for the difference.

Expand a tool for its exact setup. Replace `sql_your_api_key` with a real key from your dashboard.

<McpInstallList />

<Callout type="info" title="Using a tool that isn't listed?">
Any client that supports the [Model Context Protocol](https://modelcontextprotocol.io) over streamable HTTP can connect using the URL and `Authorization` header above.
</Callout>