Sign in Get started

Getting Started

Install Sequel MCP

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

https://api.sequel.sh/mcp

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.

Install the CLI

One line installs the latest CLI (@sequelsh/cli) with whatever package manager you have:

curl -fsSL https://sequel.sh/install | sh

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

Sign in

sequel login

This opens your browser to authenticate and pick an organization.

Install Sequel into your agent

Run install and pick an agent from the list, or pass its slug directly:

sequel install

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

Verify

Restart the agent and ask it to "list my Sequel connections." If it answers, you're connected.

Already have the CLI? sequel install claude-code (or any slug above) re-runs setup for that agent at any time.

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 for the difference.

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

Claude CodeInstall the Sequel MCP server in Claude Code

Run the command below in your terminal to register Sequel with Claude Code globally — `--scope user` makes it available across every project. Drop that flag to install it for the current project only.

Run in your terminal

claude mcp add --scope user --transport http sequel https://api.sequel.sh/mcp \
  --header "Authorization: Bearer sql_your_api_key"

Replace sql_your_api_key with a real key from your Sequel dashboard.

CursorInstall the Sequel MCP server in Cursor

Click 'Open in Cursor' to install automatically, or add the config below to .cursor/mcp.json manually.

.cursor/mcp.json (fallback — manual install)

{
  "mcpServers": {
    "sequel": {
      "url": "https://api.sequel.sh/mcp",
      "headers": {
        "Authorization": "Bearer sql_your_api_key"
      }
    }
  }
}

Replace sql_your_api_key with a real key from your Sequel dashboard.

VS CodeInstall the Sequel MCP server in VS Code

Click 'Open in VS Code' to install automatically. VS Code will prompt you for your API key. Or add the config below to .vscode/mcp.json manually.

.vscode/mcp.json (fallback — manual install)

{
  "servers": {
    "sequel": {
      "type": "http",
      "url": "https://api.sequel.sh/mcp",
      "headers": {
        "Authorization": "Bearer sql_your_api_key"
      }
    }
  }
}

Replace sql_your_api_key with a real key from your Sequel dashboard.

WindsurfInstall the Sequel MCP server in Windsurf

Add the snippet below to your Windsurf MCP config file, then reload Windsurf. Note Windsurf uses `serverUrl` (not `url`).

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sequel": {
      "serverUrl": "https://api.sequel.sh/mcp",
      "headers": {
        "Authorization": "Bearer sql_your_api_key"
      }
    }
  }
}

Replace sql_your_api_key with a real key from your Sequel dashboard.

ChatGPTInstall the Sequel MCP server in ChatGPT

In ChatGPT, go to Settings → Connectors and add a new MCP connector with the details below. ChatGPT also supports signing in with OAuth instead of a static key.

ChatGPT Settings → Connectors

Server URL:
https://api.sequel.sh/mcp

Authorization header:
Bearer sql_your_api_key

Replace sql_your_api_key with a real key from your Sequel dashboard.

CodexInstall the Sequel MCP server in Codex

Run the command below in your terminal to register Sequel with OpenAI Codex.

Run in your terminal

codex --add-mcp-server \
  --name sequel \
  --transport http \
  --url https://api.sequel.sh/mcp \
  --header "Authorization: Bearer sql_your_api_key"

Replace sql_your_api_key with a real key from your Sequel dashboard.

ZedInstall the Sequel MCP server in Zed

Add the snippet below to your Zed settings file (Cmd+, to open it), then restart Zed.

~/.config/zed/settings.json

{
  "context_servers": {
    "sequel": {
      "url": "https://api.sequel.sh/mcp",
      "settings": {
        "headers": {
          "Authorization": "Bearer sql_your_api_key"
        }
      }
    }
  }
}

Replace sql_your_api_key with a real key from your Sequel dashboard.

GeminiInstall the Sequel MCP server in Gemini

Add the snippet below to your Gemini CLI settings file, then restart the CLI.

~/.gemini/settings.json

{
  "mcpServers": {
    "sequel": {
      "url": "https://api.sequel.sh/mcp",
      "httpOptions": {
        "headers": {
          "Authorization": "Bearer sql_your_api_key"
        }
      }
    }
  }
}

Replace sql_your_api_key with a real key from your Sequel dashboard.

Using a tool that isn't listed?

Any client that supports the Model Context Protocol over streamable HTTP can connect using the URL and Authorization header above.

Getting Started Connecting your first data source