Conectar un Cliente MCP

Becoming ejecuta un servidor MCP (Protocolo de Contexto de Modelo) para que cualquier herramienta de IA compatible — Claude Desktop, Cursor, clientes tipo ChatGPT — pueda trabajar con tu biblioteca de Becoming durante una conversación. Puede buscar en tus subrayados, navegar tus fuentes, leer tus notas, guardar nuevos pasajes y agregar libros y enlaces a tu biblioteca. En La Academia, además puede generar áreas de interés y completar prácticas por ti.

La autenticación usa OAuth 2.1: haces clic en “Conectar Becoming” dentro de la herramienta de IA, inicias sesión una vez, apruebas los permisos y listo. No hay tokens que copiar ni pegar.

Qué incluye el acceso MCP

Por defecto, un asistente de IA puede leer de tu biblioteca:

• Buscar tus subrayados (texto completo + semántico, híbrido por defecto)
• Listar y filtrar tus fuentes (libros, artículos, videos, podcasts)
• Abrir una fuente individual con sus subrayados
• Abrir un subrayado con la metadata de su fuente
• Leer tu colección de notas

Con el permiso de Agregar subrayados (highlights:write), también puede guardar nuevos pasajes en tu biblioteca, y con Agregar fuentes (sources:write) puede agregar libros y enlaces — los videos de YouTube importan su transcripción y las demás páginas se guardan como artículos legibles. Ambos funcionan en cualquier plan de pago.

En La Academia, el acceso de escritura se extiende a las áreas de interés y prácticas, para que un asistente te ayude a actuar sobre lo que leíste:

• Iniciar la generación de un área de interés y convertirla en un área activa
• Generar las prácticas diarias de un área de interés
• Marcar prácticas como hechas u omitirlas, y registrar reflexiones
• Finalizar un área de interés

El acceso de escritura nunca es automático. Otorgas los permisos de escritura correspondientes en la pantalla de autorización y, aun así, el asistente debe confirmar cada escritura de forma explícita antes de que ocurra — nada cambia en tu biblioteca en silencio.

Nota

Leer y agregar subrayados y fuentes funciona en cualquier plan de pago. Generar áreas de interés y completar prácticas requiere La Academia.

Antes de empezar

• Una cuenta activa de Becoming (cualquier plan de pago o prueba de la biblioteca) y una sesión de navegador abierta.
• Un cliente compatible con MCP. Ejemplos:
  • Claude Desktop
  • Cursor
  • ChatGPT (conectores personalizados)

Conectar un cliente

La interfaz exacta varía según la herramienta, pero los pasos son los mismos:

1. En tu herramienta de IA, abre Agregar servidor MCP (a veces llamado “Conectar herramienta” o “Agregar conector”).

2. Pega la URL del servidor MCP de Becoming (la herramienta descubre el resto automáticamente):

   https://mcp.usebecoming.com/mcp

3. La herramienta abrirá una ventana del navegador para iniciar sesión.

4. Inicia sesión en Becoming si aún no lo estás.

5. Revisa la pantalla de autorización en app.usebecoming.com/oauth/consent — muestra qué aplicación pide acceso y qué permisos solicita.

6. Haz clic en Permitir.

7. El navegador te devolverá a la herramienta con la conexión activa.

Eso es todo. Prueba una consulta como “¿Qué subrayé sobre resiliencia?” — la herramienta debería entrar a tu biblioteca y responder con pasajes de tus fuentes.

Permisos que puedes otorgar

Cuando una aplicación solicita conectarse, pide un conjunto de permisos (scopes). Ves exactamente cuáles en la pantalla de autorización, y otorgar solo los que necesitas siempre es la opción más segura.

Permisos de biblioteca (cualquier plan de pago):

• Leer subrayados (highlights:read) — buscar y abrir subrayados
• Agregar subrayados (highlights:write) — guardar nuevos pasajes en tu biblioteca
• Leer fuentes (sources:read) — listar y abrir fuentes
• Agregar fuentes (sources:write) — agregar libros y enlaces a tu biblioteca
• Leer notas (notes:read) — leer notas adjuntas a subrayados

Permisos de La Academia:

• Áreas de interés (themes:read, themes:write) — leer tus áreas de interés; generarlas y finalizarlas
• Prácticas (practices:read, practices:write) — leer tus prácticas; marcarlas como hechas u omitirlas
• Reflexiones (reflections:read, reflections:write) — leer tus reflexiones guardadas; registrar nuevas reflexiones

Cada permiso de escritura va de la mano con su permiso de lectura, y toda escritura necesita además que el asistente confirme la acción específica. Para la lista completa de herramientas detrás de cada permiso, mira la Referencia de herramientas MCP.

Administrar aplicaciones conectadas

Todas tus conexiones MCP activas viven en Ajustes → Aplicaciones conectadas (o directamente en app.usebecoming.com/settings?tab=connectedApps).

Para cada conexión puedes ver:

• El nombre de la aplicación conectada (por ejemplo “Claude Desktop”)
• Los permisos que otorgaste
• Cuándo la conectaste
• Cuándo se usó por última vez
• Un botón Revocar

Revoca cualquier conexión que ya no reconozcas o uses. Después de revocar, la aplicación deja de funcionar con Becoming en pocos minutos (las llamadas en curso expiran rápido; las nuevas se rechazan de inmediato).

Qué ocurre durante el intercambio

Esta sección es lectura opcional — útil si tienes curiosidad o estás resolviendo un problema.

Cuando haces clic en “Conectar Becoming” en tu herramienta de IA:

1. La herramienta descubre los endpoints de OAuth de Becoming automáticamente (metadata RFC 8414/9728).
2. Se registra de forma dinámica (RFC 7591) — sin pasos de administración.
3. Abre una ventana del navegador apuntando al endpoint de autorización de Becoming, con un desafío de código PKCE.
4. Becoming te lleva a la pantalla de autorización en app.usebecoming.com/oauth/consent, donde inicias sesión y apruebas los permisos solicitados.
5. Una vez aprobado, Becoming emite un token bearer opaco de OAuth a la herramienta. Los tokens de acceso duran alrededor de una hora; los de actualización duran unos 30 días y se renuevan automáticamente.
6. En cada llamada posterior, Becoming valida el bearer y aplica los permisos que otorgaste. Las llamadas de escritura deben llegar además con una confirmación explícita.

Puedes revocar el permiso de OAuth cuando quieras desde Ajustes → Aplicaciones conectadas. El token bearer queda inservible en pocos minutos.

Solución de problemas

Mi herramienta dice “no se pudo conectar al servidor MCP”

• Confirma que la URL es exactamente https://mcp.usebecoming.com/mcp.
• Verifica que tu herramienta pueda abrir ventanas del navegador (el paso de autorización lo necesita).

La pantalla de autorización no se abre

• Asegúrate de que las ventanas emergentes no estén bloqueadas para app.usebecoming.com.
• Inicia sesión en app.usebecoming.com en el mismo navegador y vuelve a intentar la conexión.

La conexión se cae después de un tiempo

Tu herramienta de IA renueva los tokens de OAuth automáticamente, pero si la renovación falla puede que te pida reconectar. Ejecuta el flujo de conexión otra vez — toma segundos porque la herramienta ya está registrada.

”Suscripción requerida”

El acceso MCP requiere una suscripción activa de Becoming (o prueba de la biblioteca). Al renovar la suscripción se restaura el acceso MCP automáticamente — no necesitas reconectar. Las herramientas de áreas de interés y prácticas requieren además La Academia.

Un asistente no puede generar un área de interés o completar una práctica

• Confirma que estás en La Academia — las herramientas de áreas de interés y prácticas no están disponibles en La Biblioteca.
• Confirma que otorgaste el permiso de escritura correspondiente (por ejemplo practices:write) al conectar. Si no, reconecta y apruébalo.

Revoqué una conexión por error

Solo reconecta desde tu herramienta de IA. Cada conexión es independiente, así que reconectar crea un permiso nuevo.

Nota sobre privacidad

Cuando una herramienta de IA externa lee de tu biblioteca de Becoming, el contenido de esos subrayados y notas pasa por el proveedor de esa herramienta durante la conversación. Conecta solo herramientas en cuyas políticas de privacidad confíes.