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.
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».
| Qué es | El punto de acceso oficial del Model Context Protocol, integrado en AFFiNE Cloud y en instancias autoalojadas |
|---|---|
| Punto de acceso | POST /api/workspaces/{workspace-id}/mcp |
| Transporte | Streamable HTTP, sin estado |
| Autenticación | Credencial Bearer (prefijo aff_mcp_v1.), creada por cliente en la configuración del workspace |
| Herramientas | doc_search / read_document; READ_WRITE: development / canary |
| Alcance | Un workspace por credencial, respetando tus permisos sobre los documentos |
| Precio | Gratis en AFFiNE Cloud y en instancias autoalojadas con las funciones de IA activadas |
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}/mcpdoc_searchread_documentServicio 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/mcpsearch_public_contentread_public_contentCrea una credencial en AFFiNE y configura el cliente con su propio formato.
En AFFiNE, ve a Configuración → Integrations → MCP Server. Funciona en AFFiNE Cloud y en instancias autoalojadas con las funciones de IA activadas.
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.
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.
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.
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>"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>"
}
}
}
}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>"
}
}
}
}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>"
}
}
}
}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.
doc_searchBú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_documentObtiene el contenido completo de un documento por ID, respetando tus permisos actuales.
create_documentSi está habilitado, crea un documento con título y cuerpo Markdown. No admite insertar bloques de base de datos ni imágenes.
update_documentSi 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_metaSi está habilitado, actualiza el título del documento. La herramienta revisada no expone otros campos de metadatos.
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.
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.
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| Integrado, oficial | SíOficial e integrado en la aplicación; credenciales en la configuración del workspace | SíServidor remoto oficial, alojado por Notion | NoPlugins comunitarios o servidores de terceros |
| Autoalojable | SíEl mismo punto de acceso oficial; activa las funciones de IA en tu instancia | NoEl servidor actual es solo alojado; un predecesor open source descontinuado podía autoalojarse | DependeLocalhost por defecto; lo remoto es artesanal |
| Búsqueda en pizarras | SíLa búsqueda indexa el texto del lienzo Edgeless y devuelve ubicaciones de elementos y marcos | NoNotion no tiene pizarra nativa | NoLos archivos .canvas solo se leen como JSON en bruto; ningún servidor de uso extendido permite buscarlos |
| Modelo de despliegue | Cloud o autoalojadoPunto de acceso oficial integrado en AFFiNE; en autoalojado hay que activar las funciones de IA | Solo alojadoEl servidor oficial actual lo aloja Notion | LocalLos servidores comunitarios se ejecutan junto a la bóveda local de la aplicación de escritorio |
| Precio | GratisGratis en Cloud y autoalojado con las funciones de IA activadas | Núcleo gratisLa búsqueda de apps conectadas y las notas de reunión requieren planes de Notion AI | GratisTanto 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.
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.
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.
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.
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.
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.
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.
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.
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