Conectar apps de IA con Recoble MCP

Con Recoble MCP, las apps de IA compatibles con MCP —como ChatGPT, Claude y Claude Code— pueden buscar, leer, crear y editar las notas, tableros, calendarios, correo y chat de tu espacio de Recoble. Cada espacio tiene su propia URL de conexión: añádela a tu app de IA y listo.

¿Qué es MCP?

MCP (Model Context Protocol) es una forma estándar de que las apps de IA usen las funciones de otro servicio como «herramientas». El servidor MCP de Recoble ofrece funciones de Recoble —buscar notas, crear elementos, programar eventos— como herramientas, y la app de IA elige las que necesita para tu petición.

  • No necesitas conocer el nombre de ninguna herramienta. Pide las cosas como lo harías normalmente.
  • La app de IA solo llega al espacio que conectaste y a las funciones que permitiste.
  • Su acceso es el mismo que el de tu cuenta. Las notas o elementos que tú no puedes ver tampoco los ve la app de IA.

Lo que puedes hacer

  • Reuniones y documentos: «Resume solo las decisiones del acta de ayer», «Añade una sección de próximos pasos al final de la nota 'Hoja de ruta T3'»
  • Gestión del trabajo: «¿Qué elementos míos del backlog vencen esta semana?», «Pon el progreso de 'Corregir error de inicio de sesión' al 50 %»
  • Agenda: «Programa una revisión de diseño mañana a las 15:00», «Muestra los eventos de esta semana por día»
  • Correo y chat: «Busca el correo de la factura y resúmelo», «Muestra los mensajes de chat que me mencionan»
  • Vínculos y trazabilidad: «Vincula la nota de requisitos con el elemento 'Corregir error de inicio de sesión'», «Muestra un grafo de todo lo vinculado a esta nota»
  • Desarrollo: en Claude Code, lee un elemento del tablero, haz el trabajo y, al terminar, deja un comentario y cambia su estado.

Antes de empezar

  • Cada espacio tiene una URL de conexión distinta. Para usar varios espacios, conecta cada uno por separado.
  • Solo los miembros de un espacio pueden conectarlo.
  • El calendario, el correo, el chat y los paneles pertenecen a tu cuenta, no a un espacio. Solo puedes permitirlos cuando conectas tu espacio predeterminado.

Encontrar la URL de conexión

  1. Abre Configuración del espacio desde el menú del espacio que quieres conectar.
  2. Elige la pestaña Conexiones y abre Herramientas de IA. La URL que aparece es la del espacio cuya configuración abriste.
  3. Haz clic en Copiar junto a URL de conexión.

La URL tiene la forma https://mcp.recoble.com/s/<ID del espacio>/mcp. Al conectar con ella, la app de IA recibe todas las funciones disponibles en ese espacio.

✋ Nota: cada URL de conexión pertenece a un solo espacio. Para cambiar de espacio, revoca la conexión actual y vuelve a conectar con la URL del otro espacio.

Conectar desde ChatGPT, Claude y otras apps de IA

Las apps de IA web y de escritorio se conectan iniciando sesión en Recoble (OAuth). No necesitas crear un token.

  1. En la configuración de tu app de IA, abre la pantalla para añadir un conector (a veces llamado app o servidor MCP). Los nombres de los menús y los planes que lo ofrecen cambian según la app; consulta su ayuda.
  2. Añade un conector personalizado y pega la URL de conexión que copiaste.
  3. Al empezar la conexión se abre una ventana de inicio de sesión de Recoble. Inicia sesión con la cuenta que quieres conectar.
  4. En la pantalla Autorizar el acceso, revisa el nombre de la app, el Espacio de destino y los permisos solicitados. Si te pide elegir un espacio, selecciónalo en Espacio que se va a conectar.
  5. Si conectas tu espacio predeterminado, puedes marcar calendario, correo, chat o paneles en Permitir también funciones de la cuenta.
  6. Haz clic en Permitir para terminar.

💡 Consejo: si tras conectar no ves las herramientas de Recoble en la app de IA, empieza una conversación nueva o vuelve a conectar el conector. Las apps de IA obtienen la lista de herramientas al conectarse.

Conectar desde Claude Code y scripts (token de acceso)

En herramientas de terminal, scripts e integraciones de servidor —donde es difícil abrir una ventana de inicio de sesión— conecta con un token de acceso en una cabecera.

  1. Ve a Tokens de acceso (scripts y CLI) en Configuración del espacio › Conexiones › Herramientas de IA.
  2. Escribe un Nombre del token de acceso que te indique dónde se usa.
  3. Elige un permiso.
    • Lectura: solo herramientas que buscan y leen. No se puede crear, cambiar ni eliminar nada.
    • Lectura y escritura: también las herramientas que crean, cambian y eliminan.
  4. Si hace falta, elige calendario, correo, chat o paneles en Acceso de la IA a funciones. Solo está disponible para tokens emitidos en tu espacio predeterminado; si no eliges nada, el token cubre solo las notas y tableros de este espacio.
  5. Elige una Caducidad de 7, 30, 90, 180 o 365 días.
  6. Haz clic en Emitir y copia el token enseguida. Solo se muestra esta vez.

En Claude Code, conecta con este comando. Sustituye <ID del espacio> y <token de acceso>.

claude mcp add --transport http recoble https://mcp.recoble.com/s/<ID del espacio>/mcp \
  --header "Authorization: Bearer <token de acceso>"

Otras herramientas funcionan igual: registra la URL de conexión como servidor MCP HTTP con la cabecera Authorization: Bearer <token de acceso>.

✋ Nota: un token de acceso vale tanto como una contraseña. Quien lo tenga puede acceder a los datos de este espacio. No lo subas a un repositorio ni a un chat, y revócalo en cuanto se filtre.

Herramientas disponibles

La app de IA recibe las herramientas siguientes que corresponden a los permisos de la conexión y las elige según tu petición. Cuando una herramienta hace varias cosas, los nombres de las acciones (method) van entre paréntesis.

  • Una conexión de Lectura solo recibe las herramientas marcadas como «Lectura».
  • Las herramientas de calendario, correo, chat y paneles solo se incluyen si permitiste esa función.

  • Espacio

    • get_connection_info — Muestra el espacio conectado, la cuenta y los nombres de las cuentas de correo conectadas. (Lectura)
    • list_space_children — Lista, en orden, las notas y tableros un nivel por debajo en la barra lateral. (Lectura)
    • reorder_children — Cambia el orden de la barra lateral o trae elementos de otro lugar. (Escritura)
    • get_task_result — Obtiene el resultado de una tarea larga (por ejemplo, una búsqueda grande). (Lectura)

  • Notas

    • list_notes — Lista notas, filtrando por creadas, editadas o vistas recientemente, etiqueta, favoritas o notas hijas. (Lectura)
    • search_notes — Busca notas por título y contenido. (Lectura)
    • read_note — Lee el cuerpo de una nota. Una nota larga se puede leer por encabezado o por partes. (Lectura)
    • note_read (tree, find, headings, tags) — Muestra la jerarquía de notas, busca texto dentro de una nota, lista encabezados y lista etiquetas. (Lectura)
    • note_write (create, update) — Crea una nota o cambia su título, icono, ubicación, fijado, favorito y etiquetas. (Escritura)
    • edit_note — Cambia solo una parte del cuerpo (una sección, una frase, un elemento de lista…) y deja el resto igual. (Escritura)
    • update_note_content — Reescribe todo el cuerpo o añade contenido al principio o al final. (Escritura)
    • note_delete — Mueve una nota a la papelera. (Escritura)
    • publish_note · unpublish_note — Publica una nota en la web con un enlace público o deja de publicarla. (Escritura)

  • Tableros

    • list_workboards — Lista los tableros y busca uno por nombre o por clave de elemento (por ejemplo, REC). (Lectura)
    • list_workboard_items — Busca y filtra los elementos de un tablero (estado, prioridad, responsable, fecha de creación, vencimiento próximo y más). (Lectura)
    • workboard_read (get, statuses, fields, critical_path) — Muestra la configuración, los estados, los campos personalizados y la ruta crítica (la cadena de dependencias más larga) de un tablero. (Lectura)
    • item_read (mine, get, comments) — Muestra los elementos asignados a mí, un elemento completo y sus comentarios. (Lectura)
    • workboard_write (create, update) — Crea un tablero o cambia su nombre, descripción, fechas y vistas. (Escritura)
    • workboard_setup (status_create, status_update, field_create) — Añade o cambia un estado, o añade un campo personalizado. (Escritura)
    • update_workboard_field — Cambia el nombre y las opciones de un campo personalizado. (Escritura)
    • item_write (create, update, comment_create) — Crea o cambia elementos y añade comentarios. (Escritura)
    • item_delete — Mueve un elemento a la papelera (se puede restaurar durante 30 días). (Escritura)
    • workboard_delete (delete, status_delete) — Mueve un tablero a la papelera o elimina un estado. (Escritura)
    • delete_workboard_item_comment — Elimina un comentario que publicaste por error. No se puede deshacer. (Escritura)

  • Vínculos

    • link_read (types, list, graph) — Muestra los tipos de vínculo, los vínculos de un elemento y el grafo de vínculos a su alrededor. (Lectura)
    • link_write (type_create, create, trace_view_save) — Crea tipos de vínculo, vincula notas, elementos, tableros y eventos entre sí, y guarda vistas de trazabilidad. (Escritura)
    • link_delete — Elimina un vínculo. No se puede deshacer. (Escritura)

  • Imágenes y adjuntos

    • image_read (image, attachment) — Muestra una imagen de una nota o elemento, o lee el texto de un PDF o archivo de texto adjunto. (Lectura)
    • image_write (upload, attach) — Sube una imagen y la inserta en el cuerpo de una nota, la descripción de un elemento o un comentario. (Escritura)

  • Calendario (si lo permites)

    • list_calendar_events — Muestra los eventos de un intervalo de fechas. Sin condiciones, muestra los de hoy. (Lectura)
    • calendar_read (search_events, calendars) — Busca eventos o lista mis calendarios. (Lectura)
    • calendar_write (event_create, calendar_create, calendar_update) — Crea eventos, y crea calendarios o cambia su configuración. (Escritura)
    • calendar_edit (event_update, occurrence_update) — Cambia un evento. En un evento periódico, cambia toda la serie o solo una repetición. (Escritura)
    • calendar_delete (event_delete, occurrence_exclude, calendar_delete) — Elimina un evento, quita una repetición de un evento periódico o elimina un calendario. (Escritura)

  • Correo (si lo permites)

    • email_read (accounts, list, search, unread_counts) — Muestra las cuentas de correo conectadas, los correos de una carpeta, resultados de búsqueda y el número de no leídos. (Lectura)
    • get_email — Lee el contenido completo de un correo. (Lectura)
    • email_send — Envía un correo nuevo. (Escritura)
    • email_respond (reply, forward) — Responde o reenvía un correo recibido. (Escritura)
    • email_write (mark_read, save_as_note) — Marca correos como leídos o no leídos, o guarda un correo como nota. (Escritura)
    • email_delete (delete, empty_folder) — Mueve correos a la papelera o vacía una carpeta a la papelera. (Escritura)

  • Chat (si lo permites)

    • chat_read (list, messages, search, mentions, thread) — Muestra los canales y conversaciones de los que formo parte, sus mensajes, resultados de búsqueda, los mensajes que me mencionan y las respuestas de hilos. (Lectura)
    • chat_send — Envía un mensaje a una conversación. Los destinatarios reciben una notificación. (Escritura)

  • Paneles (si lo permites)

    • dashboard_read (list, get) — Muestra mis paneles y la configuración de widgets de uno. (Lectura)
    • dashboard_create — Crea un panel de gráficos con datos de varios tableros. (Escritura)
    • update_dashboard — Cambia el nombre y la configuración de widgets de un panel. La configuración de widgets se reemplaza entera. (Escritura)

Cómo se protegen tus datos

  • Confirmar antes de actuar: enviar, responder, reenviar o eliminar correos, enviar mensajes de chat y eliminar notas no hacen nada si la llamada no lleva una confirmación. Por eso la app de IA te muestra primero el destino y el contenido, y solo actúa cuando confirmas.
  • Papelera: las notas, tableros y elementos eliminados van a la papelera. Desaparecen de la pantalla al momento, pero puedes restaurarlos desde la papelera. Al eliminar correos o vaciar una carpeta, los correos también van a la papelera.
  • No se puede deshacer: eliminar un vínculo y eliminar un comentario de un elemento no se pueden deshacer.
  • Historial de versiones: cuando se reescribe o edita el cuerpo de una nota, el texto anterior queda en su historial de versiones.
  • Límites de llamadas: cada conexión (token) puede hacer hasta 100 llamadas de lectura, 30 de escritura y 5 de envío o eliminación por minuto (50 al día). Si se superan, se te pedirá que lo intentes de nuevo en un momento.

Administrar las conexiones

  • Aplicaciones conectadas: en Configuración del espacio › Conexiones › Aplicaciones conectadas verás las apps de IA conectadas mediante inicio de sesión, con la app, el espacio, el permiso, la fecha de conexión, el último uso y el estado. Haz clic en Revocar en una app que ya no uses para bloquearla al instante.
  • Tokens de acceso: la lista de tokens de Herramientas de IA muestra el permiso, las funciones permitidas, la caducidad y el último uso de cada token. Haz clic en Revocar para cortar al instante todas las integraciones que lo usan.

Buenas prácticas

  • Empieza por tareas conocidas. Las peticiones de solo lectura, como buscar o resumir notas, facilitan ver cómo actúa la app de IA.
  • Sé concreto con los nombres. Di «la nota 'Hoja de ruta T3'» en lugar de «esa nota», o «el tablero 'Backlog de desarrollo'» en lugar de «el backlog», para que la app elija bien.
  • Permite solo lo necesario. Usa un token de Lectura si solo vas a consultar, y permite calendario, correo, chat y paneles solo cuando los uses.
  • Pide un plan antes de cambios grandes. Antes de cambiar muchos elementos a la vez, pide «muéstrame primero lo que vas a cambiar» para evitar errores.

Preguntas frecuentes

¿Qué apps de IA puedo conectar?

Cualquier app de IA compatible con servidores MCP remotos (HTTP). Las que se conectan iniciando sesión (OAuth) solo necesitan la URL de conexión; las herramientas que envían una cabecera necesitan además un token de acceso.

¿Una conexión sirve para varios espacios?

No. Cada conexión llega a un solo espacio. Para usar otro, añade otra conexión con la URL de ese espacio.

No veo las herramientas de calendario o correo.

El calendario, el correo, el chat y los paneles solo se incluyen si conectas tu espacio predeterminado y permites esas funciones. En una conexión por inicio de sesión, revisa Permitir también funciones de la cuenta en la pantalla Autorizar el acceso; en un token de acceso, revisa Acceso de la IA a funciones. Las herramientas de correo también necesitan una cuenta de correo conectada en Recoble.

Quiero una conexión de solo lectura.

Usa un token de acceso emitido con el permiso Lectura. Esa conexión solo recibe herramientas que buscan y leen, así que no puede cambiar nada.

La app de IA dice que no hay herramientas.

Empieza una conversación nueva o vuelve a conectar el conector. Si sigue igual, comprueba en la lista de aplicaciones conectadas o de tokens que la conexión está Activo y que el token no ha caducado.

¿Puede otra persona ver mis datos con mi conexión?

Una conexión funciona con los permisos de la cuenta que la creó. Si das tu token de acceso a otra persona, tendrá el mismo acceso; no lo compartas.

¿Qué pasa al revocar una conexión?

La conexión pierde el acceso a Recoble al instante. Para volver a usarla, conéctala de nuevo.

Empieza gratis con Recoble