Connecter un assistant IA

Un assistant IA peut lire tes chiffres et te répondre en langage courant : « Combien j'ai gagné net le mois dernier ? », « Quel livre me coûte le plus en pub ? ».

Il peut seulement lire. L'assistant voit ce que voit l'API TrueRoyalties — royalties, dépenses pub, bénéfice net, livres, séries, Kindle Unlimited — et ne modifie rien dans ton compte.

Ce que l'assistant peut voir

• Tout ce que voit l'API, et rien d'autre : royalties, dépenses pub, bénéfice net, livres, séries, pages Kindle Unlimited, téléchargements gratuits.
• Rien qu'il puisse modifier : aucune synchro, aucun réglage, aucun livre, aucune facturation.
• Tes chiffres sortent bien de TrueRoyalties. Ne connecte qu'un assistant à qui tu confies ton historique de ventes : une fois qu'il a lu tes chiffres, le déconnecter arrête les lectures suivantes, mais ne reprend pas ce qu'il a déjà lu.

L'adresse, et ce qu'il faut à chaque assistant

Une seule adresse, la même pour tous les assistants :

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

Tout autre outil qui gère les serveurs MCP personnalisés peut utiliser la même adresse.

Tout est sur une seule page dans l'app — Réglages → API : l'adresse, les commandes prêtes à coller et tes clés. Chaque bloc a un bouton Copier.

claude.ai

1. Dans claude.ai, ouvre Customize dans le menu de gauche.

2. Ouvre l'onglet Connectors.

3. Clique sur Add, puis sur Add custom connector.

4. Donne-lui le nom TrueRoyalties, colle https://author.trueroyalties.com/api/mcp, puis clique sur Continue.

5. Ne touche à rien sur la page suivante : claude.ai a détecté que TrueRoyalties te fait te connecter et publie sa propre identité. Clique sur Add.

6. Clique sur Connect.

7. Connecte-toi à TrueRoyalties si on te le demande.
8. Vérifie quelle application demande l'accès, puis clique sur Autoriser.

9. Tu reviens dans claude.ai. Sur la page du connecteur, sous Tool permissions, choisis Always allow : Claude lit alors tes chiffres sans te redemander à chaque fois, et ce connecteur ne sait rien faire d'autre.

Dans une conversation, active le connecteur si l'application te le demande, puis pose ta question.

Demande à Haiku. C'est le modèle Claude le plus rapide et le moins cher, et lire tes chiffres ne lui demande rien de plus. Choisis-le dans le menu des modèles de ta conversation.

Un compte Claude gratuit peut ajouter un connecteur personnalisé.

Pour le déconnecter, ouvre Réglages → API → Applications connectées dans TrueRoyalties et choisis Déconnecter. Il cesse immédiatement de lire tes chiffres.

Claude Desktop

Claude Desktop utilise les mêmes connecteurs que claude.ai : rien d'autre à installer. Ajoute le connecteur depuis l'un ou l'autre, connecte-toi et clique sur Autoriser. Il fonctionne ensuite dans les deux.

ChatGPT

ChatGPT ne se connecte pas comme Claude : ses serveurs personnalisés sont derrière le mode développeur, proposé uniquement sur ses offres payantes. Voici le chemin complet.

1. Dans les réglages de ChatGPT, active le mode développeur.
2. Ouvre Plugins, puis New plugin.
3. Name : tape TrueRoyalties. L'icône et la description sont facultatives.
4. Connection : garde Server URL et colle https://author.trueroyalties.com/api/mcp.
5. Authentication : choisis OAuth. Rien à remplir en dessous — TrueRoyalties publie ses réglages à cette adresse, et ChatGPT les lit.
6. Coche I understand and want to continue — ChatGPT affiche cet avertissement pour tout serveur personnalisé, le nôtre compris — puis clique sur Create.

7. ChatGPT ouvre TrueRoyalties : connecte-toi si on te le demande, vérifie que l'application qui demande l'accès est bien ChatGPT, puis clique sur Autoriser.
8. Dans une conversation, active le plugin avant ta première question.
9. Choisis ce que ChatGPT peut faire seul, dans Settings → Plugins → TrueRoyalties → Permissions. Allow read actions suffit : ce connecteur ne sait que lire. Allow all actions est signalé comme risque élevé et n'apporte rien ici.

Pour le déconnecter, ouvre Réglages → API → Applications connectées dans TrueRoyalties et choisis Déconnecter, exactement comme pour claude.ai.

Claude Code

Crée une clé dans Réglages → API → Créer une clé, nomme-la « Claude Code » et copie-la. Elle n'est affichée qu'une seule fois.

Lance ensuite ceci dans un terminal, avec ta clé à la place de YOUR_API_KEY :

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

• Vérifie avec claude mcp list, ou /mcp dans Claude Code.
• Le serveur est ajouté au projet courant. Ajoute --scope user pour l'utiliser partout.
• Pour le retirer : claude mcp remove trueroyalties.

Cursor

Mets ta clé dans la variable d'environnement TRUEROYALTIES_API_KEY, puis colle ceci dans ~/.cursor/mcp.json (tous tes projets) ou .cursor/mcp.json (un seul projet) :

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

Cursor lit la clé dans cette variable : le fichier ne la contient jamais. Définis la variable avant d'ouvrir Cursor.

VS Code

Ouvre MCP: Open User Configuration depuis la palette de commandes (tous tes projets), ou crée .vscode/mcp.json dans un projet, et ajoute :

{
  "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 demande la clé au premier démarrage du serveur et la retient : le fichier ne la contient jamais.

Ce que tu peux demander

L'assistant choisit l'outil qui convient à ta question. Chaque outil lit une partie de l'API.

Bon à savoir

• Les mêmes chiffres que l'app. Chaque réponse précise la période et la devise utilisées, et signale un chiffre incomplet.
• Une clé lit tout ton compte. Garde-la hors des fichiers partagés, et révoque-la dans Réglages → API le jour où tu arrêtes d'utiliser l'assistant.
• Limites partagées avec l'API : 60 requêtes par minute et 10 000 par jour pour ton compte. Une question peut coûter plusieurs requêtes. Voir Limites et erreurs.
• Essaie sans compte dans un outil de développement : la clé de démo publique de la référence de l'API marche aussi, et lit les chiffres fictifs du compte démo.