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.

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.
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.
Name it GigaRAG and paste this URL
Server URL
```
https://mcp.gigarag.com/mcp
```
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 use the GigaRAG CLI

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.

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.
Open Settings, then Developer, then Edit Config

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>" }
    }
  }
}

3.
Quit Claude Desktop completely and reopen it

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.

Turn on Web search for the chat first, since that is what lets Claude open a link.

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 web fetch. If you can run code with network access, the page also shows a faster direct API.

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/claude-desktop". Don't retry with the old key.

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

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.
Open Settings, then Connectors, then Add custom connector
2.
Paste this as the MCP server URL
Server URL
```
https://mcp.gigarag.com/mcp
```
3.
Set Authentication to No sign-in
4.
Under Request headers, add authorization with this value
Authorization
```
Bearer <api-key>
```

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