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.

ChatGPT desktop app

The ChatGPT app for Mac, Windows and Linux, with Codex built in. It shares its MCP config with Codex CLI and the Codex IDE extension.

Connect with the GigaRAG CLI

ChatGPT desktop app reads the same settings file as another tool, so the CLI sets both up at once. Signing in happens in your browser, so no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect codex-cli

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

Sign in with GigaRAG

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

  1. 1.

    Open Settings, then MCP servers, then Add

    Name it gigarag and set the transport to Streamable HTTP.

  2. 2.

    Paste this as the server URL

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

    Click Authenticate next to gigarag

  4. 4.

    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 paste a prompt

Paste this into ChatGPT desktop app. It carries your agent key and tells the agent exactly what to change, so it sets the connection up itself.

Merge into ~/.codex/config.toml:

[mcp_servers.gigarag]
url = "https://mcp.gigarag.com/mcp"
http_headers = { "Authorization" = "Bearer <api-key>" }

Then tell me to restart the app. Don't repeat the key.

Or set it up by hand

  1. 1.

    Add this to your Codex config

    On Windows the file is %USERPROFILE%\.codex\config.toml. The Add form in settings has no header field, so the key goes in the file.

    ~/.codex/config.toml
    [mcp_servers.gigarag]
url = "https://mcp.gigarag.com/mcp"
http_headers = { "Authorization" = "Bearer <api-key>" }
  2. 2.

    Restart the app

    Type /mcp in a Codex chat to see gigarag listed.

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: Codex MCP, The new ChatGPT desktop app