Nurama Developers
Guides

MCP server

Connect Claude, Cursor or any Model Context Protocol client to Nurama in two steps.

Nurama runs a hosted Model Context Protocol server at https://mcp.nurama.com/mcp. An assistant connected to it can read projects, chats, assets, boards and tasks, and, when allowed, post messages and create or update tasks, all as the person who signed in and within the scopes they approved.

Connect

Add the server to your client and sign in when the browser opens. Nurama asks whether to grant read-only (nurama.read) or read-and-write (nurama.write) access.

Claude Code

claude mcp add --transport http nurama https://mcp.nurama.com/mcp

Claude desktop and claude.ai: add a custom connector with the URL https://mcp.nurama.com/mcp.

Cursor and other clients: add an entry to the client's MCP configuration.

{
  "mcpServers": {
    "nurama": { "url": "https://mcp.nurama.com/mcp" }
  }
}

Ask the assistant which Nurama tools it has to confirm the connection. The tool catalogue lists every tool with its input schema; the raw list, identical to the server's tools/list response, is at /mcp-tools.json.

Headless clients

Where a browser sign-in is not possible, for example in CI or a server-side agent, send a personal access token as a bearer header instead of using OAuth:

Authorization: Bearer nrm_pat_…

The connection then acts as the token's owner within the token's scopes. Bot API keys are not accepted by the MCP server; they are a service identity for the REST and WebSocket APIs, not a personal credential for an assistant.

What the assistant can do

Read tools cover memberships, project feeds, chats, messages, boards and tasks. Write tools, such as sending a message or creating a task, are flagged as mutating in the catalogue and only work under a read-and-write grant or a token with the matching write scopes. Nothing the assistant does can reach billing, account security, token management or webhook subscriptions, whatever it is asked.

Grant the narrowest access that does the job: a read-only connection cannot be talked into writing, whatever the prompt says.

Revoking access

Revoke an OAuth grant or a personal access token from your Nurama account settings. Connections using it stop working immediately.

On this page