Skip to main content
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.

​
Quick setup (CLI + OAuth)

OAuth is the recommended authentication method.
  1. Add the Sevalla MCP server:
claude mcp add --transport http sevalla https://mcp.sevalla.com/mcp
  1. Open Claude Code and run:
/mcp
  1. Select sevalla and complete the browser login flow with your Sevalla account.
  2. 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). 
{
  "mcpServers": {
    "sevalla": {
      "type": "http",
      "url": "https://mcp.sevalla.com/mcp"
    }
  }
}
If you need API key auth instead of OAuth, add an authorization header: 
{
  "mcpServers": {
    "sevalla": {
      "type": "http",
      "url": "https://mcp.sevalla.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEVALLA_API_KEY}"
      }
    }
  }
}
Do not commit real API keys to Git. Use environment variables.

​
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:
claude mcp remove sevalla
  1. 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: 
claude mcp remove --scope user sevalla
claude mcp remove --scope project sevalla

​
Reference