# 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.

Section: Start here · Page: https://tryrelia.com/docs/connect-ai-assistant · Last checked against the product: 2026-11-01
Video walkthrough: https://youtu.be/fpGlCkJzzKA

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](https://tryrelia.com/docs/create-account.md)).
- Node.js on your computer, or Python with `uv` (see below).

## Connect every AI tool at once

In a terminal:

```bash
npx -y relia-sdk@latest mcp install
```

No Node.js? With Python:

```bash
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:

```text
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:

```bash
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:

```bash
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:

```text
Use Relia: what needs my attention?
```

It should answer from your Relia project in plain words. To see where Relia is set up:

```bash
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](https://tryrelia.com/docs/mcp-tools.md).

## 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

- [Set up Relia with your AI assistant](https://tryrelia.com/docs/setup-with-ai-assistant.md)

---
All Relia docs for AI assistants: https://tryrelia.com/llms.txt (index) · https://tryrelia.com/llms-full.txt (everything in one file)
