Claude Desktop Quickstart

1. Step 0

   Create your account and complete production setup

   Sign up at /dashboard/registrieren, it is free and open. Then complete the sender profile and data processing agreement, and fund the wallet before any real send.

2. Step 1

   Create a production token and connect Claude Desktop

   The sandbox is currently unavailable. Under /dashboard/tokens, create a production token with only the rights this client needs. Production calls can debit your wallet and mail real letters. Copy the token when it is shown once and use it as the Authorization header.

   {
     "mcpServers": {
       "frankki-production": {
         "url": "https://mcp.frankki.app",
         "headers": { "Authorization": "Bearer YOUR_PRODUCTION_TOKEN" }
       }
     }
   }

3. Step 2

   Validate the connection without sending

   Run mcp_health, then keep dryRun:true on order_send. This checks the production gates and price without creating a letter, ledger entry or approval.

   mcp_health({})
   
   order_send({
     "clientOrderId": "production-dry-run-001",
     "subject": "Verbindungsprüfung",
     "content": "Dieser Aufruf prüft nur die Produktionskonfiguration.",
     "recipientName": "Max Mustermann",
     "recipientStreet": "Musterstraße",
     "recipientHouseNumber": "1",
     "recipientZip": "10115",
     "recipientCity": "Berlin",
     "dryRun": true
   })

4. Step 3

   Send only when you intend a real production order

   Removing dryRun creates a production send. It can debit real cents and mail a real letter. Review the recipient, content, price and approval mode before doing so.

See the Conventions panel →