Een AI-assistent koppelen

Vraag claude.ai, ChatGPT, Claude Code, Cursor, VS Code of Claude Desktop naar je royalty's, advertenties en nettowinst: hij leest dezelfde cijfers als de app.

Laatst bijgewerkt: 3 okt 2026

Een AI-assistent kan je cijfers lezen en in gewone taal antwoorden: "Hoeveel heb ik vorige maand netto verdiend?", "Welk boek kost me het meest aan advertenties?".

Hij kan alleen lezen. De assistent ziet wat de TrueRoyalties-API ziet — royalty's, advertentie-uitgaven, nettowinst, boeken, reeksen, Kindle Unlimited — en verandert niets in je account.

Wat de assistent kan zien

Alles wat de API ziet, en niets anders: royalty's, advertentie-uitgaven, nettowinst, boeken, reeksen, Kindle Unlimited-pagina's, gratis downloads.
Niets wat hij kan wijzigen: geen synchronisatie, geen instelling, geen boek, geen facturatie.
Je cijfers verlaten TrueRoyalties echt. Koppel alleen een assistent die je je verkoopgeschiedenis toevertrouwt: zodra hij je cijfers heeft gelezen, stopt ontkoppelen elk verder lezen, maar haalt het niet terug wat hij al gelezen heeft.

Het adres, en wat elke assistent nodig heeft

Eén adres, hetzelfde voor elke assistent:

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

Assistent	Wat hij nodig heeft
claude.ai, Claude Desktop	Je meldt je aan en klikt op Toestaan. Geen sleutel om te kopiëren.
ChatGPT	Dezelfde aanmelding, maar in ontwikkelaarsmodus, op een betaald abonnement.
Claude Code, Cursor, VS Code	Een van je API-sleutels, via Instellingen → API.

Elke andere tool die eigen MCP-servers ondersteunt, kan hetzelfde adres gebruiken.

Alles staat op één pagina in de app — Instellingen → API: het adres, de kant-en-klare commando's en je sleutels. Elk blok heeft een Kopiëren-knop.

De kaart Een AI-assistent koppelen in Instellingen → API, met het serveradres, het Claude Code-commando en de Cursor-configuratie, elk met een Kopiëren-knop

claude.ai

Open in claude.ai Customize in het linkermenu.

Het linkermenu van claude.ai, met Customize gemarkeerd onder New, Projects, Artifacts en Scheduled

Open het tabblad Connectors.

De pagina Customize in claude.ai, met de tabbladen Skills, Connectors en Plugins

Klik op Add en daarna op Add custom connector.

Het tabblad Connectors geselecteerd in claude.ai, met de Add-knop rechts

Noem hem TrueRoyalties, plak https://author.trueroyalties.com/api/mcp en klik op Continue.

Het venster Add custom connector in claude.ai, met de naam TrueRoyalties, het serveradres en de knoppen Cancel en Continue

Verander niets op de volgende pagina: claude.ai heeft gezien dat TrueRoyalties je laat aanmelden en een eigen identiteit publiceert. Klik op Add.

De tweede pagina van het venster: Authentication op Sign in now en OAuth client op Use Claude's published identity, beide gemarkeerd als Detected, met de knoppen Back en Add

Klik op Connect.

De connectorpagina van TrueRoyalties in claude.ai: het serveradres, de regel dat je nog niet gekoppeld bent, en de Connect-knop

Meld je aan bij TrueRoyalties als daarom wordt gevraagd.
Controleer welke app toegang vraagt en klik op Toestaan.

De toestemmingspagina van TrueRoyalties: Claude vraagt het account te lezen, geverifieerd als afkomstig van claude.ai, met wat het wel en niet kan, het account waarmee je bent aangemeld en de knoppen Weigeren en Toestaan

Je komt terug in claude.ai. Kies op de connectorpagina onder Tool permissions de optie Always allow: Claude leest je cijfers dan zonder het elke keer te vragen, en meer kan deze connector toch niet.

De connectorpagina van TrueRoyalties in claude.ai, met de tien alleen-lezen tools en het rechtenmenu open op Always allow

Zet de connector in een gesprek aan als de app daarom vraagt, en stel je vraag.

Vraag het Haiku. Dat is het snelste en goedkoopste Claude-model, en je cijfers lezen vraagt niet meer van hem. Kies het in het modelmenu van je gesprek.

Een gratis Claude-account kan één aangepaste connector toevoegen.

Om hem te ontkoppelen, open je in TrueRoyalties Instellingen → API → Gekoppelde apps en kies je Ontkoppelen. Hij leest je cijfers meteen niet meer.

De kaart Gekoppelde apps in Instellingen → API, met Claude van claude.ai, de koppeldatum, het laatste gebruik en het menu

Claude Desktop

Claude Desktop gebruikt dezelfde connectors als claude.ai, dus je hoeft niets extra's te installeren: voeg de connector toe vanuit een van beide, meld je aan en klik op Toestaan. Daarna werkt hij in allebei.

ChatGPT

ChatGPT koppelt niet zoals Claude: eigen servers zitten achter de ontwikkelaarsmodus, die alleen op de betaalde abonnementen wordt aangeboden. Dit is het hele pad.

Zet in de instellingen van ChatGPT de ontwikkelaarsmodus aan.
Open Plugins en dan New plugin.
Name: typ TrueRoyalties. Het pictogram en de beschrijving zijn optioneel.
Connection: laat Server URL staan en plak https://author.trueroyalties.com/api/mcp.
Authentication: kies OAuth. Daaronder hoef je niets in te vullen — TrueRoyalties publiceert zijn instellingen op dat adres en ChatGPT leest ze.
Vink I understand and want to continue aan — ChatGPT toont die waarschuwing voor elke eigen server, ook de onze — en klik op Create.

Het venster New Plugin van ChatGPT, met de naam TrueRoyalties, het serveradres van de TrueRoyalties MCP-server, OAuth als authenticatie en het vinkje dat je aanzet voor het aanmaken

ChatGPT opent TrueRoyalties: meld je aan als daarom wordt gevraagd, controleer dat de app die toegang vraagt ChatGPT is, en klik op Toestaan.
Zet de plugin in een gesprek aan voordat je je eerste vraag stelt.
Kies wat ChatGPT zelf mag doen, via Settings → Plugins → TrueRoyalties → Permissions. Allow read actions is genoeg: deze connector kan alleen lezen. Allow all actions staat als verhoogd risico en levert hier niets op.

De rechten voor de TrueRoyalties-plugin in ChatGPT: altijd vragen, lezen toestaan, acties met laag risico toestaan of alles toestaan

Om hem te ontkoppelen, open je in TrueRoyalties Instellingen → API → Gekoppelde apps en kies je Ontkoppelen, precies zoals bij claude.ai.

Claude Code

Maak een sleutel aan via Instellingen → API → Sleutel aanmaken, noem hem "Claude Code" en kopieer hem. Hij wordt maar één keer getoond.

Het tabblad API in Instellingen, met één sleutel, het begin van de sleutel, de aanmaakdatum en het laatste gebruik

Voer dit daarna uit in een terminal, met jouw sleutel in plaats van YOUR_API_KEY:

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

Controleer met claude mcp list, of /mcp in Claude Code.
De server wordt aan het huidige project toegevoegd. Voeg --scope user toe om hem overal te gebruiken.
Verwijderen: claude mcp remove trueroyalties.

Cursor

Zet je sleutel in de omgevingsvariabele TRUEROYALTIES_API_KEY en plak dit in ~/.cursor/mcp.json (al je projecten) of .cursor/mcp.json (één project):

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

Cursor leest de sleutel uit die variabele, dus het bestand bevat hem nooit. Stel de variabele in voordat je Cursor opent.

VS Code

Open MCP: Open User Configuration via het opdrachtenpalet (al je projecten), of maak .vscode/mcp.json in een project, en voeg toe:

{
  "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 vraagt de sleutel de eerste keer dat de server start en onthoudt hem, dus het bestand bevat hem nooit.

Wat je kunt vragen

De assistent kiest het juiste gereedschap voor je vraag. Elk gereedschap leest één deel van de API.

Gereedschap	Leest	Voorbeeldvraag
`get_account`	Je account: valuta, abonnement, gekoppelde platforms	"Zijn mijn platforms bij?"
`list_books`	Je catalogus	"Welke boeken heb ik?"
`list_series`	Je reeksen en hun boeken	"Wat zijn mijn reeksen?"
`get_summary`	De totalen van een periode	"Hoeveel heb ik vorige maand netto verdiend?"
`get_timeline`	Dezelfde cijfers in de tijd	"Hoe is mijn winst sinds januari gelopen?"
`get_books_report`	Eén regel per boek	"Welk boek kost me het meest aan advertenties?"
`get_marketplaces_report`	Eén regel per marketplace	"Waar verkoop ik het best?"
`get_kenp`	Gelezen Kindle Unlimited-pagina's	"Hoeveel KU-pagina's deze maand, en hoeveel dankzij advertenties?"
`get_free_units`	Gratis downloads	"Hoeveel gratis downloads leverde mijn actie op?"
`get_series_read_through`	Het doorlezen van een reeks	"Hoeveel lezers van deel 1 komen tot deel 3?"

Goed om te weten

Dezelfde cijfers als de app. Elk antwoord noemt de periode en de valuta die het gebruikte, en zegt het wanneer een cijfer onvolledig is.
Een sleutel leest je hele account. Houd hem uit gedeelde bestanden en trek hem in via Instellingen → API zodra je de assistent niet meer gebruikt.
Gedeelde limieten met de API: 60 verzoeken per minuut en 10.000 per dag voor je account. Eén vraag kan meerdere verzoeken kosten. Zie Limieten en fouten.
Probeer het zonder account in een ontwikkelaarstool: de openbare demosleutel uit de API-referentie werkt hier ook en leest de fictieve cijfers van het demo-account.

De API gebruiken vanuit Google Sheets Waarom mijn cijfers afwijken van Amazon