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.

Claude Desktop

The Claude app for Mac and Windows. A connector added here, or on claude.ai, also works on the web and on your phone.

Connect with the GigaRAG CLI

Recommended

One command connects Claude Desktop 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 Claude Desktop afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Permanent connector

Adds GigaRAG to Claude Desktop for good. You sign in with your GigaRAG account and pick this workspace, and no key is involved.

Free plans allow one custom connector.

  1. 1.

    Open Settings, then Connectors, then Add custom connector

    On Team and Enterprise an owner adds it once under Organization settings, and members then click Connect.

  2. 2.

    Name it GigaRAG and paste this 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.

Add it to the config file

Claude Desktop only runs local servers from its config file, so this uses mcp-remote to reach GigaRAG. It needs Node.js, and mcp-remote is a community package, not made by Anthropic.

  1. 1.

    Open Settings, then Developer, then Edit Config

  2. 2.

    Add GigaRAG under mcpServers

    The key is passed through env because a space inside args breaks on some systems.

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

    Needs an API key. Get one from API keys.

  3. 3.

    Quit Claude Desktop completely and reopen it

Add it with your key (beta)

Request headers are a beta that only some organizations have. An admin enters the key once, and everyone in the organization shares it.

  1. 1.

    Open Settings, then Connectors, then Add custom connector

  2. 2.

    Paste this as the MCP server URL

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

    Set Authentication to No sign-in

  4. 4.

    Under Request headers, add authorization with this value

    Authorization
    Bearer <api-key>

    Needs an API key. Get one from API keys.

Check it worked

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

Search GigaRAG for my most recent memos and list their titles.

Written from the official docs: Custom connectors, Local servers in Claude Desktop