Collega un assistente IA

Un assistente IA può leggere i tuoi numeri e rispondere in linguaggio normale: «Quanto ho guadagnato netto il mese scorso?», «Quale libro mi costa di più in pubblicità?».

Può soltanto leggere. L'assistente vede quello che vede l'API di TrueRoyalties — royalty, spesa pubblicitaria, profitto netto, libri, serie, Kindle Unlimited — e non modifica nulla nel tuo account.

Cosa può vedere l'assistente

• Tutto quello che vede l'API, e nient'altro: royalty, spesa pubblicitaria, profitto netto, libri, serie, pagine Kindle Unlimited, download gratuiti.
• Niente che possa modificare: nessuna sincronizzazione, nessuna impostazione, nessun libro, nessuna fatturazione.
• I tuoi numeri escono davvero da TrueRoyalties. Collega solo un assistente a cui affidi il tuo storico di vendite: una volta letti i tuoi numeri, scollegarlo ferma le letture successive, ma non riprende quello che ha già letto.

L'indirizzo, e cosa serve a ogni assistente

Un solo indirizzo, lo stesso per tutti gli assistenti:

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

Qualsiasi altro strumento che supporta server MCP personalizzati può usare lo stesso indirizzo.

È tutto in una sola pagina nell'app — Impostazioni → API: l'indirizzo, i comandi pronti da incollare e le tue chiavi. Ogni blocco ha un pulsante Copia.

claude.ai

1. In claude.ai, apri Customize nel menu di sinistra.

2. Apri la scheda Connectors.

3. Fai clic su Add, poi su Add custom connector.

4. Chiamalo TrueRoyalties, incolla https://author.trueroyalties.com/api/mcp e fai clic su Continue.

5. Non toccare nulla nella pagina successiva: claude.ai ha rilevato che TrueRoyalties ti fa accedere e pubblica la propria identità. Fai clic su Add.

6. Fai clic su Connect.

7. Accedi a TrueRoyalties se ti viene chiesto.
8. Controlla quale app chiede l'accesso, poi fai clic su Consenti.

9. Torni in claude.ai. Nella pagina del connettore, sotto Tool permissions, scegli Always allow: Claude legge così i tuoi numeri senza chiedertelo ogni volta, e questo connettore non sa fare altro.

In una conversazione attiva il connettore se l'app te lo chiede, poi fai la tua domanda.

Chiedi a Haiku. È il modello Claude più veloce ed economico, e leggere i tuoi numeri non gli chiede altro. Sceglilo nel menu dei modelli della conversazione.

Un account Claude gratuito può aggiungere un connettore personalizzato.

Per scollegarlo, apri Impostazioni → API → App collegate in TrueRoyalties e scegli Scollega. Smette subito di leggere i tuoi numeri.

Claude Desktop

Claude Desktop usa gli stessi connettori di claude.ai, quindi non c'è altro da installare: aggiungi il connettore da uno dei due, accedi e fai clic su Consenti. Dopo funziona in entrambi.

ChatGPT

ChatGPT non si collega come Claude: i suoi server personalizzati stanno dietro la modalità sviluppatore, offerta solo sui piani a pagamento. Ecco il percorso completo.

1. Nelle impostazioni di ChatGPT, attiva la modalità sviluppatore.
2. Apri Plugins, poi New plugin.
3. Name: scrivi TrueRoyalties. L'icona e la descrizione sono facoltative.
4. Connection: lascia Server URL e incolla https://author.trueroyalties.com/api/mcp.
5. Authentication: scegli OAuth. Sotto non c'è nulla da compilare — TrueRoyalties pubblica le sue impostazioni a quell'indirizzo e ChatGPT le legge.
6. Spunta I understand and want to continue — ChatGPT mostra quell'avviso per ogni server personalizzato, compreso il nostro — poi fai clic su Create.

7. ChatGPT apre TrueRoyalties: accedi se ti viene chiesto, controlla che l'app che chiede l'accesso sia ChatGPT, poi fai clic su Consenti.
8. In una conversazione, attiva il plugin prima della tua prima domanda.
9. Scegli cosa può fare ChatGPT da solo, in Settings → Plugins → TrueRoyalties → Permissions. Allow read actions basta: questo connettore sa solo leggere. Allow all actions è segnalato come rischio elevato e qui non serve a nulla.

Per scollegarlo, apri Impostazioni → API → App collegate in TrueRoyalties e scegli Scollega, esattamente come per claude.ai.

Claude Code

Crea una chiave in Impostazioni → API → Crea una chiave, chiamala «Claude Code» e copiala. Viene mostrata una sola volta.

Poi lancia questo in un terminale, con la tua chiave al posto di YOUR_API_KEY:

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

• Controlla con claude mcp list, o /mcp dentro Claude Code.
• Il server viene aggiunto al progetto corrente. Aggiungi --scope user per usarlo ovunque.
• Per rimuoverlo: claude mcp remove trueroyalties.

Cursor

Metti la tua chiave nella variabile d'ambiente TRUEROYALTIES_API_KEY, poi incolla questo in ~/.cursor/mcp.json (tutti i progetti) o .cursor/mcp.json (un progetto):

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

Cursor legge la chiave da quella variabile, quindi il file non la contiene mai. Imposta la variabile prima di aprire Cursor.

VS Code

Apri MCP: Open User Configuration dalla palette dei comandi (tutti i progetti), o crea .vscode/mcp.json in un progetto, e aggiungi:

{
  "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 chiede la chiave al primo avvio del server e la ricorda, quindi il file non la contiene mai.

Cosa puoi chiedere

L'assistente sceglie lo strumento giusto per la tua domanda. Ogni strumento legge una parte dell'API.

Buono a sapersi

• Gli stessi numeri dell'app. Ogni risposta indica il periodo e la valuta usati, e segnala quando un numero è incompleto.
• Una chiave legge tutto il tuo account. Tienila fuori dai file condivisi e revocala in Impostazioni → API il giorno in cui smetti di usare l'assistente.
• Limiti condivisi con l'API: 60 richieste al minuto e 10.000 al giorno per il tuo account. Una domanda può costare più richieste. Vedi Limiti ed errori.
• Provalo senza account in uno strumento per sviluppatori: la chiave demo pubblica del riferimento dell'API funziona anche qui e legge i numeri fittizi dell'account demo.