# MCP: tu workspace, adentro de tu herramienta de IA. Fuente: https://www.onsecondbrain.com/guide/mcp Idioma: es Versión en inglés: https://www.onsecondbrain.com/guide/mcp.md --- secondbrain expone un servidor MCP remoto. Conectarlo a Claude, a ChatGPT, a Gemini o a cualquier cliente que hable el protocolo le da acceso a tus notas, tareas, documentos, recaps y al Atlas entero — para consultar, analizar y también para escribir. Es el canal donde se hacen las cosas que no entran en un chat: planificaciones largas, análisis cruzados y automatizaciones. ## Ponerlo en marcha ### Qué es MCP, en una línea MCP (Model Context Protocol) es el estándar que permite que una herramienta de IA use servicios externos como herramientas propias. En vez de copiar y pegar contexto en un prompt, el modelo pide los datos que necesita, cuando los necesita. La diferencia práctica es enorme: un análisis sobre doscientos documentos no entra en un prompt, pero sí entra en veinte llamadas a herramientas que el modelo decide hacer solo. ### Conectar un cliente El servidor es remoto —no hay nada que instalar— y responde en una sola dirección: ``` https://api.secondbrain.media/functions/v1/mcp ``` Hay dos formas de autenticarse, y se elige según el cliente: - **OAuth** — El cliente te abre la pantalla de inicio de sesión de secondbrain, autorizás y listo. Es lo que usan Claude, ChatGPT y Gemini al agregar un conector remoto: no hay que copiar ninguna clave. - **Token de API** — Para clientes que piden una credencial fija: generás un token desde Configuración de cuenta → MCP, lo pegás en el cliente y lo revocás cuando quieras. ¿Desde qué cliente?: **Claude** En la web, en el escritorio y en el teléfono. Va por OAuth, así que no hay ningún token que copiar. La forma más corta: secondbrain está en el directorio de conectores de Claude, así que lo buscás por nombre y no hace falta pegar ninguna dirección. [Abrir secondbrain en el directorio de Claude](https://claude.ai/directory/secondbrain) O, si preferís hacerlo a mano: 1. **Abrí los conectores** — En Claude: Configuración → Conectores, y después Agregar conector personalizado. 2. **Pegá la dirección** — El nombre lo elegís vos —«secondbrain» está bien— y la URL es la de arriba. 3. **Autorizá** — Claude abre el inicio de sesión de secondbrain: entrás con tu cuenta, aprobás el acceso y volvés a Claude con el conector ya conectado. De ahí en más, en cada conversación las herramientas de secondbrain se prenden desde el menú de herramientas del chat. **ChatGPT** El mismo camino, en otro menú — y hace falta un plan pago. 1. **Abrí los conectores** — En ChatGPT: Configuración → Conectores. Los conectores MCP propios están en Avanzado → Modo desarrollador, que se activa una sola vez. 2. **Creá el conector** — Ponele un nombre, pegá la misma URL y elegí OAuth como autenticación. 3. **Autorizá** — Entrás con tu cuenta de secondbrain y aprobás. En cada chat lo elegís desde el +. **Gemini** En Gemini Spark, el agente de Gemini. Se agrega desde la web y también va por OAuth. 1. **Abrí las apps conectadas** — En gemini.google.com: Configuración → Apps conectadas, y en Apps personalizadas para Spark, Agregar una app personalizada. 2. **Pegá la dirección** — La misma URL de arriba, y Siguiente. 3. **Autorizá** — Gemini abre el inicio de sesión de secondbrain: entrás con tu cuenta y aprobás. Desde ahí Spark la usa en sus tareas y en el chat. Por ahora Google lo limita a cuentas personales (no de trabajo ni de escuela), en inglés y en Estados Unidos, con Actividad de Keep prendida — sin eso la conexión se autoriza pero no hace nada. **Claude Code y otros** Los clientes que se configuran con un comando o un archivo —Claude Code, Cursor, Windsurf, n8n, un agente propio— no hacen OAuth: van con un token. 1. **Generá el token** — En la app: tu nombre → Configuración de cuenta → MCP, elegí tu herramienta y apretá Generar token. Se muestra una sola vez, ya pegado en el comando o el bloque y con un botón para copiarlo. 2. **Pegalo en el cliente** — En Claude Code es un comando de terminal; en Cursor, un bloque en ~/.cursor/mcp.json. En otros editores cambia el archivo, no el bloque. ``` claude mcp add --transport http secondbrain https://api.secondbrain.media/functions/v1/mcp \ --header "Authorization: Bearer sbk_tu_token" ``` ``` { "mcpServers": { "secondbrain": { "url": "https://api.secondbrain.media/functions/v1/mcp", "headers": { "Authorization": "Bearer sbk_tu_token" } } } } ``` ![La pestaña MCP de la configuración de cuenta, con un token desplegado y el bloque de configuración de Claude Code](https://www.onsecondbrain.com/screens/guide/settings-mcp.png) _La pestaña MCP de tu configuración de cuenta._ > **Clientes con los que funciona** > > Cualquiera que soporte servidores MCP remotos por HTTP, también un agente propio armado con los SDK del protocolo. El servidor está publicado en el registro público de MCP, así que los clientes que lo consultan lo encuentran solos. ### Qué controlás vos - Una conexión por OAuth ve tus workspaces; un token, sólo el workspace donde lo generaste. Ninguna llega a nada más: es la misma frontera que tiene la app. - Cada conexión —un token o una app que autorizaste— se corta por separado en Configuración de cuenta → MCP → Tus conexiones, sin tocar las demás ni cerrar tu sesión. - Las herramientas respetan tu plan: lo que no está incluido tampoco se puede hacer por MCP. - Toda escritura queda registrada igual que si la hubieras hecho en la app, con su historial y su vuelta atrás. - Podés desconectar el servidor del cliente en cualquier momento: no queda nada corriendo del lado nuestro. ## Tarjetas en el chat ### Lo que ves cuando el modelo usa secondbrain En Claude —web, escritorio y teléfono— y en ChatGPT, lo que trae secondbrain no llega sólo como texto: el chat dibuja una tarjeta con tu día, una tarea, un recap o tu Atlas, con los colores, los íconos y la letra de la app. Y en la tarjeta se hacen cosas sin escribir. - El modelo lee los mismos datos que antes; la tarjeta sólo los muestra. Donde no hay pantalla —el modo voz, Claude Code, un agente propio— la respuesta sigue siendo texto. - En la compu, las que tienen varias partes —tu día, lo que sabe tu memoria, una ficha del Atlas, tus ajustes— usan el ancho en dos columnas. En el teléfono van en una sola, con lo secundario plegado. - Si conectaste secondbrain antes y no las ves, desconectá el conector y volvé a conectarlo: el cliente guarda la lista de herramientas de cuando lo conectaste. ### Las vistas Hay más de treinta: casi cada cosa que el modelo puede leer o hacer tiene la suya. Éstas son las que más vas a ver. ¿Qué le pediste?: **Tu día** «¿Qué tengo hoy?»: la agenda como en el calendario de la app —con la línea de ahora y el botón para entrar a la llamada—, las tareas del día y lo que se venció. ![La tarjeta Mi día de secondbrain: cinco eventos en una grilla de horas con la línea de ahora, el botón para unirse a la daily y tres tareas con su casilla](https://www.onsecondbrain.com/screens/guide/mcp-ui-dia.png) **La semana** «¿Qué tengo esta semana?» en una sola tarjeta, armada como el calendario de la app: una columna por día, arriba lo de todo el día y las tareas que vencen (se tildan ahí mismo), abajo las reuniones. Todos tus workspaces juntos, cada calendario con su color; lo que organiza otra persona va rayado y lo que se pisa, marcado en rojo. ![La tarjeta Agenda con la semana del 19 al 25 de octubre: una columna por día con las tareas arriba en azul y los eventos de tres workspaces en el color de su calendario, rayados los que organiza otra persona y marcados en rojo los que se pisan](https://www.onsecondbrain.com/screens/guide/mcp-ui-semana.png) **Una tarea** Todo lo de una tarea —vencimiento, aviso, responsable, proyecto y el recap de donde salió—, y el estado se cambia ahí mismo: Pendiente, En curso o Hecha. ![La tarjeta de una tarea con el selector Pendiente, En curso y Hecha, y sus datos: vence el lunes, aviso a las 9, responsable, proyecto, organización y el recap de donde salió](https://www.onsecondbrain.com/screens/guide/mcp-ui-tarea.png) **Un recap** Los accionables de una reunión. Crear tarea la arma con el responsable y la fecha que salieron del recap; la cruz lo descarta, y lo que ya es tarea se puede deshacer. ![La tarjeta de accionables de un recap con dos por confirmar, cada uno con su botón Crear tarea, uno que ya es tarea y uno descartado](https://www.onsecondbrain.com/screens/guide/mcp-ui-accionables.png) **El Daily** Tus últimos días en línea de tiempo, con lo que dejó cada nota: tareas, recordatorios, definiciones e hitos. ![La tarjeta del Daily con hoy, ayer y el miércoles, el resumen de cada día y lo que dejó cada nota](https://www.onsecondbrain.com/screens/guide/mcp-ui-daily.png) **El Atlas** Con quién y con qué se conecta una persona, un proyecto o una organización, cada tipo con su color. Lo punteado no está cargado: aparece junto seguido en tu material. ![La tarjeta de vínculos de Acme en el Atlas: Acme al centro, sus proyectos y personas alrededor, y la lista de lo que aparece junto seguido](https://www.onsecondbrain.com/screens/guide/mcp-ui-atlas.png) **Vos** Tu retrato a partir de lo que decís en las reuniones: cuánto hablás semana a semana, tus fortalezas, en qué mejorar y tu foco. Sale de tu huella de voz; más en Secondbrain Me. ![La tarjeta Vos con quién sos, cuatro números de tus reuniones, los gráficos de cuánto hablaste y de tu tono por semana, fortalezas, a mejorar y tu foco](https://www.onsecondbrain.com/screens/guide/mcp-ui-vos.png) **Ajustes** Los avisos, la zona horaria, el cierre automático del día y el digest se prenden y apagan en la tarjeta, con los mismos nombres que en la app. ![La tarjeta Ajustes con los interruptores de los avisos, la frecuencia del informe Vos, el cierre del día y el digest del workspace, idioma y tema, y los atajos a lo que se configura en la app](https://www.onsecondbrain.com/screens/guide/mcp-ui-ajustes.png) **En la app** Grabar una reunión, dictar o conectar el calendario no se hace desde el chat: la tarjeta te dice cómo y te deja la descarga que corresponde. ![La tarjeta En la app para grabar una reunión: por qué no se hace desde el chat, tres pasos y las descargas para Mac, Windows, iPhone y Android](https://www.onsecondbrain.com/screens/guide/mcp-ui-app.png) ### Lo que se hace desde la tarjeta - Tareas: se marcan hechas, pasan a en curso o vuelven a pendiente. - Recaps: cada accionable se convierte en tarea, se deshace o se descarta. - Ajustes: cada interruptor guarda al momento. - Abrir: lleva al lugar exacto de la app —la tarea, el recap, el día del Daily, la ficha del Atlas—. - Unirse a la llamada de un evento, o abrir el original de un clip. Lo que escribe una tarjeta pasa por las mismas herramientas que usa el modelo, con tus permisos y tu plan: lo que la app no te deja hacer, la tarjeta tampoco. ## En el día a día ### El catálogo de herramientas Más de cien herramientas, agrupadas por familia. Un cliente conectado ve todas y elige la que necesita. | Familia | Qué puede hacer | | --- | --- | | Búsqueda | Preguntarle a todo el workspace de una sola vez —devuelve los pasajes, las fichas del Atlas y las tareas abiertas que vienen al caso— y buscar por palabra y por significado | | Notas diarias | Leer la nota de un día, escribirla, listar las recientes, buscar en todas, ver las tareas provisorias, cerrar y reabrir el día | | Tareas | Listar, ver el detalle, crear, actualizar, completar, reactivar, borrar, comentar, listar las completadas y leer el historial | | Tableros y entregables | Listar los tableros y sus tareas; listar, crear y actualizar entregables | | Calendario y recordatorios | Ver la agenda; crear, cambiar y borrar los eventos de Secondbrain —los de Google, Outlook o iCloud sólo se leen—; listar los recordatorios y cancelar uno | | Documentos | Listar el árbol, leer, crear, actualizar o editar por partes, copiar, mover, borrar, buscar, ver y restaurar versiones, y asociar o desasociar entidades | | Recaps | Listar reuniones y grupos, leer una entera, confirmar o descartar sus accionables, crear, actualizar, borrar, y gestionar tipos de reunión | | Atlas | Buscar entidades, leer una ficha y su wiki, crear, actualizar, borrar, fusionar, gestionar relaciones y etiquetas, ver definiciones y las tareas de una entidad | | Lienzos | Listar, leer, crear, actualizar y borrar | | Archivos y clips | Listar los archivos, todos o por documento, renombrarlos y borrarlos; listar y leer los clips | | Artefactos | Guardar el artefacto de la conversación, editarlo por partes, agregarle al final, listar, leer, restaurar una versión y borrar | | Reportes | Listar, leer el último o uno cualquiera, generar uno nuevo, borrar, y ver el consumo de IA | | Workspace | Listar tus workspaces, ver y actualizar el actual, y leer sus relaciones | | Cuenta y ajustes | Ver y actualizar el perfil, ver el plan, el consumo y el almacenamiento, y cambiar los ajustes: avisos, idioma, tema, zona horaria, cierre del día y digest | | Vos | Tu retrato por tus reuniones: cuánto hablás, tu tono, tus fortalezas y en qué mejorar | | Lo que es de la app | Para grabar, dictar o conectar algo que se hace en la app: los pasos y la descarga que corresponde | Además trae recetas para los pedidos típicos —preparar una reunión, ponerse al día, planificar la semana, cerrar el día—, que el modelo sigue cuando el pedido encaja. ### Para qué se usa de verdad La captura rápida ya la resuelven el móvil y el chat. MCP es para lo otro: lo que necesita leer mucho y pensar largo. - **Planificaciones complejas** — "Mirá mis entregables abiertos, mis reuniones de las próximas dos semanas y mi carga real, y armame un plan de trimestre." El modelo lee, cruza y propone; vos decidís qué se escribe. - **Análisis del Atlas** — "¿Qué clientes tienen proyectos frenados y con quién de mi equipo se relacionan?" Recorre el grafo, lee las fichas y contesta con lo que hay, no con una impresión. - **Síntesis de mucho material** — Informes que cruzan meses de recaps, notas y documentos. El modelo pide lo que necesita en varias vueltas en vez de intentar meter todo en un prompt. - **Automatizaciones** — Rutinas que corren solas: preparar el resumen del lunes, abrir tareas a partir de un mail, archivar lo cerrado, crear las fichas de un cliente nuevo. - **Carga y migración masiva** — Traer contenido de otra herramienta, crear cientos de documentos con su estructura o dar de alta un Atlas entero desde una lista. - **Escritura con tu contexto** — Redactar en Claude, ChatGPT o Gemini con tus documentos y tus recaps como fuente, y guardar el resultado directo en tu memoria. ### Por voz, manejando Con secondbrain conectado a ChatGPT, el modo voz —en la pantalla del auto o en el teléfono— te deja hablarle a tu memoria con las manos en el volante: qué se dijo en una reunión, qué tenés en la agenda, qué te vence. Y en la misma charla le pedís que lo resuelva. ¿Qué le pedís?: **Un recap** Lo que dijo alguien en la reunión de ayer, y una tarea con recordatorio para no olvidarte. ![Una mujer maneja y le pregunta a ChatGPT si Diego dijo que mandaba el pliego en la reunión de ayer; secondbrain lee el recap y después crea la tarea «Llamar a Diego por el pliego» con aviso el viernes a las 10](https://www.onsecondbrain.com/screens/guide/mcp-voz-recap.jpg) **Una reunión** Lo que tenés que saber antes de llegar —sale de la ficha del cliente y de sus recaps— y una línea en el diario. ![Una mujer maneja bajo la lluvia camino a Grupo Andes; secondbrain lee la ficha y tres recaps, ChatGPT le cuenta qué quedó abierto y secondbrain anota en su diario que hoy les lleva la propuesta](https://www.onsecondbrain.com/screens/guide/mcp-voz-reunion.jpg) **La agenda** Lo que tenés esta tarde, y un evento que se pasa a mañana. ![Un hombre maneja por una ruta y pregunta qué tiene esta tarde; secondbrain mira la agenda y después mueve la llamada con Martín de hoy a las 16:30 a mañana a las 10](https://www.onsecondbrain.com/screens/guide/mcp-voz-agenda.jpg) **Las tareas** Lo que te vence esta semana, y una que se marca como hecha. ![Un hombre maneja por la costanera y pregunta qué le vence esta semana; secondbrain revisa las tareas y después marca como hecha «Firmar los contratos con Puerto Norte»](https://www.onsecondbrain.com/screens/guide/mcp-voz-tareas.jpg) ### Artefactos Lo que el modelo arma en la conversación —un prototipo, un deck, un documento— se guarda con sólo pedírselo: «guardá este artefacto en Secondbrain». Queda en tu workspace con su origen anotado —Claude o ChatGPT—, y después el modelo lo puede leer, editar por partes o volver a una versión anterior, desde cualquier cliente. Para que además se actualice solo cada vez que cambia en el chat, está el Web Clipper. ### Combinarlo con otras herramientas La gracia de MCP es que tu cliente de IA puede tener varios servidores conectados a la vez, y usarlos en la misma conversación. Con secondbrain más tu calendario, tu correo, tu repositorio o tu base de datos conectados, un mismo pedido puede leer tu contexto de trabajo acá, cruzarlo con lo de allá y dejar el resultado escrito donde corresponda. secondbrain aporta la parte que ninguna otra tiene: qué venías haciendo, con quién y por qué. ### Integraciones - **MCP** — Clientes de IA externos (Claude, ChatGPT, Gemini y otros) pueden consultar y operar tu workspace mediante el protocolo MCP, solo con el token que vos generás.