Docs When something doesn't work

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.

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

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.
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) (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:

Use Relia: what needs my attention?

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

Next

Last checked against the product: 1 Nov 2026