# MCP: tu workspace, adentro de tu herramienta de IA.

Fuente: https://www.secondbrain.media/guide/mcp  
Idioma: es  
Versión en inglés: https://www.secondbrain.media/guide/mcp.md

---

secondbrain expone un servidor MCP remoto. Conectarlo a Claude, a ChatGPT 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.

## 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 y ChatGPT 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.

> **Clientes con los que funciona**
>
> Cualquiera que soporte servidores MCP remotos por HTTP: Claude (escritorio, web y Claude Code), ChatGPT con conectores, editores como Cursor o Windsurf, y agentes propios armados con los SDK del protocolo. El servidor además está publicado en el registro público de MCP, así que los clientes que lo consultan lo encuentran solos.

## El catálogo de herramientas

Setenta y cuatro herramientas, agrupadas por familia. Un cliente conectado ve todas y elige la que necesita.

| Familia | Qué puede hacer |
| --- | --- |
| Notas diarias | Leer la nota de un día, escribirla, listar las recientes, buscar en todas, cerrar y reabrir el día |
| Tareas | Listar, ver el detalle, crear, actualizar, completar, revertir, borrar, listar las completadas y leer el registro de trabajo |
| Documentos | Listar el árbol, leer, crear, actualizar, mover, borrar, buscar, y asociar o desasociar entidades |
| Recaps | Listar reuniones y grupos, leer una entera, crear, actualizar, borrar, y gestionar tipos de reunión |
| Atlas | Buscar entidades, leer una ficha, crear, actualizar, borrar, fusionar, gestionar relaciones y etiquetas, ver definiciones y las tareas de una entidad |
| Lienzos | Listar, leer, crear, actualizar y borrar |
| Archivos | Listar todo, listar por documento, renombrar 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 | Ver y actualizar el perfil, ver el plan y el uso de almacenamiento |
| Búsqueda | Búsqueda híbrida sobre todo el workspace de una sola llamada |

## 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 o ChatGPT con tus documentos y tus recaps como fuente, y guardar el resultado directo en tu memoria.

## Qué controlás vos

- Un token da acceso a tu cuenta y a tus workspaces, y a nada más. Es la misma frontera que tiene la app.
- Cada token se revoca por separado desde Ajustes, sin tocar los 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.

## 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é.

[Generar un token de API](https://workspace.secondbrain.media/settings)

## Integraciones

- **MCP** — Clientes de IA externos (Claude, ChatGPT y otros) pueden consultar y operar tu workspace mediante el protocolo MCP, solo con el token que vos generás.
