Conecta Notez a Claude, Cursor y Windsurf con MCP

AI

Tu asistente de IA ya sabe muchísimo sobre tu problema actual y nada en absoluto sobre los ocho meses de notas en los que ya resolviste una versión de ese mismo problema.

El servidor MCP de Notez cierra ese hueco. Model Context Protocol es un estándar abierto para conectar asistentes con herramientas y datos externos, y Notez incluye un servidor MCP que expone tu espacio de trabajo a través de él.

Configuración

1. Genera una clave. En Notez, ve a Configuración → Integraciones, busca Servidor MCP de Notez y haz clic en Generar clave MCP. Copia el endpoint y el bearer token: el token se muestra una sola vez.

2. Añádela a tu cliente. La página Integraciones te da un comando listo para pegar en Claude Code, con tu endpoint y tu token ya rellenados, y además la configuración JSON para Claude Code, Cursor y Windsurf con la ubicación correcta del archivo para cada uno. Claude (web, escritorio y móvil), ChatGPT y VS Code no usan clave: se conectan iniciando sesión, desde la tarjeta Conecta una aplicación de IA de la misma página.

Copia desde esa página en lugar de escribirlo a mano: la cabecera de autorización tiene que ser exacta o fallan todas las llamadas.

3. Reinicia tu cliente y pregúntale algo sobre tus notas.

Las herramientas

Una clave le da al asistente 31 herramientas: 13 de lectura y 18 de escritura. La tabla muestra las que usa primero, y Configuración del servidor MCP las lista todas.

Herramienta

Qué hace

get_current_workspace

A qué espacio de trabajo está limitada esta clave

list_notes

Busca y lista, con filtros y paginación

get_note

Una nota, en resumen o completa

get_note_children

Las notas hijas directas de una nota

get_note_ancestors

La cadena de migas de pan hasta la raíz

list_tags

Todas las etiquetas con su número de notas

search_similar_notes

Búsqueda semántica por significado, hasta 5 resultados

get_board

Un tablero kanban con sus tarjetas agrupadas por columna

create_note

Crea una nota, admite Markdown

edit_note_content

Cambia una parte de una nota y deja el resto intacto

move_note_to_board_column

Mueve tarjetas entre las columnas de un tablero

delete_note / restore_note

Manda una nota a la papelera o la recupera

list_notes admite búsqueda por subcadena, filtros por etiqueta, columnas del tablero, valores de propiedades personalizadas, fechas de creación y de actualización, tipo de nota, solo favoritos, solo notas de primer nivel, papelera, orden y paginación, así que un asistente recorre un espacio de trabajo grande sin meterlo todo en el contexto.

Dos límites que conviene conocer de antemano

No borra estructura. Una clave lee y escribe: un asistente crea, edita, renombra, etiqueta y mueve notas, las manda a la papelera y las restaura. Ninguna herramienta borra una etiqueta, una propiedad, una opción o una columna del tablero, así que eliminarlas sigue siendo cosa tuya. El chat de IA de la app usa las mismas herramientas, salvo las dos de subida de archivos.

Cada clave está ligada a un espacio de trabajo. Una clave generada en tu espacio de trabajo Trabajo da acceso solo a Trabajo. Para exponer un segundo espacio de trabajo, cámbiate a él y genera otra clave. Cualquier clave se rota desde la misma pantalla.

Para qué sirve de verdad

Cerrar una sesión con un registro escrito. El momento más valioso de una depuración es justo después de que todo funcione, y es cuando menos ganas tienes de escribir nada. "Crea una nota titulada Agotamiento del pool de Postgres con lo que acabamos de descubrir, con la etiqueta infra." Hecho, antes de cerrar la terminal.

Recuperar el contexto previo. "Busca en mis notas cualquier cosa sobre rate limiting antes de diseñar esto." Tu asistente lee lo que concluiste en el pasado en lugar de volver a deducirlo, quizá de otra manera.

Preparar reuniones. "Busca todas mis notas con la etiqueta acme de los dos últimos meses y resume los temas abiertos."

Trabajar a medias con el asistente. Las notas creadas por MCP llevan una insignia MCP, así que siempre ves qué escribió tu asistente y qué escribiste tú.

Sobre la confianza

Una clave MCP da acceso de lectura y escritura a todo un espacio de trabajo. Trátala como cualquier otra credencial: se muestra una vez, vive en el archivo de configuración de tu cliente y hay que rotarla si se filtra. Rotarla es un clic en la página Integraciones e invalida la clave anterior al instante.

La verdadera garantía de seguridad aquí es la vinculación al espacio de trabajo. Si guardas las notas personales y las de trabajo en espacios de trabajo separados (la configuración recomendada), una clave en un proyecto de trabajo no puede llegar a nada personal. Eso lo impone el servidor en cada llamada a una herramienta, no unas instrucciones en el prompt.

Sigue leyendo