Birta

Connect Claude Code

Claude Code builds your site on your own computer, so it publishes from there. One command adds Birta; nothing to install first.

  1. 1. Add Birta to Claude Code

    Run this in your terminal:

    claude mcp add birta -- npx -y @birta/cli mcp

    That adds Birta to the current project. To use it in every project instead:

    claude mcp add --scope user birta -- npx -y @birta/cli mcp

    You need Node.js 20 or newer. The package is fetched on first use, so you do not install it yourself, and updates come the same way.

  2. 2. Ask it for something, then confirm

    There is no sign-in step first. Ask Claude Code to make you a site or to list your Birta projects. The first request comes back with a link (and a short code) instead of a result — open the link, sign in with the one-time code sent to your email or with your Google account, and confirm access.

    Then ask Claude Code again — the request that was refused runs once access is confirmed. This installation stays authorized afterwards: there is no key to copy and nothing to paste back.

    Prefer to get it out of the way first? This command shows the same link and waits for your confirmation:

    npx -y @birta/cli login

  3. 3. How it works

    You never list files for Claude Code. It names two folders on your computer — your project and, if the site is built, the built site — and hands them over as they are. They go into your site's draft: nothing reaches your site address while it works, which keeps serving the version you published last and shows nothing at all until the first one.

    Claude Code publishes the draft itself once it considers the work done — you do not have to give it the go-ahead. It comes back with two addresses: your site address, which is the live site, and that version's own address, where you mark what you want changed straight on the page.

    Tell Claude Code what to change, or leave remarks on the version's page and say you have — it changes the files on your computer, hands the folders over again and publishes the next version. If a check fails, nothing is published: you are told everything that is in the way at once, and the draft stays as it was.

    Want to look before it goes live? Say so — ask Claude Code for a draft first and it gives you the draft's own address and waits for your word. The draft keeps that address round after round, so you refresh the page you already have open.

  4. 4. Check that it works

    Ask Claude Code to list your Birta projects. If it can see them, the connection is ready and you can ask it to publish or update a site.