Conectar un asistente
Añade el servidor MCP a tu cliente de IA, elige a qué puede llegar entre los cinco grupos de permisos y revócalo cuando termines.
Abre la página de MCP en la aplicación web de Read Frog. Muestra la dirección del servidor, los pasos de configuración de cada cliente y todos los clientes que ya has autorizado.
La dirección del servidor es la misma para todo el mundo:
https://api.readfrog.app/api/mcpRead Frog está disponible en los directorios de ChatGPT y Claude. Añádelo desde allí o conecta otro cliente MCP con la dirección del servidor.
Añadir el servidor
Para otros clientes MCP, añade la dirección anterior con Streamable HTTP. La página MCP incluye los comandos de Codex y Claude Code.
Elige autorización OAuth 2.1. Se admiten tanto el registro dinámico de clientes como los
documentos de metadatos de client ID, así que no hay ningún client ID ni secreto que introducir.
Los clientes que insisten en un documento de descubrimiento pueden leerlo en
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp.
El cliente te manda a la página de consentimiento de Read Frog. Inicia sesión, comprueba el nombre y el identificador de la aplicación que se muestran allí, elige un nivel para cada grupo de permisos que haya pedido y pulsa Permitir.
En un espacio de trabajo administrado, puede que un administrador deba habilitar el plugin. En Team y Enterprise, puede que tu organización deba habilitar primero el conector.
Read Frog funciona con todos los planes: las cuentas gratuitas pueden ejecutar 10 herramientas al día, las Pro 50, y Ultra no tiene límite (consulta los límites diarios). Una cuenta que ha agotado sus llamadas sigue conectada, y sus herramientas se niegan con un mensaje que indica cuándo vuelve a haber llamadas; reconectar no reinicia el recuento.
Los cinco grupos de permisos
Hay exactamente cinco grupos. account es de solo lectura; los otros cuatro se pueden poner en sin acceso, lectura, o lectura y escritura. Eliges por grupo, y solo entre los grupos que el cliente haya pedido.
| Grupo | Con lectura, el asistente puede ver | Con escritura puede además |
|---|---|---|
account | Tu nombre, tu correo electrónico y tu foto de perfil. Nunca el contenido de las notas. | Nada: este grupo no tiene nivel de escritura. |
notebases | Tus Notebases y las definiciones de sus campos, incluidos los IDs de campo. | Crear, renombrar y eliminar Notebases; añadir, cambiar y eliminar campos. |
notes | Los valores de los campos de todas las notas, y buscar entre ellos. | Crear, editar y eliminar notas. |
card_templates | Los patrones de anverso y reverso que generan las tarjetas. | Crear, editar y eliminar plantillas. |
study | Historial de repaso, estado de programación, recuentos de cola y límites diarios. | Registrar y deshacer repasos, cambiar límites diarios, suspender y omitir tarjetas, poner Notebases en reposo. |
Dos herramientas están a caballo entre grupos. Leer una tarjeta renderizada —su anverso, su reverso, su estado de aprendizaje— necesita notes:read y study:read juntos, porque una tarjeta es contenido de nota más estado de programación. Conceder solo uno de los dos deja list_cards y get_card fuera de alcance.
Qué puede destruir un permiso de escritura
Escritura no es solo «puede añadir cosas». El nivel de escritura de cada grupo incluye la eliminación, y la eliminación en un Notebase va en cascada.
| Si concedes | En el peor de los casos |
|---|---|
notes:write | Una nota se elimina de forma permanente, junto con todas las tarjetas generadas a partir de ella y los registros de repaso de esas tarjetas. |
notebases:write | Un Notebase entero se elimina de forma permanente: sus campos, todas sus notas, sus plantillas, sus tarjetas y todo su historial de repaso. |
card_templates:write | Se elimina una plantilla y, con ella, todas las tarjetas que generó y sus registros de repaso. Las notas de origen sobreviven. |
study:write | Se registra un repaso que no has hecho. FSRS lo toma como real, así que la estabilidad, la dificultad y la próxima fecha de la tarjeta se mueven. |
Nada de esto se puede revertir desde Read Frog. undo_review deshace el último repaso de una tarjeta, pero no hay ningún deshacer para una nota, un campo, una plantilla o un Notebase eliminados.
Concede primero lectura. El acceso de solo lectura ya cubre consultar cosas, planificar qué repasar e informar de tu progreso, y no puede perder nada. Sube un grupo a escritura solo cuando tengas una receta concreta que lo necesite, y lee lo que propone tu asistente antes de aprobar cualquier eliminación.
Añadir permisos más adelante
Una concesión solo contiene lo que pidió una solicitud de autorización concreta, al nivel que eligieras para ella. Si una herramienta falla porque la conexión le falta un permiso, se le indica al cliente cuál necesita; muchos clientes te mandan entonces otra vez al consentimiento por su cuenta, y algunos hay que reconectarlos a mano antes de que vuelvan a pedirlo.
Al revés también funciona: autoriza otra vez y baja un grupo. La página de consentimiento solo puede bajar los grupos que mencione la nueva solicitud, así que un grupo que el cliente ya no pide se queda como estaba. Para borrarlo todo de golpe, revoca la conexión.
Gestionar y revocar
La página de MCP enumera cada cliente conectado con el nombre con el que se registró, su identificador de aplicación, cuándo lo conectaste, cuándo autorizó por última vez y los permisos que tiene ahora mismo.
Revocar elimina los permisos de ese cliente e invalida su acceso al instante. Su token de refresco se va con la concesión, así que la siguiente vez que intente reconectarse acabará de nuevo en la página de consentimiento, donde vuelves a decidir. Puedes reconectar el mismo cliente más adelante; una concesión nueva empieza de cero.
Revocar no llega hacia atrás. El contenido que un servicio ya recibió se queda con ese servicio; consulta la Política de privacidad para saber cómo trata Read Frog los datos. Quitar el conector dentro del asistente también vale la pena, pero por sí solo no revoca la concesión en el lado de Read Frog.
Cuando algo no funciona
- Una herramienta dice que necesita más permisos. Autoriza ese grupo, o déjalo denegado y quédate dentro de las operaciones que permitiste. Reconecta el cliente si no vuelve a pedirlo por sí mismo.
- Todas las herramientas rechazan con un mensaje sobre las llamadas diarias. La cuenta ha agotado sus llamadas del día. El mensaje indica cuándo vuelve a haber más.
- Las herramientas nuevas no aparecen. Actualiza o reconecta el conector; los clientes guardan en caché la lista de herramientas.
- Una escritura falla diciendo que la nota cambió. Las ediciones están protegidas contra datos obsoletos. Pídele al asistente que vuelva a leer la nota y lo reintente.
- Un repaso falla pidiendo una zona horaria. Registrar un repaso decide a qué día de estudio pertenece, así que no lo adivina. Dile al asistente tu zona horaria IANA, o abre la aplicación web de Read Frog una vez con la sesión iniciada para que tu cuenta la guarde.
Si te quedas atascado, escríbenos.
MCP
Deja que un asistente de IA lea y escriba tus propios Notebases, notas, plantillas de tarjeta e historial de repaso a través de una conexión MCP remota.
Recetas
Cosas que vale la pena pedirle a un asistente con tus notas y tarjetas, cada una con el prompt que escribir, las herramientas que usa y el permiso que necesita.