Cursor-Quickstart

1. Schritt 0

   Konto anlegen und Produktion einrichten

   Leg dein Konto unter /dashboard/registrieren an, das ist kostenlos und offen. Vervollständige danach das Absenderprofil und den AVV und lade vor einem echten Versand dein Guthaben auf.

2. Schritt 1

   Produktions-Token erzeugen und Cursor verbinden

   Die Sandbox ist derzeit nicht verfügbar. Erzeuge unter /dashboard/tokens einen Produktions-Token mit genau den Rechten, die dieser Client braucht. Produktive Aufrufe können dein Guthaben belasten und echte Briefe verschicken. Kopiere den einmal angezeigten Token und nutze ihn als Authorization-Header.

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

3. Schritt 2

   Verbindung ohne Versand prüfen

   Rufe mcp_health auf und behalte bei order_send dryRun:true bei. So prüfst du Produktionsregeln und Preis, ohne Brief, Buchung oder Freigabe anzulegen.

   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. Schritt 3

   Nur bewusst einen echten Produktionsauftrag senden

   Wenn du dryRun entfernst, entsteht ein Produktionsversand. Er kann echte Cent abbuchen und einen echten Brief verschicken. Prüfe vorher Empfänger, Inhalt, Preis und Freigabemodus.

Konventionen-Panel ansehen →