All clients

The Keupera MCP server works with any client that speaks remote (Streamable HTTP) MCP. Point it at the endpoint below and authenticate with OAuth (browser sign-in) or an API key.

Server URL

https://mcp.keupera.com/mcp

On first connect, your client opens a browser to sign in to Keupera (OAuth), so there’s no key to copy. Prefer a key? Add Authorization: Bearer sk_live_… and generate one under Account → API Keys in the dashboard.

Pick your client

AI Agent CLI
Web Clients
IDE

Claude Code

1. Add the server (drop -s user to scope to the current project):

claude mcp add --transport http keupera https://mcp.keupera.com/mcp -s user

2. Authenticate: start Claude Code, run /mcp, select keupera → Authenticate, and Allow access in the browser.Use an API key instead:

claude mcp add --transport http keupera https://mcp.keupera.com/mcp \
  --header "Authorization: Bearer sk_live_your_key" -s user

Full Claude Code guide →

Codex (OpenAI)

Codex speaks stdio, so bridge to the hosted server with mcp-remote. Add to ~/.codex/config.toml:

[mcp_servers.keupera]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.keupera.com/mcp"]

Start Codex, and mcp-remote opens the browser to authorize Keupera on first use.Use an API key instead:

[mcp_servers.keupera]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.keupera.com/mcp", "--header", "Authorization: Bearer sk_live_your_key"]

Full Codex guide →

Gemini CLI

Add to ~/.gemini/settings.json (native Streamable-HTTP support):

{
  "mcpServers": {
    "keupera": { "httpUrl": "https://mcp.keupera.com/mcp" }
  }
}

Run gemini, then /mcp to confirm and sign in when prompted.Use an API key instead: add "headers": { "Authorization": "Bearer sk_live_your_key" }.Full Gemini CLI guide →

GitHub Copilot CLI

{
  "mcpServers": {
    "keupera": { "type": "http", "url": "https://mcp.keupera.com/mcp" }
  }
}

Run /mcp to connect keupera and authorize in the browser.Full GitHub Copilot CLI guide →

OpenCode

Add a remote server to opencode.json (project or ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "keupera": { "type": "remote", "url": "https://mcp.keupera.com/mcp", "enabled": true }
  }
}

Start OpenCode and sign in when prompted. For an API key, add "headers": { "Authorization": "Bearer sk_live_your_key" }. Full OpenCode guide →

Factory (Droid)

Add an HTTP MCP server to ~/.factory/mcp.json:

{
  "mcpServers": {
    "keupera": { "type": "http", "url": "https://mcp.keupera.com/mcp" }
  }
}

Run droid, open the MCP panel, connect keupera, and sign in.Full Factory (Droid) guide →

Claude.ai & Claude Desktop

Open connector settings

Settings → Connectors → Add custom connector.

Enter the server

Name it Keupera, URL https://mcp.keupera.com/mcp, click Add.

Connect & authorize

Click Connect, sign in to Keupera and Allow. Works the same on web and desktop.

Full Claude.ai & Desktop guide →

ChatGPT

One click: add the Keupera ChatGPT App to render interactive dashboards in chat.Or add a custom connector (ChatGPT Plus / Pro / Business):

Enable developer mode

Settings → Connectors → Advanced → Developer mode.

Add the connector

Connectors → Create, name it Keupera, URL https://mcp.keupera.com/mcp.

Authorize Keupera in the browser, then enable it in your chat’s tools.

Full ChatGPT guide →

Goose

Add an extension

Goose Desktop → Settings → Extensions → Add (or goose configure → Add Extension).

Choose Streamable HTTP

Pick Remote Extension (Streamable HTTP), endpoint https://mcp.keupera.com/mcp.

Authorize

Full Goose guide →

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "keupera": { "url": "https://mcp.keupera.com/mcp" }
  }
}

Then Settings → MCP → Keupera → Login and sign in. For an API key, add "headers": { "Authorization": "Bearer sk_live_your_key" }. Full Cursor guide →

VS Code (GitHub Copilot)

Create .vscode/mcp.json:

{
  "servers": {
    "keupera": { "type": "http", "url": "https://mcp.keupera.com/mcp" }
  }
}

Or from the CLI:

code --add-mcp '{"name":"keupera","type":"http","url":"https://mcp.keupera.com/mcp"}'

Start keupera in the Copilot Chat MCP view and sign in.Full VS Code guide →

Antigravity

Open the Agent panel → MCP servers → Add server, or edit the MCP config:

{
  "mcpServers": {
    "keupera": { "serverUrl": "https://mcp.keupera.com/mcp" }
  }
}

Connect keupera and sign in when prompted.Full Antigravity guide →

Kiro

Edit .kiro/settings/mcp.json (workspace) or ~/.kiro/settings/mcp.json (user):

{
  "mcpServers": {
    "keupera": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.keupera.com/mcp"] }
  }
}

Kiro reloads MCP servers automatically; mcp-remote opens the browser to sign in. Full Kiro guide →

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json (Windsurf proxies HTTP servers via mcp-remote):

{
  "mcpServers": {
    "keupera": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.keupera.com/mcp"] }
  }
}

Click Refresh in the MCP panel and sign in to Keupera on first connect. Full Windsurf guide →

Not listed? Any client that supports remote HTTP MCP works. Add a server with URL https://mcp.keupera.com/mcp. For stdio-only clients, bridge with npx -y mcp-remote https://mcp.keupera.com/mcp.

See the tool reference for everything you can do once connected.

Overview

Connect

Guides

Reference

Pick your client

​Pick your client

Pick your client