Saltar al contenido
Desarrolladores/Integración y modelo de datos

Integración MCP

El Gateway stdio local permite consultar archivos, objetos, relaciones y tablas y proponer cambios con ID y revisiones estables.

Conectar un espacio local

Abre o actualiza el espacio en escritorio y copia el inicio desde su panel MCP. Necesita Node.js 24.12 o superior. Los datos de aplicación deben quedar fuera del espacio y coincidir con el directorio del escritorio para compartir propuestas y actividad. Desde el código abierto:

npm run mcp:build
node apps/mcp/dist/tano-mcp.cjs --workspace /path/to/notes --data-dir /path/to/tano-app-data --access review
Acceso Operaciones
read Consultas y lecturas
review predeterminado Lecturas y propuestas pendientes
write Además, creación y actualización Markdown directa heredada

Repite --directory y --object-type para restringir alcances independientes. Reglas y salida del modelo no los amplían. Las propuestas entre recursos requieren revisión incluso con write.

Consultar contenido actual

Herramienta Resultado
tano_gateway_capabilities Identidad y permisos
tano_query_files / tano_read_file ID, rutas, propiedades, hashes y contenido
tano_query_objects Objetos tipados y revisiones
tano_query_table Registros, vistas y valores calculados
tano_query_relations Relaciones entre extremos autorizados
tano_read_workspace_rules Reglas conocidas

Antes de concluir que no hay resultados, revisa errores e integridad. Lee por ID, conserva hash y actualiza tras movimientos externos. Una ruta sola no identifica un archivo.

Presentar y revisar cambios

tano_propose_changes admite Markdown, JSON de objetos y .table.json. Envía operationId y cambios con path, content, reason, expectedHash; archivos existentes también necesitan fileId. Para nuevos, hash null. Repite un ID de operación solo con entrada idéntica.

Abre propuestas externas en historial del asistente, revisa cada diferencia y acepta/rechaza. tano_get_operation informa estados y recibos por elemento. Presentar no significa guardar; puede haber éxito parcial y no es una transacción de archivos indivisible.

Siguen disponibles tano_read_document_identity, tano_propose_document y tano_get_proposal. Markdown puede ir a revisión individual; tablas y objetos permanecen en el asistente.

Escrituras directas y actividad

tano_list_documents y tano_read_document son lecturas heredadas. tano_create_document y tano_write_document requieren --access write. Las actualizaciones comparan expectedHash con SHA-256 actual; crear no sobrescribe rutas existentes.

Tras rechazo relee y combina, sin reemplazar solo el hash del texto antiguo. tano_list_activity y tano_read_activity muestran operaciones y diferencias; las etiquetas no autentican al cliente.

Es stdio local, no servidor colaborativo ni ejecutor de terminal. Datos de aplicación ocultos y enlaces fuera del espacio quedan fuera del alcance. Consulta agentes, archivos y la guía del código fuente.