# Connect using MCP

URL: /docs/ai/connect-coding-agents

Coding agents and AI code editors connect to Orvelt with one command or one settings entry. Every client below connects to the same server and opens your browser so you can sign in and approve access. There's no API key to create or paste.

**Server URL:** `https://mcp.orvelt.com/mcp`

Using Claude on the web or desktop? [Connect Claude](/docs/ai) instead, no terminal needed.

## Add the server [#add-the-server]

**Claude Code**

1. Open your terminal and add the server:

```bash title="Terminal"
claude mcp add --transport http orvelt https://mcp.orvelt.com/mcp
```

2. Start Claude Code. It opens your browser to sign in to Orvelt and approve the connection.
3. If the browser does not open, run `/mcp`, select **orvelt**, and choose **Authenticate**.

Add `--scope user` to use the server in every project, or `--scope project` to share it with your team through `.mcp.json`.

**Codex**

1. Add the server:

```bash title="Terminal"
codex mcp add orvelt --url https://mcp.orvelt.com/mcp
```

2. Sign in. Codex opens your browser to approve the connection:

```bash title="Terminal"
codex mcp login orvelt
```

**Cursor**

1. Open **Cursor Settings → MCP & Integrations → New MCP server**, or edit `~/.cursor/mcp.json`:

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "orvelt": {
      "url": "https://mcp.orvelt.com/mcp"
    }
  }
}
```

2. Next to **orvelt**, choose **Connect**. Cursor opens your browser to approve the connection.

You can also open this link to install it in one step: `cursor://anysphere.cursor-deeplink/mcp/install?name=orvelt&config=eyJ1cmwiOiJodHRwczovL21jcC5vcnZlbHQuY29tL21jcCJ9`

**VS Code**

1. Add the server from the terminal:

```bash title="Terminal"
code --add-mcp '{"name":"orvelt","type":"http","url":"https://mcp.orvelt.com/mcp"}'
```

Or add it to a workspace in `.vscode/mcp.json`:

```json title=".vscode/mcp.json"
{
  "servers": {
    "orvelt": {
      "type": "http",
      "url": "https://mcp.orvelt.com/mcp"
    }
  }
}
```

2. Start the server from the **MCP Servers** view. VS Code asks to open your browser to approve the connection.

**OpenCode**

1. Add the server to `opencode.json` in your project, or `~/.config/opencode/opencode.json` for every project:

```json title="opencode.json"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orvelt": {
      "type": "remote",
      "url": "https://mcp.orvelt.com/mcp"
    }
  }
}
```

2. Sign in. OpenCode opens your browser to approve the connection:

```bash title="Terminal"
opencode mcp auth orvelt
```

**Windsurf**

1. Open **Windsurf Settings → Cascade → MCP Servers → View raw config**, or edit `~/.codeium/windsurf/mcp_config.json`:

```json title="~/.codeium/windsurf/mcp_config.json"
{
  "mcpServers": {
    "orvelt": {
      "serverUrl": "https://mcp.orvelt.com/mcp"
    }
  }
}
```

2. Refresh the MCP server list. Windsurf opens your browser to approve the connection.

After you add the server, your browser opens Orvelt. Sign in, choose the organization, and approve access. [What the approval page asks](/docs/ai#approve-access)

## Clients that only run local servers [#clients-that-only-run-local-servers]

For a client that only runs local stdio servers, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote). It runs the same OAuth flow in your browser and stores the tokens on your machine. It needs Node.js 18 or later.

```json title="MCP client configuration"
{
  "mcpServers": {
    "orvelt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.orvelt.com/mcp"]
    }
  }
}
```

## Check it works [#check-it-works]

Ask your agent:

> Use the Orvelt tools to list my projects.

It should call `projects_list` and show your projects. If it can't find any Orvelt tools, see [Troubleshooting](/docs/ai/tools#troubleshooting).