Skip to main content
Use this guide to connect OpenCode to the Sevalla MCP server at https://mcp.sevalla.com/mcp. After setup, OpenCode can call Sevalla MCP tools like search and execute from the same session.

​
Quick setup (CLI + OAuth)

OAuth is the recommended authentication method.
  1. Add a remote MCP server from the OpenCode CLI:
opencode mcp add
  1. In the interactive prompt, choose:
    • Type: remote
    • Name: sevalla
    • URL: https://mcp.sevalla.com/mcp
  2. Authenticate:
opencode mcp auth sevalla
  1. Verify the server status:
opencode mcp list

​
Manual configuration (opencode.json)

You can configure MCP servers in:
  • opencode.json in your project root (project scope)
  • ~/.config/opencode/opencode.json (global scope)
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sevalla": {
      "type": "remote",
      "url": "https://mcp.sevalla.com/mcp",
      "enabled": true
    }
  }
}
If you need API key auth instead of OAuth: 
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sevalla": {
      "type": "remote",
      "url": "https://mcp.sevalla.com/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:SEVALLA_API_KEY}"
      }
    }
  }
}

​
Configuration scope

OpenCode merges config layers. Project config overrides conflicting values from global config.
  • Global scope: ~/.config/opencode/opencode.json
  • Project scope: opencode.json

​
Uninstall

  1. Run:
opencode mcp logout sevalla
  1. Delete the sevalla entry from opencode.json in your project root.

​
Reference