@conscience-technology/nora-relay-mcp

An MCP server that lets an AI coding agent (Claude Code, Cursor, …) set up the Nora Relay in-app bug reporter for you. "Add Nora Relay to this project" becomes: create the project, generate the embed, and place it in the right file — in the site's own colour and corner.

Configure

Add the server to your MCP client and give it your workspace credentials:

{
  "mcpServers": {
    "nora-relay": {
      "command": "npx",
      "args": ["-y", "@conscience-technology/nora-relay-mcp"],
      "env": {
        "NORA_RELAY_ORG": "your-workspace",
        "NORA_RELAY_KEY": "nrk_live_…"
      }
    }
  }
}

• NORA_RELAY_ORG — your workspace slug
• NORA_RELAY_KEY — an org API key (nrk_…), from the Relay console → Settings → API keys
• NORA_RELAY_API — optional, defaults to https://api.relay.nora.my

For Claude Code:

claude mcp add nora-relay -e NORA_RELAY_ORG=your-workspace -e NORA_RELAY_KEY=nrk_live_… \
  -- npx -y @conscience-technology/nora-relay-mcp

Tools

| Tool | What it does | |---|---| | relay_list_projects | List the projects (client sites) in your workspace | | relay_create_project | Create a project — name, mainUrl, optional repoRef | | relay_widget_snippet | Generate the embed snippet for a project key | | relay_install_widget | Detect the framework and place the widget in this project |

relay_widget_snippet and relay_install_widget take the same look & placement options as the CLI: accent, position (bottom-right · bottom-left · top-right · top-left), offsetX, offsetY, lang.

Example

You: Add Nora Relay to this site, blue button in the bottom-left.

Agent: calls relay_create_project → relay_install_widget with accent: "#0075de", position: "bottom-left" → widget added to app/layout.tsx.

Prefer a command line?

@conscience-technology/nora-relay is the same capability as a CLI: npx @conscience-technology/nora-relay init.

License

MIT