Gemini CLI and others

Gemini CLI

1. Add the server:

   gemini mcp add --transport http korala https://api.korala.ai/mcp

2. Start Gemini CLI and sign in to Korala when it asks.

3. Approve the connection on Korala’s consent page. See Permissions and safety.

If you edit settings.json by hand, Gemini CLI names the key httpUrl, where most clients use url:

{
  "mcpServers": {
    "korala": {
      "httpUrl": "https://api.korala.ai/mcp"
    }
  }
}

Or install the extension, which adds the same server:

gemini extensions install https://github.com/korala-ai/gemini-extension

Windsurf

The vendor now documents this product as Devin Desktop at docs.devin.ai . The config path and the serverUrl key are unchanged.

Add the server to ~/.codeium/windsurf/mcp_config.json. Windsurf names the key serverUrl:

{
  "mcpServers": {
    "korala": {
      "serverUrl": "https://api.korala.ai/mcp"
    }
  }
}

Then approve the connection on Korala’s consent page. See Permissions and safety.

Any MCP client

Point the client at https://api.korala.ai/mcp. The client needs two things:

• Streamable HTTP transport.
• OAuth 2.1 with dynamic client registration.

Clients discover the authorization server from:

https://api.korala.ai/.well-known/oauth-protected-resource

A request without a token gets 401 and a WWW-Authenticate header that carries the metadata URL.

A client that supports stdio servers only can run the local package with an API key.