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/mcpLo único que cambia de un cliente a otro es dónde pegas esa dirección y qué te exige el cliente antes de dejarte.
Añadir el servidor
Añade un servidor MCP remoto en la dirección de arriba, por Streamable HTTP. En ChatGPT eso está en Settings → Plugins con el modo de desarrollador activado; en Claude, en Settings → Connectors → Add custom connector. Codex y Claude Code se configuran con un solo comando, que aparece en la página de MCP.
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.
Algunos clientes ponen los conectores personalizados detrás de su propio plan. ChatGPT necesita un plan de pago; una cuenta personal de Claude necesita Pro o Max, y en Team o Enterprise es un propietario quien añade el conector en los ajustes de la organización. Codex y Claude Code no tienen esa restricción.
El requisito de Read Frog es el plan Ultra. Una conexión desde una cuenta que no lo tenga completa la autorización y después rechaza cada llamada a una herramienta con una explicación; volver a iniciar sesión no cambia eso, porque ninguna concesión de permisos cambia una suscripción.
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. |
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.
- Todo se conecta pero todas las herramientas rechazan con un mensaje de plan. La cuenta no está en Ultra.
- 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.