Flexnote MCP: entra a tu base de conocimiento local desde Cursor y Codex

Cuando trabajas en Cursor o Codex, a menudo necesitas consultar notas locales: decisiones anteriores, extractos de literatura o el diseño de un tablero. Copiar texto a otro chat, o cambiar de aplicación, separa la base de conocimiento del flujo en el que estás.

La aplicación de escritorio de Flexnote ahora incluye un servidor MCP (Model Context Protocol). El servicio solo escucha en 127.0.0.1. Los clientes que implementan el protocolo —entre ellos Cursor, Claude Desktop y Codex— pueden buscar, leer y escribir la biblioteca actual. Los datos se quedan en tu dispositivo y no se suben a una nube de notas de terceros.

1. En qué se diferencia MCP de Flexnote AI dentro de la app

MCP es un protocolo abierto para declarar herramientas que un cliente de IA externo puede llamar. El cliente lista las herramientas, las invoca por nombre y recibe texto JSON. El modelo lo elige el cliente; Flexnote no intermedia la facturación ni el proveedor.

Flexnote AI dentro de la app corre en la barra lateral: usa la clave de API configurada en Ajustes, las respuestas pueden incluir citas y el Agent puede editar el tablero. MCP abre la misma biblioteca a herramientas de desarrollo externas, para que uses notas diarias, tarjetas, to-dos y pizarras sin salir del editor.

2. Alcance

Puedes consultar tarjetas, notas diarias, pizarras, to-dos, etiquetas y colecciones del espacio de trabajo actual. Las herramientas de escritura exigen que el modo de solo lectura esté apagado. Las operaciones del lienzo necesitan un ID de pizarra. Si el tablero no está abierto, Flexnote navega hasta él y espera a que el lienzo esté listo, para que la solicitud del cliente no se venza por tiempo.

3. Activar el servidor

MCP es una función Pro. Hace falta iniciar sesión con una membresía válida, y la aplicación de escritorio de Flexnote tiene que estar en ejecución. Cuando cierras la aplicación, el puerto local se cierra y los clientes no pueden conectarse.

1. Abre Flexnote → Ajustes → MCP server.
2. Activa el servicio. Solo se vincula a loopback. El puerto predeterminado es 39125.
3. Copia la configuración del cliente: JSON por HTTP para Cursor / Claude Desktop; un puente stdio para los clientes que lanzan un command; TOML para Codex CLI.
4. Agrega la configuración al cliente. El token de acceso es solo para autenticación local. No lo subas a un repositorio público ni lo compartas.

Hay dos opciones más que importan: el modo de solo lectura expone únicamente herramientas de consulta y sirve para la primera prueba de conexión. Puedes desactivar herramientas sueltas si no quieres que estén disponibles para un modelo externo.

4. Conectar Cursor, Claude Desktop y Codex

Cursor / Claude Desktop

Usa la configuración HTTP de Ajustes. Los campos necesarios son la URL local y el token Bearer:

{
  "mcpServers": {
    "flexnote": {
      "url": "http://127.0.0.1:39125/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Codex CLI

Codex CLI suele usar un puente stdio: Node ejecuta un script que proporciona Flexnote y reenvía la entrada estándar al endpoint HTTP local. En Ajustes puedes copiar la configuración TOML y ubicar el script. Define FLEXNOTE_MCP_URL y FLEXNOTE_MCP_TOKEN en el entorno.

5. Solicitudes de ejemplo

Cuando la conexión ya está hecha, no hace falta nombrar las herramientas. Basta con pedidos en lenguaje natural. Puedes usar estas frases para comprobar la integración:

• «¿Qué espacio de trabajo de Flexnote está abierto ahora? Lista las pizarras recientes y cinco tarjetas. No modifiques ningún dato.»
• «Agrega esta conclusión a la nota diaria de hoy. Crea la nota si no existe. No la guardes como una tarjeta de nota normal.»
• «Crea una nota titulada MCP trial. El cuerpo debe empezar con un encabezado Markdown 1.»
• «En la pizarra indicada (pasa whiteboardId), crea dos notas adhesivas, conéctalas y luego lee el diseño del lienzo.»
• «Lista los to-dos y marca uno como completado.»

Después de una escritura exitosa, Flexnote muestra una notificación en la ventana. Si existe una entidad que coincida, Ver abre la página correspondiente; si no, puedes actualizar la interfaz. La notificación se queda hasta que la cierras.

6. Seguridad

El servicio solo escucha en localhost. Otros procesos del mismo dispositivo que tengan el token de acceso pueden llamar a las mismas herramientas. Trata el token como una credencial. Regenerarlo en Ajustes invalida de inmediato las configuraciones anteriores.

Cuando las herramientas de escritura están activas, un modelo externo puede modificar la biblioteca. Para la primera verificación, activa el modo de solo lectura o desactiva las herramientas de crear, eliminar y pizarra. MCP solo aplica al espacio de trabajo que está abierto. Confirma el espacio de trabajo antes de escribir.

7. Límites

• El uso solo en el navegador, sin la aplicación de escritorio, no ofrece un puerto MCP local.
• Esto no es una puerta de enlace de equipo y no ofrece acceso por la red pública. No está pensado para compartir una biblioteca con otras personas.
• Flexnote no es una pizarra multijugador en tiempo real, y MCP no agrega esa capacidad. El alcance del producto está en Qué es Flexnote.

8. Cómo empezar

Actualiza la aplicación de escritorio a una compilación que incluya MCP, inicia sesión con una cuenta Pro, activa el servidor en Ajustes y agrega la configuración a Cursor o Codex. Comprueba la búsqueda en modo de solo lectura antes de activar la escritura. Descarga el cliente en la página de descarga. Los detalles de Pro están en precios.

Los flujos que ya tienes con el Agent de conocimiento dentro de la app no tienen que cambiar. MCP conecta la misma biblioteca local con herramientas de desarrollo externas.