# Gemini CLI and others

> Connect Gemini CLI, Windsurf or any MCP client that supports Streamable HTTP and OAuth to Korala.

Source: https://docs.korala.ai/ai-agents/other-clients

---

  Screenshots of Gemini CLI and Windsurf will be added after the public launch. The steps below follow Gemini CLI's and Windsurf's current documentation (checked 2026-09-18); menu names can change.

## Gemini CLI

1. Add the server:

   ```bash
   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](https://docs.korala.ai/ai-agents/permissions).

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

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

Or install the extension, which adds the same server:

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

## Windsurf

The vendor now documents this product as Devin Desktop at [docs.devin.ai](https://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`:

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

Then approve the connection on Korala's consent page. See [Permissions and safety](https://docs.korala.ai/ai-agents/permissions).

## 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:

```text
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](https://docs.korala.ai/ai-agents/api-key).