Managed beta: not yet available. This describes the self-serve managed onboarding flow, which has not shipped. Current provisioning is manual. If you need setup help, email us.

What you're about to do

Four required steps. Each has one task, one thing to confirm worked, and a "trouble?" expandable if it doesn't. Don't skip ahead; each step builds on the one before.

  1. Sign in to your Mandaire ~1 min
    From the link in your welcome email.
  2. Download Element and connect ~3 min
    Element is the chat app you use to talk to your Mandaire. Free, open-source, runs on Mac / Windows / Linux / iOS / Android.
  3. Provide your Claude API key ~2 min
    From your existing Anthropic account. Mandaire never sees the key in plaintext after you paste it; it's stored encrypted on your own machine.
  4. Start the onboarding conversation ~10 min
    The AI walks you through everything else: your project idea, the domain you want to use, GitHub access, Cloudflare for deploys. Conversational, not a form.
What you don't need: coding skills, a server you manage, or a credit card. Your Mandaire runs on infrastructure we provide. The only paid thing is your existing Claude subscription, which you keep on your own bill. If we vanished tomorrow, your code, your audit log, your decision history all stay on your side; see "Pause, disconnect, leave" below.
Step 1~1 minute

Sign in to your Mandaire

Open the welcome email we sent you. It has:

  • A "Sign in to Mandaire" button: click it, and you'll land on your own dashboard at https://<your-handle>.mandaire.dev
  • A one-time setup password; you'll set your real password on the next screen
  • A recovery phrase (twelve words); please write this down on paper and put it somewhere safe

On the dashboard, set your real password. Leave this tab open; you'll come back to it in step 3.

About that recovery phrase. The twelve words are the master secret for your Mandaire. We do not store the recovery phrase, cannot reset it, and cannot recover it for you. If you lose your password and your recovery phrase, your account is locked permanently, by design. Just write the phrase down on paper. Don't email it to yourself, don't paste it into chat, don't save it in a syncable password manager. Paper, in one place you'll find later.
You'll know it worked: the dashboard shows your name and "0 / 4 setup steps complete"; only step 1 is checked off. We'll fix the rest of those below.
Trouble? Click here

Most common issues:

  • "Sign in" button doesn't load: Check spam; the welcome email sometimes lands there.
  • Wrong password: Use the temporary password from the email exactly as shown, no extra spaces.
  • "Server not ready" message: Your Mandaire is still being provisioned. Wait 10 minutes and try again. If it's still not ready, reply to the welcome email.
  • Still stuck: Reply to the welcome email; we'll see it within a couple hours.
Step 2~3 minutes

Download Element and connect

You talk to your Mandaire through Element, an open-source chat app that connects to your private Mandaire room over an encrypted channel. Think of it as the door you walk through to talk to Mandaire. Element is free; nothing on Element's side ever sees your conversation contents.

On a Mac or Windows computer (recommended for setup)
  1. Go to element.io/download and download Element for your system.
  2. Install and launch it. On first run, choose "Sign in with homeserver URL" (sometimes labeled "Edit" next to the server URL).
  3. Paste the homeserver URL from your welcome email; it looks like https://matrix.<your-handle>.mandaire.dev
  4. Click Continue. You'll be redirected to a Mandaire sign-in page; use the password you set in step 1.
  5. After signing in, look for a room called "Mandaire" in your sidebar. Click it. You should see a "Hello, I'm your Mandaire" message waiting for you.
On iOS or Android (for the road)
  1. Search "Element" in the App Store or Play Store. Make sure you get the one by Element Messenger (officially Element X works too if you prefer).
  2. On first run, when asked for a server, tap the small "Other" / "Edit" option and paste your homeserver URL from the welcome email.
  3. Sign in with the password you set in step 1.
  4. Open the "Mandaire" room. You should see the welcome message there.

You can use Element on both your computer and your phone at the same time. Conversations stay in sync.

Encrypted by default. Element verifies your device the first time you sign in on a new machine. You may see a verification prompt; confirm "yes" on the originating device. This is normal; it's how the encryption layer makes sure no one is spoofing you. If it looks weird, your welcome email has the device-verification walkthrough.
You'll know it worked: the Mandaire room shows a welcome message from your AI. Don't reply yet; you need step 3 first.
Trouble? Click here

Most common issues:

  • "Can't connect to server": Make sure the homeserver URL is exactly the one in your welcome email, starting with https://matrix.
  • Sign-in works but no Mandaire room appears: Wait 60 seconds. The room is being created on the server side; it should show up. If it doesn't, refresh / restart Element.
  • Device verification prompt confuses you: If you're signing in on your only device, choose "Verify with recovery key" and use the recovery phrase from step 1. Otherwise, verify by cross-checking emoji or numbers with another signed-in device.
  • Still stuck: Reply to the welcome email with a screenshot.
Step 3~2 minutes

Provide your Claude API key

Mandaire does its thinking using your Claude account, not ours. We never sell tokens. You bring your Claude API key, and the AI reasoning runs against your subscription; every dollar you spend on tokens stays visible to you on the Anthropic side.

  1. Open console.anthropic.com/settings/keys in another tab. (You'll need to sign in to Anthropic if you aren't already.)
  2. Click Create Key. Name it something like mandaire-dev so you can identify it later. Copy the key; Anthropic only shows it once.
  3. Go back to your Mandaire dashboard tab (from step 1). Find the API Keys section. Paste the key into the Claude API key field and click Save.
  4. The dashboard immediately validates the key against Anthropic and shows the model tier you have access to (Sonnet, Opus, etc).
What happens to the key. It's encrypted with your password before it's stored on your Mandaire server. Mandaire workers decrypt it just-in-time for each Claude call. We never log the key, never expose it to other tenants, and never use it for anything you didn't ask for. You can rotate it any time on Anthropic's side; the dashboard surfaces if a key has expired or hit a rate limit.
Heads-up on Claude Max. If you have a Claude Max subscription, it includes API token value equivalent to the subscription cost. For most Mandaire builders the included allowance is not enough; serious build work runs hundreds of dollars in tokens monthly. Plan to fund the API contract on top of Max, or set a usage alert on Anthropic's side so you don't get surprised.
You'll know it worked: dashboard shows "Claude API key: valid" with the model tier shown. Setup steps complete: 3 / 4.
Trouble? Click here

Most common issues:

  • "Invalid key": Anthropic API keys start with sk-ant-. Make sure you copied the whole thing including that prefix.
  • "Rate-limited" almost immediately: Your Anthropic account may not have a paid API plan attached. Check at console.anthropic.com/settings/billing.
  • You only have Claude Max, no API access: Max includes API access via the same key endpoint, but it's separately enabled. Go to console.anthropic.com/settings/keys and check if "API access" is on. If not, you may need to set up a billing method.
  • Still stuck: Reply to the welcome email.
Step 4~10 minutes

Start the onboarding conversation

Now the real setup happens, in conversation with the AI, not on a form. Open the Mandaire room in Element. Send a single message: "Ready to start".

The AI will then walk you through everything that's left, asking one question at a time. Expect it to cover (in some order, with detours if you have questions):

  • What do you want to build? A description, who it's for, what success looks like. Take your time; this is the part where being clear pays off the most.
  • What's in scope? And just as important: what's out of scope (yet). Mandaire will write this down so neither of you forgets.
  • Where should this run? A domain name (you can use one you own, or have Mandaire register one for you). Cloudflare for DNS and deploys (Mandaire will ask for a Cloudflare API token; instructions in-chat).
  • Where does the code live? A GitHub repository, either existing or one Mandaire creates. The AI will ask for repo access via a fine-grained personal access token, and explain exactly which permissions it needs.
  • What approval style do you want? What kinds of changes does Mandaire just do versus stop and ask? Production deploys always wait for your sign-off. Staging and dev are configurable.

None of this is a fixed script. If you tell the AI "I don't have a domain yet, can you suggest some?" it will. If you say "skip GitHub for now, I want to think first," it will. The AI's job is to get you to a working first iteration; the path is yours.

You can pause anywhere. Onboarding doesn't have to finish in one sitting. The AI keeps track of where you got to. Come back tomorrow, type "let's keep going," and it picks up.
You'll know it worked: by the end of the conversation, the AI sends you a one-page intent brief summarizing what you're building, what it's not building, the assumptions it's making, and the first one or two product calls it needs from you before implementation. Read it. Correct what's wrong. Then say "go", and Mandaire starts building. The dashboard shows "Setup complete · Building first iteration."
Trouble? Click here

Most common issues:

  • "Ready to start" gets no response: Check that step 3 finished (dashboard shows Claude API key valid). The AI needs the key to think.
  • The AI keeps repeating itself: Restart Element and refresh. Rarely, the AI loses sync with the dashboard state; refresh fixes it.
  • The conversation feels too long: You can tell the AI "skip everything you don't strictly need" and it'll defer the optional configuration to later. Domain, repo, and approval policy are the only hard requirements.
  • Still stuck: Reply to the welcome email with a screenshot of the conversation.

You're done with the essentials.

Mandaire is now connected and ready to build with you. The optional connections below add capability but are not required.

More capability

Optional connections

The AI will offer these in conversation when they become relevant. You don't have to set them up ahead of time. Here for reference.

Optional~5 min · easy

Additional deploy targets

If your project deploys to somewhere other than Cloudflare Pages (AWS, Vercel, Railway, Fly.io, your own server), Mandaire can handle that. The AI will ask for the relevant credentials when the project needs them. All credentials stored encrypted; revocable from the dashboard.

Optional~3 min · easy

Stripe (or other billing)

If you're building something that takes payments, Mandaire can integrate Stripe (or alternatives) into your build. The AI will guide you through the API-key flow when you ask it to add billing. Production keys are gated behind explicit approval; Mandaire never moves live money without your sign-off.

Optional~5 min · intermediate

Slack / Discord / SMS for build alerts

By default Mandaire reports back in Element. If you want the same brief mirrored to Slack, Discord, or as a text message (via Twilio), the AI can set that up. Useful if your team uses one of those for ops.

Optional~10 min · intermediate

Custom integrations (MCP)

If you have an existing system Mandaire should know about: a database, an internal API, a third-party service it doesn't already know; you can hand Mandaire an MCP server URL and credentials. The AI will ask if there's anything like this during onboarding; you can also add them later. Read-only by default; writes require explicit approval per integration.

Always in your control

Pause, disconnect, leave

Pause Mandaire

In Element, send "pause" to your Mandaire room. The AI immediately stops all building, deploying, and proactive work. In-progress conversations finish gracefully. Send "resume" to start again. The dashboard also has a Pause button at the top.

Revoke the Claude API key

If you ever want to immediately cut off Mandaire's ability to think: rotate the key on Anthropic's side at console.anthropic.com/settings/keys. Mandaire stops working within seconds. Replace it in the dashboard when you're ready to resume.

Take everything and leave

Reply to your welcome email with the word offboard. Within 24 hours we'll: (1) push your full code repository to a destination you control, (2) export your decision history, audit log, and taste-memory corpus as plain markdown to that same destination, (3) revoke every credential Mandaire holds on your behalf, (4) shut down and delete your Mandaire server, (5) send you a confirmation log showing every revocation. Your code, your domain, your data, all yours. No retention, no friction.

Self-host instead

The whole stack is open-source. If you'd rather run it on your own infrastructure than have us host it, the self-host path is described at how it runs. You can switch any time; we'll help with the migration.

If anything is unclear, that's our bug, not yours.

You're in private beta. We'd rather over-help than have you struggle in silence. Anything that confused you above is something we should fix on the page, not something you should work around. Tell us what hit you.

Reply to your welcome email
Real humans, real beta