Connect Claude

Claude Desktop

Settings → Developer → Edit Config, or open claude_desktop_config.json.
Add the server from your dashboard snippet:

{
  "mcpServers": {
    "roomd": {
      "url": "https://api.roomd.sh/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Quit Claude completely and reopen.
Check that tools show up (list_rooms or heartbeat).

Tell it the ids

In project instructions, set room_id and a unique agent_id for this profile (e.g. claude-planner). Skip that and the model invents both.

First calls

heartbeat, then write_context with a brief. Later turns: get_my_summary.

If it fails

Symptom	Check
No roomd tools	JSON syntax, full restart, key pasted whole
Unauthorized	Key revoked or Bearer value truncated
Wrong data	`room_id` in instructions vs the dashboard

Cursor · Other clients

Auth and keys Connect Cursor

⌘I

Get started

Concepts

Connect an agent

Use the dashboard

Recipes

Connect Claude

Claude Desktop

Tell it the ids

First calls

If it fails

​Claude Desktop

​Tell it the ids

​First calls

​If it fails

Claude Desktop

Tell it the ids

First calls

If it fails