Docs Start here
Connect your AI assistant (MCP)
One command connects Relia to Claude Code, Cursor, VS Code, Windsurf, Codex, Antigravity and Gemini CLI, so you can ask what's broken from your editor.
Relia has an MCP server: a standard way for AI assistants to read tools like Relia. Once connected, you can ask your assistant "what needs my attention?", "why is /orders failing?" or "fix the most important problem", and it answers from Relia's evidence.
You set this up once per person. One connection covers every Relia project you can see.
Before you start
- A Relia account (Create your account).
- Node.js on your computer, or Python with
uv(see below).
Connect every AI tool at once
In a terminal:
npx -y relia-sdk@latest mcp install
No Node.js? With Python:
uvx --from relia-sdk@latest relia mcp install
It finds the AI tools on your computer and adds Relia to each one, keeping your other settings: Claude Code, Cursor, VS Code, Windsurf, Codex (CLI, IDE extension and desktop app), Antigravity (IDE and CLI) and Gemini CLI.
Restart those tools. The first time each one opens a browser: sign in to Relia, see which tool is asking, choose all projects or only some, and click Allow. There is no token to copy.
Claude Desktop and claude.ai
Open Settings → Connectors → Add custom connector and paste Relia's MCP address:
https://devreliaapi.tryrelia.com/mcp
Then sign in when asked.
Add Relia to one tool by hand
Your Relia Profile (bottom of the menu) has a card, Use Relia in your AI assistants, with the exact line for each tool. For example, Claude Code:
claude mcp add --transport http relia https://devreliaapi.tryrelia.com/mcp --scope user
Then type /mcp, pick relia and choose Authenticate. Any other MCP tool: give it the address above; it asks you to sign in.
Tokens for CI and scripts
For a script, CI, or a tool that can't sign in, create a token from the same Profile card (Use a token; it is shown once), then:
npx -y relia-sdk@latest mcp install --token <your-token>
or set RELIA_MCP_TOKEN. Keep the token private, like a password.
Check it worked
Ask your assistant:
Use Relia: what needs my attention?
It should answer from your Relia project in plain words. To see where Relia is set up:
npx relia-sdk@latest mcp status
What your assistant can and can't do
- It reads: what needs you, incidents, fix plans, dashboards, funnels, requests, logs, visits, database queries, page speed and uptime.
- It asks you first before anything that writes: marking a fix, giving a verdict on an incident, acknowledging an alert, recording a deploy, or creating a project. Relia refuses these without your confirmation, and each one is in the project's audit log.
- It can't change settings, delete data or see passwords.
The full list of tools is in MCP tools.
If something's wrong
- The tool doesn't list Relia: restart it after
mcp install. - "Sign-in required" or a 401: sign in again from the tool (in Claude Code:
/mcp→ relia → Authenticate). - Remove it everywhere:
npx relia-sdk@latest mcp uninstall.
Next
Last checked against the product: 1 Nov 2026