Integración MCP

Servidor MCP de AFFiNE: conecta tus herramientas de IA a tu base de conocimiento

El endpoint MCP de AFFiNE permite a clientes de IA compatibles buscar notas y texto de pizarras y leer documentos. La conexión directa requiere Streamable HTTP y encabezados Bearer; los clientes con stdio local pueden usar un puente local.

  • Credenciales por workspace, revocables
  • Streamable HTTP + Bearer
  • 70K+ estrellas en GitHub

Conecta tu base de conocimiento a un cliente de IA compatible

MCP es un estándar abierto para conectar asistentes con herramientas y datos. Las instancias compatibles de AFFiNE Cloud y autoalojadas incluyen un endpoint por espacio. La conexión directa necesita Streamable HTTP y un encabezado Authorization. Los clientes limitados a stdio necesitan un puente local como mcp-remote.

Una vez conectado, un asistente puede ejecutar búsquedas por palabra clave y semánticas sobre toda tu base de conocimiento, pizarras incluidas, y leer documentos completos, con exactamente los permisos que concedes y nada más. Cada cliente recibe su propia credencial, que puedes rotar o revocar de forma independiente: «mi IA ve mis notas» nunca tiene que significar «todo, para siempre».

El servidor MCP de AFFiNE de un vistazo

Qué esEl punto de acceso oficial del Model Context Protocol, integrado en AFFiNE Cloud y en instancias autoalojadas
Punto de accesoPOST /api/workspaces/{workspace-id}/mcp
TransporteStreamable HTTP, sin estado
AutenticaciónCredencial Bearer (prefijo aff_mcp_v1.), creada por cliente en la configuración del workspace
Herramientasdoc_search / read_document; READ_WRITE: development / canary
AlcanceUn workspace por credencial, respetando tus permisos sobre los documentos
PrecioGratis en AFFiNE Cloud y en instancias autoalojadas con las funciones de IA activadas

¿Tu espacio de trabajo o la demo de contenido público?

Tu espacio de trabajo

AFFiNE Cloud o una instancia propia compatible. Requiere una credencial Bearer del espacio y respeta los permisos de documentos. Abajo aparecen las herramientas de lectura predeterminadas; la disponibilidad depende del despliegue.

https://app.affine.pro/api/workspaces/{workspace-id}/mcp
  • doc_search
  • read_document

Contenido público del sitio

Servicio separado de solo lectura para artículos y plantillas publicados, sin cuenta ni credencial. No puede leer tu espacio ni escribir documentos. Nunca envíes tu credencial del espacio a este endpoint.

https://affine.pro/api/public/mcp
  • search_public_content
  • read_public_content
Public content API (English)

Conecta un cliente MCP compatible

Crea una credencial en AFFiNE y configura el cliente con su propio formato.

  1. Abre la configuración MCP de tu workspace

    En AFFiNE, ve a Configuración → Integrations → MCP Server. Funciona en AFFiNE Cloud y en instancias autoalojadas con las funciones de IA activadas.

  2. Crea una credencial

    Haz clic en 'Create credential', ponle una etiqueta (una por cliente, por ejemplo 'Claude Code' o 'Cursor') y elige el modo de acceso y la caducidad. El modo de solo lectura es el predeterminado.

  3. Pega la configuración en tu cliente

    Copia el endpoint y la credencial de AFFiNE. El token se muestra una sola vez. Utiliza el ejemplo correspondiente al cliente; no todos aceptan el mismo JSON.

{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}

Formato generado por AFFiNE; adáptalo al cliente. Las instancias autoalojadas usan su propia dirección.

Conexión cliente por cliente

Comprueba transporte y autenticación. Claude Code, Cursor y Cline admiten HTTP con encabezado Bearer. Una pantalla que solo acepta OAuth no puede usar esta credencial creada manualmente. El puente stdio requiere que el cliente pueda iniciar procesos locales.

Claude Code

Añade AFFiNE con un comando de CLI y pide a Claude buscar o leer tu workspace desde cualquier sesión.

claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"

Cursor

Añade URL y headers del ejemplo a ~/.cursor/mcp.json. Usa los valores copiados de tu espacio; los formatos JSON varían según el cliente.

{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Cline

Abre los ajustes MCP de Cline y añade AFFiNE como servidor Streamable HTTP remoto.

{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Clientes stdio locales, incluido Claude Desktop

Esta configuración ejecuta el puente de terceros mcp-remote en un cliente capaz de iniciar procesos stdio locales. Requiere una versión compatible de Node.js. No es un conector OAuth de Claude web.

{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"--header",
"Authorization:${AFFINE_MCP_AUTH}"
],
"env": {
"AFFINE_MCP_AUTH": "Bearer <your-credential>"
}
}
}
}

Qué puede hacer un asistente conectado

El modo predeterminado es solo lectura. La implementación revisada el 26 de octubre de 2026 limita las credenciales y herramientas de escritura a entornos de desarrollo o canary. Esto no demuestra disponibilidad en Cloud estable. Comprueba el modo de acceso y tools/list de tu instancia.

Solo lectura

Por defecto
doc_search
Búsqueda de documentos

Búsqueda por palabra clave y semántica en los documentos del workspace; devuelve pasajes acotados con ubicación de página o lienzo. Nunca archivos, blobs ni la web.

read_document
Leer documento

Obtiene el contenido completo de un documento por ID, respetando tus permisos actuales.

Lectura y escritura

Development / canary
create_document
Crear documento

Si está habilitado, crea un documento con título y cuerpo Markdown. No admite insertar bloques de base de datos ni imágenes.

update_document
Actualizar documento

Si está habilitado, actualiza el cuerpo Markdown mediante diferencias estructurales, sin cambiar el título. No admite actualizar bloques de base de datos ni imágenes.

update_document_meta
Actualizar metadatos

Si está habilitado, actualiza el título del documento. La herramienta revisada no expone otros campos de metadatos.

Limitado al workspace

Una credencial solo alcanza un workspace, con tus permisos.

Una credencial por cliente

Revoca el acceso de un cliente sin tocar los demás.

Caducidad integrada

Cada credencial recibe una fecha de caducidad al crearla.

Rotación de tokens

El token anterior dura hasta 24 horas o hasta su vencimiento original, lo que ocurra antes. Revocarlo puede terminar el acceso antes.

El servidor MCP de AFFiNE frente al resto

Muchas herramientas de notas ya hablan MCP. La diferencia está en qué alcanza el servidor, dónde corre y quién lo controla. Así se compara el servidor integrado de AFFiNE con las dos configuraciones más consultadas.

AFFiNENotion MCPObsidian
Integrado, oficialSíOficial e integrado en la aplicación; credenciales en la configuración del workspaceSíServidor remoto oficial, alojado por NotionNoPlugins comunitarios o servidores de terceros
AutoalojableSíEl mismo punto de acceso oficial; activa las funciones de IA en tu instanciaNoEl servidor actual es solo alojado; un predecesor open source descontinuado podía autoalojarseDependeLocalhost por defecto; lo remoto es artesanal
Búsqueda en pizarrasSíLa búsqueda indexa el texto del lienzo Edgeless y devuelve ubicaciones de elementos y marcosNoNotion no tiene pizarra nativaNoLos archivos .canvas solo se leen como JSON en bruto; ningún servidor de uso extendido permite buscarlos
Modelo de despliegueCloud o autoalojadoPunto de acceso oficial integrado en AFFiNE; en autoalojado hay que activar las funciones de IASolo alojadoEl servidor oficial actual lo aloja NotionLocalLos servidores comunitarios se ejecutan junto a la bóveda local de la aplicación de escritorio
PrecioGratisGratis en Cloud y autoalojado con las funciones de IA activadasNúcleo gratisLa búsqueda de apps conectadas y las notas de reunión requieren planes de Notion AIGratisTanto la aplicación como los servidores comunitarios

Comparación basada en capacidades documentadas públicamente, a agosto de 2026.

Los servidores MCP de Obsidian basados en la API REST requieren la aplicación de escritorio en ejecución. La CLI de Obsidian (2026) es una interfaz oficial de automatización, pero no es MCP.

Preguntas frecuentes

¿Qué es el servidor MCP de AFFiNE?

Es el punto de acceso oficial del Model Context Protocol integrado en AFFiNE. Permite que asistentes de IA como Claude, Cursor y Cline busquen y lean los documentos de uno de tus workspaces de AFFiNE por una conexión HTTP estándar y autenticada, con credenciales que creas y controlas en la configuración del workspace.

¿El servidor MCP es gratis?

Sí. Es gratis en AFFiNE Cloud y en instancias autoalojadas con las funciones de IA activadas. La conexión en sí no tiene coste adicional.

¿Una IA conectada puede buscar en mis pizarras?

Sí. doc_search cubre por igual documentos de página y pizarras Edgeless: el texto del lienzo se indexa y los resultados llevan ubicaciones de bloque, elemento o marco, así que el asistente puede señalar en qué parte de la pizarra está la respuesta. La lectura completa devuelve contenido de página; lo de las pizarras aflora por la búsqueda. La mayoría de servidores MCP de notas solo ven texto plano.

¿Funciona con AFFiNE autoalojado?

Sí. El punto de acceso MCP oficial está disponible en las instancias autoalojadas de AFFiNE: queda en la dirección de tu propio servidor y la configuración es idéntica (Configuración → Integrations → MCP Server). Las funciones de IA deben estar activadas en la instancia.

¿Puedo dejarlo en solo lectura?

El modo predeterminado es solo lectura. La implementación revisada el 26 de octubre de 2026 limita las credenciales y herramientas de escritura a entornos de desarrollo o canary. Esto no demuestra disponibilidad en Cloud estable. Comprueba el modo de acceso y tools/list de tu instancia.

¿Qué herramientas de IA pueden conectarse a AFFiNE?

Comprueba transporte y autenticación. Claude Code, Cursor y Cline admiten HTTP con encabezado Bearer. Una pantalla que solo acepta OAuth no puede usar esta credencial creada manualmente. El puente stdio requiere que el cliente pueda iniciar procesos locales.

¿Cómo se protege el acceso?

Una credencial solo alcanza un workspace, con tus permisos. Revoca el acceso de un cliente sin tocar los demás. Cada credencial recibe una fecha de caducidad al crearla. El token anterior dura hasta 24 horas o hasta su vencimiento original, lo que ocurra antes. Revocarlo puede terminar el acceso antes.

Pon tu base de conocimiento a trabajar

Crea una credencial en la configuración de tu workspace y tus herramientas de IA empezarán hoy mismo a responder desde tus propias notas.

Última actualización: 26 de octubre de 2026