KI-Assistenten verbinden

Ein KI-Assistent kann deine Zahlen lesen und in normaler Sprache antworten: „Wie viel habe ich letzten Monat netto verdient?“, „Welches Buch kostet mich am meisten Werbung?“.

Er kann nur lesen. Der Assistent sieht, was die TrueRoyalties-API sieht — Tantiemen, Werbeausgaben, Nettogewinn, Bücher, Reihen, Kindle Unlimited — und ändert nichts in deinem Konto.

Was der Assistent sehen kann

• Alles, was die API sieht, und nichts anderes: Tantiemen, Werbeausgaben, Nettogewinn, Bücher, Reihen, Kindle-Unlimited-Seiten, Gratis-Downloads.
• Nichts, was er ändern kann: keine Synchronisierung, keine Einstellung, kein Buch, keine Abrechnung.
• Deine Zahlen verlassen TrueRoyalties wirklich. Verbinde nur einen Assistenten, dem du deine Verkaufshistorie anvertraust: hat er deine Zahlen einmal gelesen, stoppt das Trennen jedes weitere Lesen, holt aber nicht zurück, was er schon gelesen hat.

Die Adresse, und was jeder Assistent braucht

Eine Adresse, dieselbe für alle Assistenten:

https://author.trueroyalties.com/api/mcp

Jedes andere Tool, das eigene MCP-Server unterstützt, kann dieselbe Adresse verwenden.

Alles steht auf einer Seite in der App — Einstellungen → API: die Adresse, die fertigen Befehle und deine Schlüssel. Jeder Block hat einen Kopieren-Button.

claude.ai

1. Öffne in claude.ai Customize im linken Menü.

2. Öffne den Tab Connectors.

3. Klicke auf Add und dann auf Add custom connector.

4. Nenne ihn TrueRoyalties, füge https://author.trueroyalties.com/api/mcp ein und klicke auf Continue.

5. Ändere auf der nächsten Seite nichts: claude.ai hat erkannt, dass TrueRoyalties dich anmeldet und eine eigene Identität veröffentlicht. Klicke auf Add.

6. Klicke auf Connect.

7. Melde dich bei TrueRoyalties an, falls danach gefragt wird.
8. Prüfe, welche App den Zugriff möchte, und klicke auf Erlauben.

9. Du landest wieder in claude.ai. Wähle auf der Connector-Seite unter Tool permissions die Option Always allow: Claude liest deine Zahlen dann, ohne jedes Mal zu fragen, und mehr kann dieser Connector ohnehin nicht.

Schalte den Connector in einer Unterhaltung ein, falls die App danach fragt, und stelle deine Frage.

Frag Haiku. Es ist das schnellste und günstigste Claude-Modell, und deine Zahlen zu lesen verlangt ihm nicht mehr ab. Wähle es im Modellmenü deiner Unterhaltung.

Ein kostenloses Claude-Konto kann einen benutzerdefinierten Connector hinzufügen.

Zum Trennen öffnest du in TrueRoyalties Einstellungen → API → Verbundene Apps und wählst Trennen. Er liest deine Zahlen ab sofort nicht mehr.

Claude Desktop

Claude Desktop nutzt dieselben Connectors wie claude.ai — es ist nichts weiter zu installieren. Füge den Connector in einem von beiden hinzu, melde dich an und klicke auf Erlauben. Danach läuft er in beiden.

ChatGPT

ChatGPT verbindet sich anders als Claude: eigene Server liegen hinter dem Entwicklermodus, den es nur in den kostenpflichtigen Tarifen gibt. Hier der ganze Weg.

1. Schalte in den Einstellungen von ChatGPT den Entwicklermodus ein.
2. Öffne Plugins und dann New plugin.
3. Name: tippe TrueRoyalties. Symbol und Beschreibung sind optional.
4. Connection: lass Server URL stehen und füge https://author.trueroyalties.com/api/mcp ein.
5. Authentication: wähle OAuth. Darunter ist nichts auszufüllen — TrueRoyalties veröffentlicht seine Einstellungen unter dieser Adresse, und ChatGPT liest sie.
6. Hake I understand and want to continue an — diesen Hinweis zeigt ChatGPT für jeden eigenen Server, auch für unseren — und klicke auf Create.

7. ChatGPT öffnet TrueRoyalties: melde dich an, falls danach gefragt wird, prüfe, dass die anfragende App ChatGPT ist, und klicke auf Erlauben.
8. Schalte das Plugin in einer Unterhaltung ein, bevor du deine erste Frage stellst.
9. Lege unter Settings → Plugins → TrueRoyalties → Permissions fest, was ChatGPT allein tun darf. Allow read actions genügt: dieser Connector kann nur lesen. Allow all actions ist als erhöhtes Risiko markiert und bringt hier nichts.

Zum Trennen öffnest du in TrueRoyalties Einstellungen → API → Verbundene Apps und wählst Trennen — genau wie bei claude.ai.

Claude Code

Erstelle einen Schlüssel unter Einstellungen → API → Schlüssel erstellen, nenne ihn „Claude Code“ und kopiere ihn. Er wird nur ein einziges Mal angezeigt.

Führe dann dies im Terminal aus, mit deinem Schlüssel statt YOUR_API_KEY:

claude mcp add --transport http trueroyalties https://author.trueroyalties.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

• Prüfen mit claude mcp list oder /mcp in Claude Code.
• Der Server wird zum aktuellen Projekt hinzugefügt. Mit --scope user gilt er überall.
• Entfernen: claude mcp remove trueroyalties.

Cursor

Leg deinen Schlüssel in die Umgebungsvariable TRUEROYALTIES_API_KEY und füge dies in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) ein:

{
  "mcpServers": {
    "trueroyalties": {
      "url": "https://author.trueroyalties.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TRUEROYALTIES_API_KEY}"
      }
    }
  }
}

Cursor liest den Schlüssel aus dieser Variablen, die Datei enthält ihn also nie. Setze die Variable, bevor du Cursor öffnest.

VS Code

Öffne MCP: Open User Configuration über die Befehlspalette (alle Projekte), oder lege .vscode/mcp.json in einem Projekt an, und füge ein:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "trueroyalties-api-key",
      "description": "TrueRoyalties API key",
      "password": true
    }
  ],
  "servers": {
    "trueroyalties": {
      "type": "http",
      "url": "https://author.trueroyalties.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:trueroyalties-api-key}"
      }
    }
  }
}

VS Code fragt beim ersten Start des Servers nach dem Schlüssel und merkt ihn sich, die Datei enthält ihn also nie.

Was du fragen kannst

Der Assistent wählt das passende Werkzeug für deine Frage. Jedes Werkzeug liest einen Teil der API.

Gut zu wissen

• Dieselben Zahlen wie die App. Jede Antwort nennt Zeitraum und Währung und sagt es, wenn eine Zahl unvollständig ist.
• Ein Schlüssel liest dein ganzes Konto. Halte ihn aus geteilten Dateien heraus und widerrufe ihn unter Einstellungen → API, sobald du den Assistenten nicht mehr nutzt.
• Geteilte Limits mit der API: 60 Anfragen pro Minute und 10.000 pro Tag für dein Konto. Eine Frage kann mehrere Anfragen kosten. Siehe Limits und Fehler.
• Ohne Konto ausprobieren in einem Entwicklertool: der öffentliche Demo-Schlüssel aus der API-Referenz funktioniert auch hier und liest die fiktiven Zahlen des Demo-Kontos.