> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect Claude Code to the Sevalla MCP server with OAuth or API key authentication.

Use this guide to connect Claude Code to the Sevalla MCP server at `https://mcp.sevalla.com/mcp`.

After setup, Claude Code can use Sevalla MCP tools like `search` and `execute` directly from chat.

Check out Sevalla's MCP in action with Claude Code:

<iframe width="560" height="315" src="https://www.youtube.com/embed/2dzdu-mrJPI?si=uWwIHYNoQ8UmuAl8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

## Quick setup (CLI + OAuth)

OAuth is the recommended authentication method.

1. Add the Sevalla MCP server:

```bash theme={null}
claude mcp add --transport http sevalla https://mcp.sevalla.com/mcp
```

2. Open Claude Code and run:

```text theme={null}
/mcp
```

3. Select `sevalla` and complete the browser login flow with your Sevalla account.
4. Run `claude mcp list` to confirm the server is configured.

## Manual configuration (`.mcp.json`)

You can define Sevalla manually in `.mcp.json` (project-shared) or in `~/.claude.json` (personal).

```json theme={null}
{
  "mcpServers": {
    "sevalla": {
      "type": "http",
      "url": "https://mcp.sevalla.com/mcp"
    }
  }
}
```

If you need API key auth instead of OAuth, add an authorization header:

```json theme={null}
{
  "mcpServers": {
    "sevalla": {
      "type": "http",
      "url": "https://mcp.sevalla.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEVALLA_API_KEY}"
      }
    }
  }
}
```

<Warning>
  Do not commit real API keys to Git. Use environment variables.
</Warning>

## Configuration scope

* `local` (default): private to the current project context.
* `project`: shared via `.mcp.json` in the repository.
* `user`: available to your user account across projects.

Use `--scope project` for team-shared setups and `--scope user` for personal cross-project setups.

## Uninstall

1. Within Claude Code run:

```text theme={null}
claude mcp remove sevalla
```

2. Clear the stored OAuth token. In Claude Code run `/mcp`, select Sevalla, and choose Clear authentication.

If the server was added at a non-default scope, specify it explicitly:

```text theme={null}
claude mcp remove --scope user sevalla
claude mcp remove --scope project sevalla
```

## Reference

* Sevalla MCP endpoint: `https://mcp.sevalla.com/mcp`
* Sevalla MCP repository: [github.com/sevalla-hosting/mcp](https://github.com/sevalla-hosting/mcp)