Skip to Content
AI AgentsGemini CLI and other clients

Gemini CLI and other clients

Every client on this page connects to the same address, https://api.korala.ai/mcp, and signs in through your browser. When the client opens Korala, approve the connection on the consent page. See Permissions and safety. Clients disagree on what to call the address key, so copy the snippet for yours.

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.

If you edit settings.json by hand, Gemini CLI names the key httpUrl:

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

Or install the extension, which adds the same server and instructions for the agent:

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

Devin and Windsurf

Windsurf is now Devin Desktop. Its default agent, Devin Local, uses the same configuration as the Devin CLI:

devin mcp add -s user korala https://api.korala.ai/mcp
devin mcp login korala

-s user saves the server to ~/.config/devin/mcp_config.json. Without it, Devin saves the server for the current project only.

The legacy Cascade agent reads ~/.config/devin/mcp_config.json too, and names the key serverUrl. Open the file from the … menu of the Cascade panel:

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

Zed

Add Korala to context_servers in Zed’s settings.json:

{
  "context_servers": {
    "korala": {
      "url": "https://api.korala.ai/mcp"
    }
  }
}

Zed asks you to sign in because the entry has no Authorization header.

JetBrains AI Assistant and Junie

AI Assistant: open Settings → Tools → AI Assistant → Model Context Protocol, choose Add, and paste:

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

JetBrains does not document sign-in for remote servers in AI Assistant. If it cannot sign in to Korala, use Junie or the API key setup.

Junie: put the same JSON in ~/.junie/mcp/mcp.json, or in .junie/mcp/mcp.json for one project. Then run /mcp, choose korala and Authorize.

Cline

Open MCP Servers → Configure and add Korala to cline_mcp_settings.json. Cline spells the type streamableHttp. Without a type, Cline falls back to the older SSE transport, so keep the type:

{
  "mcpServers": {
    "korala": {
      "type": "streamableHttp",
      "url": "https://api.korala.ai/mcp",
      "disabled": false
    }
  }
}

Continue

Create .continue/mcpServers/korala.yaml in your workspace:

name: Korala
version: 0.0.1
schema: v1
mcpServers:
  - name: Korala
    type: streamable-http
    url: https://api.korala.ai/mcp

Continue does not document sign-in for remote servers. If it cannot sign in to Korala, use the API key setup with command: npx and args: ["-y", "@korala/mcp"].

Goose

Open this link on the machine that runs Goose:

goose://extension?url=https%3A%2F%2Fapi.korala.ai%2Fmcp&type=streamable_http&id=korala&name=Korala&description=Prepare%20and%20track%20documents%20for%20signing&timeout=300

Or add Korala to ~/.config/goose/config.yaml. Goose spells the type streamable_http and the address key uri:

extensions:
  korala:
    name: Korala
    type: streamable_http
    uri: https://api.korala.ai/mcp
    enabled: true
    timeout: 300

Goose opens a browser to sign in the first time it uses Korala.

Kiro

Open this link to add Korala to Kiro:

https://kiro.dev/launch/mcp/add?name=Korala&config=%7B%22url%22%3A%22https%3A%2F%2Fapi.korala.ai%2Fmcp%22%7D

Or add it to ~/.kiro/settings/mcp.json, or to .kiro/settings/mcp.json for one workspace:

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

Kiro CLI replaces the Amazon Q Developer CLI and reads the same files.

OpenCode

Add Korala to opencode.json in your project, or to ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "korala": {
      "type": "remote",
      "url": "https://api.korala.ai/mcp",
      "enabled": true
    }
  }
}

Run opencode mcp auth korala to sign in.

Warp

Add Korala to ~/.warp/.mcp.json:

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

Warp opens a browser to sign in.

Raycast

MCP in Raycast needs Raycast Pro.

  1. Run the Install MCP Server command.
  2. Enter the name Korala, choose the HTTP transport and enter https://api.korala.ai/mcp.
  3. Set OAuth Type to Dynamic, then sign in.

LibreChat

LibreChat is self-hosted, so an administrator adds Korala to librechat.yaml:

mcpServers:
  korala:
    type: streamable-http
    url: https://api.korala.ai/mcp
    requiresOAuth: true
    title: Korala

Each user then signs in to Korala from the chat.

Mistral Le Chat

  1. Open Connectors and choose Add Connector, then Custom MCP Connector.
  2. Enter the name korala and the server URL https://api.korala.ai/mcp.
  3. Le Chat detects Korala’s sign-in. Sign in and approve the connection.

Microsoft Copilot Studio

  1. Open your agent, then Tools → Add a tool → New tool → Model Context Protocol.
  2. Enter a name, a description and the server URL https://api.korala.ai/mcp.
  3. Under authentication, choose OAuth 2.0, then Dynamic discovery.
  4. Create the tool and sign in to Korala when Copilot Studio asks.

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.

Last updated on
Google AntigravityPermissions and safety