Claude Desktop 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 FrankKi as a connector

   Claude signs in over OAuth, you need no token. Follow the five steps below in Claude on the web or in the desktop app. If you have no FrankKi account yet, you create it in the sign-in window. If you configure Claude Desktop through claude_desktop_config.json instead of Connectors, bridge with mcp-remote: {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.frankki.app"]}.

   1. In Claude, open Customize > Connectors.
   2. Click + Add, then Add custom connector.
   3. Name it FrankKi, paste this URL and click Continue.
   4. Keep the detected settings and click Continue. Under Authentication choose Sign in now, then click Add.
   5. In the window that opens, sign in with your FrankKi account or create one. New accounts get a code by email, which you enter. If you have not signed the data processing agreement yet, you sign it here. Then allow access.

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 →