Claude Code Quickstart

1. Step 0

   Your account

   You can create it while connecting, in the sign-in window, or beforehand at /dashboard/registrieren. It is free, needs no invitation and no company.

2. Step 1

   Add the server and sign in

   Run the first command, then type /mcp in Claude Code, pick frankki and sign in in your browser. No token needed. For headless runs without a browser, create a production token under /dashboard/tokens and use the second command.

   claude mcp add --transport http frankki https://mcp.frankki.app
   
   # headless, with a production token
   claude mcp add --transport http frankki https://mcp.frankki.app \
     --header "Authorization: Bearer YOUR_PRODUCTION_TOKEN"

3. Step 2

   Rehearse without sending

   Ask your assistant to run mcp_health, then order_send with dryRun:true. The rehearsal is free and returns the price and page 1 as an image, without a letter, a charge or an approval. It needs a complete sender profile and the signed data processing agreement; mcp_health lists what is missing, with a link.

   mcp_health({})
   
   order_send({
     "clientOrderId": "production-dry-run-001",
     "subject": "Connection check",
     "content": "This call only rehearses the send.",
     "recipientName": "Max Mustermann",
     "recipientStreet": "Musterstraße",
     "recipientHouseNumber": "1",
     "recipientZip": "10115",
     "recipientCity": "Berlin",
     "dryRun": true
   })

4. Step 3

   Send for real

   Without dryRun the send waits for your approval in the FrankKi dashboard and is charged from your wallet once you approve. Top up from EUR 10 before the first real letter.

See the Conventions panel →