Skip to content

Okahu MCP Server

Okahu provides an MCP Server so your coding agents can search, analyze and evaluate traces managed by Okahu Cloud from your IDE (1) or CI/CD platform (2).

  1. Visual Studio Code, Cursor, Antigravity, Kiro & more
  2. Github, Jenkins, Gitlab & more
Requires Okahu Cloud account

Okahu MCP Server authenticates using an API KEY to access your Okahu Cloud account. If you prefer OAuth authentication and your client opens a browser (or a Connect flow) to sign in, remove the headers block that carries the API key, for example:

"headers": {
  "x-api-key": "${OKAHU_API_KEY}"
}

Also remove any equivalent header wiring (Codex env_http_headers, Claude Desktop mcp-remote --header lines, and so on). Keep the URL-only shape your tool expects.

Configure Okahu MCP Server in your IDE or Coding Agent

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to .vscode/mcp.json file in your project root
    `mcp.json`
    {
  "servers": {
    "okahu": {
      "type": "http",
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
  3. Start the MCP Server
  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to your .cursor/mcp.json
    `mcp.json`
    {
  "mcpServers": {
    "okahu": {
      "type": "http",
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
         "x-api-key": "${OKAHU_API_KEY}" 
      }
    }
  }
}
  3. Start the MCP Server
Alternatively, install Okahu MCP Server for Cursor using a deeplink instead

Click here to install with deeplink.

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to .kiro/settings/mcp.json file in your project root
    `mcp.json`
    {
  "mcpServers": {
    "okahu": {
      "type": "http",
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "<OKAHU_API_KEY>"
      }
    }
  },
  "inputs": []
}
  3. Start the MCP Server
  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to project or user .mcp.json:

`.mcp.json`
{
  "mcpServers": {
    "okahu": {
      "type": "http",
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
3. Start the MCP Server

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key (or set it in the env block below).
  2. Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

`claude_desktop_config.json`
{
  "mcpServers": {
    "okahu": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.okahu.co/mcp",
        "--header",
        "x-api-key:${OKAHU_API_KEY}"
      ]
    }
  }
}
3. Restart Claude Desktop. See the mcp-remote readme if you need different quoting (for example on Windows).

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following to ~/.codex/config.toml or a trusted project .codex/config.toml:

`config.toml`
[mcp_servers.okahu]
url = "https://mcp.okahu.co/mcp"

[mcp_servers.okahu.env_http_headers]
"x-api-key" = "OKAHU_API_KEY"
3. If remote MCP is not enabled yet, add [beta] rmcp = true per Codex MCP, then restart Codex.

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following to ~/.gemini/settings.json (see MCP in Gemini CLI):

`settings.json`
{
  "mcpServers": {
    "okahu": {
      "httpUrl": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
3. Restart Gemini CLI.

For Global MCP configuration

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to .gemini/antigravity/mcp_config.json file
    `mcp_config.json`
    {
  "mcpServers": {
    "okahu": {
      "serverUrl": "https://mcp.okahu.co/mcp",
        "headers": {
          "x-api-key": "<OKAHU_API_KEY>",
          "Content-Type": "application/json"
      }
    }
  }
}
  3. Start the MCP Server

For workspace scoped MCP configuration

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following block to .vscode/mcp.json file in your project root
    `mcp.json`
    {
  "servers": {
    "okahu": {
      "type": "http",
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
  3. Start the MCP Server
  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key when your setup expects it.
  2. Run npx add-mcp https://mcp.okahu.co/mcp and choose Goose, or run goose configure and register Okahu as a remote MCP server. Goose stores extensions under ~/.config/goose/config.yaml; prefer the interactive flow if you are unsure of the exact fields for your version.
  3. Start or restart Goose.
  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. Add the following to project opencode.json:

`opencode.json`
{
  "mcp": {
    "okahu": {
      "type": "remote",
      "url": "https://mcp.okahu.co/mcp",
      "enabled": true,
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
3. If your OpenCode build supports OAuth for this server, use opencode mcp auth okahu when applicable. Restart OpenCode after changes.

  1. Add OKAHU_API_KEY environment variable with your Okahu Cloud API Key.
  2. In Zed settings (for example ~/.config/zed/settings.json), under context_servers, add:

`settings.json`
{
  "context_servers": {
    "okahu": {
      "url": "https://mcp.okahu.co/mcp",
      "headers": {
        "x-api-key": "${OKAHU_API_KEY}"
      }
    }
  }
}
3. Restart Zed. Check the Agent Panel for a green server indicator.