# Conector para asistentes

Conecta ChatGPT, Claude o Meta Muse a tu biblioteca de Reading Journey y pídele que agregue libros, los marque como terminados, los califique o planee tus Próximas lecturas. Configurarlo toma unos dos minutos y el conector es gratis.

Dirección del servidor: `https://mcp.readingjourney.app`

## Antes de empezar

- Una cuenta de Reading Journey. Puedes iniciar sesión con Apple, Google o correo y contraseña, o crear una cuenta durante la configuración.
- Usa el mismo método de inicio de sesión que en la app, para que el asistente se conecte a tu biblioteca de siempre.
- **Claude** (web, apps de escritorio y móviles), ChatGPT o **Meta Muse**.
- No necesitas RJ+, y tampoco necesitas tener la app instalada para conectarte.

## Conectar Claude

Reading Journey aparece en el directorio de conectores de Claude, así que no tienes que pegar nada.

1. Abre [Reading Journey en el directorio de Claude](https://claude.ai/directory/reading-journey) y haz clic en **Connect to Claude**.
2. En la página de Reading Journey, elige **Continuar con Apple** o **Continuar con Google**, o inicia sesión con tu correo y contraseña.
3. Revisa lo que Claude podrá hacer y haz clic en **Permitir**. Eso te lleva de vuelta a Claude.
4. En un chat, abre el menú **+**, elige **Connectors** y asegúrate de que Reading Journey esté activado. Luego, pide lo que quieras.

En los planes Team y Enterprise, primero un propietario activa el conector en **Organization settings > Connectors**; después, cada miembro se conecta con su propia cuenta de Reading Journey. Una vez conectado en la web, también funciona en las apps móviles de Claude.

## Conectar Meta Muse

1. En Muse, abre **Settings > Connectors**.
2. Elige **Add custom connector** y pega `https://mcp.readingjourney.app`.
3. En la página de Reading Journey, inicia sesión igual que en la app, revisa los permisos y elige **Permitir**.

Los menús de Muse pueden cambiar de una versión a otra; si no encuentras Connectors, consulta la ayuda de Meta sobre conectores personalizados.

## Pruébalo

Abre un chat nuevo y pide, por ejemplo:

- “Agrega Piranesi de Susanna Clarke a mi Reading Journey como Quiero leer y ponlo en Próximas lecturas.”
- “¿Qué tengo en Próximas lecturas? Cambia el tercero por La mano izquierda de la oscuridad.”
- “Ayer terminé Mañana, y mañana, y mañana. Márcalo como terminado y ponle 4,5 estrellas.”
- “Crea una colección llamada Club de lectura 2026 y agrega todos los libros de Quiero leer de autores japoneses.”
- “¿Qué libros estoy leyendo ahora y cuáles tengo en pausa?”
- “Voy a abandonar La broma infinita. Márcalo como Sin terminar.”
- “Recomiéndame tres novelas de cozy fantasy que todavía no tenga y agrega la que elija.”

Después abre Reading Journey y ahí estarán tus cambios. Si la app ya está abierta, sal de ella y vuelve a entrar para sincronizar.

## Lo que un asistente puede y no puede hacer

| Puede | No puede |
| --- | --- |
| Ver y cambiar tus libros, estados, calificaciones, colecciones, Próximas lecturas, notas, reseñas y entradas del diario | Ver tus fotos o tus ubicaciones exactas |
| Agregar libros, cambiar su estado, calificarlos, registrar tu avance y ponerte metas | Eliminar una colección, una meta, una lectura o un libro con historial de lectura sin preguntarte antes |
| Gestionar Próximas lecturas y tu Top 4, crear y llenar colecciones, agregar fotos cuando se lo pides | Cambiar tu cuenta, tu suscripción o tus ajustes |

La página de permisos que ves al conectarte dice lo mismo: el asistente puede leer y cambiar tus notas, reseñas y entradas del diario, y puede agregar, reemplazar o quitar fotos cuando se lo pides, pero nunca puede verlas. ¿Te conectaste antes del 1 de noviembre de 2026? Vuelve a conectarte para darle este acceso.

## Referencia de herramientas

Tú nunca usas las herramientas directamente: pides lo que quieres con tus propias palabras y el asistente elige una. Cada herramienta funciona solo con tu propia biblioteca.

| Herramienta | Tipo | Qué hace |
| --- | --- | --- |
| `list_books` | Lectura | Muestra tus libros con su estado, calificación, Próximas lecturas y colecciones; puede filtrar por estado, colección o palabras |
| `get_book` | Lectura | Un libro con las fechas de cada lectura, tu calificación, sus colecciones y su posición en Próximas lecturas |
| `list_collections` | Lectura | Tus colecciones y cuántos libros tiene cada una |
| `get_next_up` | Lectura | Tus Próximas lecturas en orden |
| `add_book` | Escritura | Agrega un libro (como Quiero leer, por defecto); nunca duplica uno que ya tienes |
| `set_status` | Escritura | Empieza, pausa, termina o abandona un libro, o lo marca como Quiero leer |
| `rate_book` | Escritura | Califica la lectura actual de 0,25 a 5 estrellas, o borra la calificación |
| `set_next_up` | Escritura | Pone un libro que no has empezado en Próximas lecturas |
| `remove_from_next_up` | Escritura | Saca un libro de Próximas lecturas |
| `create_collection` | Escritura | Crea una colección |
| `add_to_collection` | Escritura | Pone un libro en una colección |
| `remove_from_collection` | Escritura, pregunta antes | Saca un libro de una colección; el libro se queda en tu biblioteca |
| `remove_book` | Escritura, pregunta antes | Elimina un libro que solo agregaste; nunca uno con historial de lectura, calificación, entrada del diario, avance, lugar en el Top 4, nota o foto de portada |

Para desarrolladores: los scopes de OAuth son `mcp` (leer y cambiar; lo que concede Permitir), `library:read` y `library:write`. Una conexión sigue con la sesión iniciada mientras la uses; después de 60 días sin usarla, vuelve a conectarte.

## Límites y seguridad

- Antes de eliminar un libro o sacarlo de una colección, el asistente tiene instrucciones de preguntarte.
- Si cambias algo en tu teléfono, tu cambio tiene prioridad sobre el del asistente.
- Los asistentes tienen instrucciones de no seguir nunca órdenes escritas dentro de títulos de libros, nombres de autores o nombres de colecciones.
- Cada conexión puede leer tu biblioteca 60 veces por minuto y cambiarla 30 veces por minuto.
- El conector no cuenta como dispositivo, así que no afecta la sincronización de la cuenta gratuita.

## Desconectar

Quita el conector desde el asistente: en Claude, ve a **Customize > Connectors**, selecciona Reading Journey y elige **Remove**; en Muse, ve a **Settings > Connectors**. Si eliminas tu cuenta de Reading Journey, se desconectan todos los asistentes. Cerrar sesión en la app no los desconecta.

## Solución de problemas

| Lo que ves | Qué hacer |
| --- | --- |
| “Ese correo electrónico y esa contraseña no coinciden con ninguna cuenta.” | Revisa que no haya errores de escritura o restablece tu contraseña en la app con **¿Olvidaste tu contraseña?**. Si en la app usas Apple o Google, elige **Continuar con Apple** o **Continuar con Google**. |
| El asistente ve una biblioteca vacía | Iniciaste sesión con un método distinto al de la app. Desconéctalo, vuelve a conectarlo y usa el mismo método. |
| “Primero confirma tu correo electrónico y luego inicia sesión.” | Abre el correo de confirmación que te enviamos y vuelve a iniciar sesión. |
| “Esta página caducó.” | Vuelve al asistente y conecta Reading Journey otra vez. |
| El proveedor rechazó el registro de la app | Ese asistente todavía no es compatible. Claude, ChatGPT y Meta Muse sí lo son. |
| Los cambios no aparecen en la app | Asegúrate de que la app tenga la sesión iniciada en la misma cuenta, luego sal de ella y vuelve a entrar. Con una cuenta gratuita, los cambios llegan al dispositivo que sincroniza. |
| “…solo se puede eliminar en la app Reading Journey.” | El libro tiene historial de lectura; elimínalo desde la página del libro en la app. |
