Conectar un asistente de IA

Un asistente de IA puede leer tus cifras y responder en lenguaje normal: «¿Cuánto gané neto el mes pasado?», «¿Qué libro me cuesta más en anuncios?».

Solo puede leer. El asistente ve lo que ve la API de TrueRoyalties — regalías, gasto en anuncios, beneficio neto, libros, series, Kindle Unlimited — y no cambia nada en tu cuenta.

Lo que el asistente puede ver

• Todo lo que ve la API, y nada más: regalías, gasto en anuncios, beneficio neto, libros, series, páginas de Kindle Unlimited, descargas gratuitas.
• Nada que pueda cambiar: ninguna sincronización, ningún ajuste, ningún libro, ninguna facturación.
• Tus cifras sí salen de TrueRoyalties. Conecta solo un asistente al que confíes tu historial de ventas: una vez que ha leído tus cifras, desconectarlo impide nuevas lecturas, pero no recupera lo que ya leyó.

La dirección, y lo que necesita cada asistente

Una sola dirección, la misma para todos los asistentes:

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

Cualquier otra herramienta compatible con servidores MCP personalizados puede usar la misma dirección.

Todo está en una sola página de la app — Ajustes → API: la dirección, los comandos listos para pegar y tus claves. Cada bloque tiene un botón Copiar.

claude.ai

1. En claude.ai, abre Customize en el menú izquierdo.

2. Abre la pestaña Connectors.

3. Haz clic en Add y después en Add custom connector.

4. Ponle el nombre TrueRoyalties, pega https://author.trueroyalties.com/api/mcp y haz clic en Continue.

5. No cambies nada en la página siguiente: claude.ai ha detectado que TrueRoyalties te hace iniciar sesión y publica su propia identidad. Haz clic en Add.

6. Haz clic en Connect.

7. Inicia sesión en TrueRoyalties si te lo pide.
8. Comprueba qué aplicación pide acceso y haz clic en Permitir.

9. Vuelves a claude.ai. En la página del conector, en Tool permissions, elige Always allow: Claude leerá tus cifras sin preguntártelo cada vez, y este conector no sabe hacer nada más.

En una conversación, activa el conector si la aplicación te lo pide y haz tu pregunta.

Pregunta a Haiku. Es el modelo de Claude más rápido y más barato, y leer tus cifras no le exige más. Elígelo en el menú de modelos de tu conversación.

Una cuenta gratuita de Claude puede añadir un conector personalizado.

Para desconectarlo, abre Ajustes → API → Aplicaciones conectadas en TrueRoyalties y elige Desconectar. Deja de leer tus cifras al instante.

Claude Desktop

Claude Desktop usa los mismos conectores que claude.ai, así que no hay nada más que instalar: añade el conector desde cualquiera de los dos, inicia sesión y haz clic en Permitir. Después funciona en ambos.

ChatGPT

ChatGPT no se conecta como Claude: sus servidores personalizados están detrás del modo desarrollador, que solo se ofrece en sus planes de pago. Este es el camino completo.

1. En los ajustes de ChatGPT, activa el modo desarrollador.
2. Abre Plugins y luego New plugin.
3. Name: escribe TrueRoyalties. El icono y la descripción son opcionales.
4. Connection: deja Server URL y pega https://author.trueroyalties.com/api/mcp.
5. Authentication: elige OAuth. No hay nada que rellenar debajo — TrueRoyalties publica sus ajustes en esa dirección y ChatGPT los lee.
6. Marca I understand and want to continue — ChatGPT muestra ese aviso para cualquier servidor personalizado, incluido el nuestro — y haz clic en Create.

7. ChatGPT abre TrueRoyalties: inicia sesión si te lo pide, comprueba que la aplicación que pide acceso es ChatGPT y haz clic en Permitir.
8. En una conversación, activa el plugin antes de tu primera pregunta.
9. Elige qué puede hacer ChatGPT por su cuenta, en Settings → Plugins → TrueRoyalties → Permissions. Con Allow read actions basta: este conector solo puede leer. Allow all actions está marcado como riesgo elevado y aquí no aporta nada.

Para desconectarlo, abre Ajustes → API → Aplicaciones conectadas en TrueRoyalties y elige Desconectar, igual que con claude.ai.

Claude Code

Crea una clave en Ajustes → API → Crear una clave, ponle el nombre «Claude Code» y cópiala. Se muestra una sola vez.

Luego ejecuta esto en un terminal, con tu clave en lugar de YOUR_API_KEY:

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

• Compruébalo con claude mcp list, o /mcp dentro de Claude Code.
• El servidor se añade al proyecto actual. Añade --scope user para usarlo en todas partes.
• Para quitarlo: claude mcp remove trueroyalties.

Cursor

Pon tu clave en la variable de entorno TRUEROYALTIES_API_KEY y pega esto en ~/.cursor/mcp.json (todos tus proyectos) o .cursor/mcp.json (un proyecto):

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

Cursor lee la clave de esa variable, así que el archivo nunca la contiene. Define la variable antes de abrir Cursor.

VS Code

Abre MCP: Open User Configuration desde la paleta de comandos (todos tus proyectos), o crea .vscode/mcp.json en un proyecto, y añade:

{
  "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 pide la clave la primera vez que arranca el servidor y la recuerda, así que el archivo nunca la contiene.

Qué puedes preguntar

El asistente elige la herramienta adecuada para tu pregunta. Cada herramienta lee una parte de la API.

Bueno saberlo

• Las mismas cifras que la app. Cada respuesta indica el periodo y la moneda que ha usado, y avisa cuando una cifra está incompleta.
• Una clave lee toda tu cuenta. Mantenla fuera de archivos compartidos y revócala en Ajustes → API el día que dejes de usar el asistente.
• Límites compartidos con la API: 60 peticiones por minuto y 10.000 al día para tu cuenta. Una pregunta puede costar varias peticiones. Consulta Límites y errores.
• Pruébalo sin cuenta en una herramienta para desarrolladores: la clave de demo pública de la referencia de la API también funciona aquí y lee las cifras ficticias de la cuenta demo.