Start with Roami

What you're connecting

Roami is for people who make things while they move — a writer on a long train, a photographer between shoots, a founder drafting the next post from a café with unreliable wifi.

This guide gets you from a key in your inbox to a draft ready for human review. Claude talks to Roami over MCP; you stay in the loop for publish.

Request your key

Beta keys are founder-minted — there is no self-serve generate button yet. Email us with a short intro and we will reply with your key.

Connect Claude

Add Roami as an MCP server in Claude Desktop (or Cursor). Paste your key where you see sk_...

{
  "mcpServers": {
    "roami": {
      "type": "sse",
      "url": "https://mcp.roami.xyz/sse",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}

Create your first draft

Ask Claude something concrete. Good first prompts:

• Create a draft post titled “Notes from [place]” with three short sections.
• Turn this outline into a Roami draft and attach the tag [your topic].
• Search my content for posts about [topic], then draft a follow-up.

Review & publish

Beta keys create drafts only. Direct publish via API or MCP is blocked on purpose — a safety gate so an agent cannot push live content without you.

Open the CMS at https://app.roami.xyz, find the draft, review it, and publish from there when it is ready.

Troubleshooting / FAQ

My agent can't publish

That is intentional for beta keys. Publish is hard-blocked (API returns 403). Review the draft in the CMS and publish there. This is a beta safety feature, not a bug.

Claude does not see Roami tools

Confirm the MCP URL is https://mcp.roami.xyz/sse, the Authorization header uses Bearer sk_..., and Claude Desktop was fully quit and restarted after editing the config.

I get 401 Unauthorized

Check that the key is pasted without extra spaces, and that you are sending either Authorization: Bearer sk_... or x-api-key: sk_... against api.roami.xyz.

Where do drafts show up?

In the Roami app/CMS for the project tied to your key: https://app.roami.xyz. Drafts are created in DRAFT status by default.