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.

Any MCP client

For any app that supports MCP servers, including ones not listed here.

Connect with the GigaRAG CLI

Any MCP client keeps its settings somewhere a command cannot safely rewrite, so the CLI prints exactly what to enter instead. Signing in still happens in your browser, and no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect any-mcp-client

Paste what it prints, then restart Any MCP client afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Sign in with GigaRAG

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

  1. 1.

    Add a remote server with only the URL, and choose OAuth if asked

  2. 2.

    Paste this as the server URL

    Server URL
    https://mcp.gigarag.com/mcp
  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.

Apps that support remote servers

  1. 1.

    Add a remote server using Streamable HTTP

    It may be called HTTP, Streamable HTTP or remote. If only SSE is offered, the app is too old to connect.

  2. 2.

    Paste this as the server URL

    Server URL
    https://mcp.gigarag.com/mcp
  3. 3.

    Add an Authorization header with this value

    Authorization
    Bearer <api-key>

Apps that only run local servers

mcp-remote runs on your machine and passes requests to GigaRAG. It needs Node.js and is a community package.

  1. 1.

    Add this to the app's MCP config

    MCP config
    {
      "mcpServers": {
        "gigarag": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.gigarag.com/mcp",
            "--header",
            "Authorization:${GIGARAG_AUTH}"
          ],
          "env": { "GIGARAG_AUTH": "Bearer <api-key>" }
        }
      }
    }

Quick connect

Paste this into a new chat. It carries a temporary key that stops working after 6 hours without use, so there is nothing to clean up afterwards. When it lapses, the chat tells you to come back here and copy a fresh one.

Connect to GigaRAG, my knowledge base. First read this page on how to use it:
https://gigarag.com/q/<temporary-api-key>

Open it with your browsing tool and follow its links.

Temporary key: <temporary-api-key>
It expires after 6 hours without use. If GigaRAG says it has expired, stop and tell me: "Key expired. Copy a new prompt from https://gigarag.com/connect/any-mcp-client". Don't retry with the old key.

If you can't open the page, say so. Once read, reply "Connected" and wait.

Check it worked

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

List my GigaRAG buckets.