Zeabur RAG Setup

Use when setting up or configuring the RAG plugin for the first time. Use when ZEABUR_RAG_URL or RAG_API_KEY are missing or need to be updated. Use when the RAG skill fails with authentication or connection errors.

zeabur fe1fe2e 1.3 KB Updated

File contents

RAG Setup

Configure the required environment variables for the RAG skills.

Required Variables

Variable Description Example
ZEABUR_RAG_URL RAG service base URL https://your-rag-service.zeabur.app
RAG_API_KEY API key for authenticated writes (report/learn) rak_xxxxxxxxxxxxxxxx

RAG_API_KEY is optional for search-only use. Required for /api/report and /api/learn.

Setup Steps

  1. Ask the user for ZEABUR_RAG_URL and RAG_API_KEY (or confirm existing values).

  2. Read ~/.claude/settings.json.

  3. Merge the env section — preserve all existing keys:

{
  "env": {
    "ZEABUR_RAG_URL": "<value>",
    "RAG_API_KEY": "<value>"
  }
}
  1. Write the updated file back.

  2. Tell the user to run /reload-plugins or restart Claude Code for the changes to take effect.

Notes

  • Store in ~/.claude/settings.json (user scope) so they apply across all projects.
  • Never commit these values to git.
  • If the user only wants read access, RAG_API_KEY can be left empty or omitted.

zeabur/rag-service/tree/main/skills/zeabur-rag-setup commit fe1fe2e945

Frequently asked questions

npx skillmds@latest add zeabur/zeabur-rag-setup