# Your AI assistant can't reach Relia

> Fix an AI assistant (Claude Code, Cursor, Codex, VS Code…) that can't read Relia, in three checks.

Section: When something doesn't work · Page: https://tryrelia.com/docs/mcp-connection · Last checked against the product: 2026-11-01
Video walkthrough: https://youtu.be/c55QHvtNiSk

You ask your AI assistant about your app and it answers with an error such as **Sign in with Relia**, or it doesn't list Relia at all. Try these three fixes in order.

## What you'll see

- An error from the Relia tool: "Sign in with Relia, or add a Relia MCP token…", or a 401.
- In Cursor, Relia's entry says **Needs login**.
- Or the assistant doesn't know about Relia: no `relia_*` tools.

## Fix 1: sign in again

Sign-ins and tokens expire after **90 days without use**. If the error mentions signing in, this is your fix.

- **Claude Code:** type `/mcp`, pick **relia**, and choose **Authenticate**.
- **Cursor:** click **Needs login** next to Relia in the MCP settings.
- **Other tools:** use the tool's own sign-in or reconnect action for Relia.

A browser opens on Relia. Read what the tool is asking for, choose all projects or only some, and click **Allow**. You are sent back to your tool.

## Fix 2: restart the tool

After an install, quit the tool fully and open it again. Tools read their MCP settings when they start. The install says so at the end: **Restart those tools.**

## Fix 3: check what's set up

```bash
npx relia-sdk@latest mcp status
```

Each tool shows one of:

- **set up**: Relia is added.
- **not installed**: the tool isn't on this computer.
- **installed, Relia not added**: run the install again.

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

It adds Relia to every AI tool it finds and keeps your other settings. Only some tools? Add `--only`, for example `--only cursor,codex`. Then restart the tool and sign in.

No Node.js on this computer? Use Python instead: `uvx --from relia-sdk@latest relia mcp install`.

> **Tip:** watch [Connect Claude Code, Cursor and Codex to Relia (MCP setup)](https://youtu.be/fpGlCkJzzKA) (2 min).

## Other problems

- **Claude Desktop or claude.ai:** the install marks Claude Desktop as **one step left**: you add Relia by hand. Open **Settings → Connectors → Add custom connector** and paste `https://devreliaapi.tryrelia.com/mcp`.
- **"Relia refused the token"** (token mode): the token was revoked or expired. Create a new one on your **Profile** under **Use Relia in your AI assistants**, then run `npx -y relia-sdk@latest mcp install --token <your-token>`.
- **"That isn't a Relia MCP token"**: MCP tokens start with `relia_mcp_`. A project key (`relia_live_…`) or an upload token won't work here.
- **"Relia isn't reachable at …"**: the install could not reach Relia. Check your network or proxy, then run it again.
- **A message about verifying your e-mail**: after the first 7 days, an unverified account can't read Relia from the app or from an AI tool. Verify your e-mail address, then try again.
- **"Which project?" or "No project … in reach of this token"**: you have several projects, or the connection only covers some. Say which project (its id or name), or reconnect and allow that project.
- **Too many requests:** each token or sign-in can make 300 calls an hour. Wait and try again.
- **Remove Relia everywhere and start over:** `npx relia-sdk@latest mcp uninstall`, then install again.

## Check it worked

Ask your assistant:

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

It answers from your Relia project, in plain words, with the problems Relia found.

## Next

- [Connect your AI assistant](https://tryrelia.com/docs/connect-ai-assistant.md)
- [Tokens and connected tools](https://tryrelia.com/docs/tokens-and-connected-tools.md)
- [MCP tools](https://tryrelia.com/docs/mcp-tools.md)
- [CLI reference](https://tryrelia.com/docs/cli.md#mcp)

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