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

Full-scope keys can publish directly through Claude or the REST API (`POST /api/posts/:id/publish`).

You can still review in the CMS first — most teams keep a human pass even when the gate is optional.

Troubleshooting / FAQ

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.