Back to GigaRAG

Connect an agent

Give an AI tool access to your GigaRAG Workspace, so it can search, read and write your memos while it works.

Windsurf

Use your memos from Cascade in Windsurf.

On team plans an admin can turn MCP off, or allow only listed servers.

Connect with the GigaRAG CLI

One command connects Windsurf and every other AI tool on this machine. Signing in happens in your browser, so no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect

Restart Windsurf afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Sign in with GigaRAG

Connect without a key: Windsurf opens your browser, you sign in to GigaRAG and pick this workspace.

  1. 1.

    Add GigaRAG without a header

    ~/.codeium/windsurf/mcp_config.json
    {
  "mcpServers": {
    "gigarag": { "serverUrl": "https://mcp.gigarag.com/mcp" }
  }
}
  2. 2.

    Refresh the MCP servers in Cascade

  3. 3.

    Sign in with your GigaRAG account

    Your browser opens GigaRAG. Pick the workspace to share and approve. No key is stored in the app, and the connection does not expire.

Or set it up by hand

  1. 1.

    Add GigaRAG to your MCP config

    Open it from the MCP Marketplace with View raw config.

    ~/.codeium/windsurf/mcp_config.json
    {
  "mcpServers": {
    "gigarag": {
      "serverUrl": "https://mcp.gigarag.com/mcp",
      "headers": { "Authorization": "Bearer <api-key>" }
    }
  }
}
  2. 2.

    Refresh the MCP servers in Cascade, or restart Windsurf

Check it worked

Send this once it is connected. An answer drawn from your workspace means the connection is live.

List my GigaRAG buckets.

Written from the official docs: Cascade MCP