Ir al contenido principal

Conexiones locales en la aplicación de escritorio

La aplicación de escritorio puede iniciar servidores MCP locales a través de stdio. Esto permite que la IA acceda a funciones ampliadas de Google y Microsoft, Nextcloud y otras herramientas que un navegador no puede ejecutar. El acceso local a archivos está integrado y no requiere un servidor MCP.

Incorporación

En la primera configuración, sigues estos pasos:

  1. Eliges una carpeta predeterminada local para las herramientas de archivos integradas.
  2. Opcionalmente, puedes elegir una conexión local para Nextcloud.
  3. Opcionalmente, puedes añadir otros servidores MCP desde la tienda de herramientas.

Puedes posponer toda la incorporación. La carpeta predeterminada y las conexiones adicionales se pueden configurar más tarde. Todas las elecciones de carpetas se guardan solo localmente.

La tienda de herramientas

Haz clic en Agregar herramientas o Agregar servidor MCP. Primero verás presets seguros que se ajustan a la aplicación de escritorio. Solo cuando eliges Agregar un servidor MCP manualmente se abre el formulario manual.

Los presets más usados incluyen:

PresetCapacidadesAutenticación
NextcloudArchivos, calendario y contactosDirección del servidor, nombre de usuario y contraseña de aplicación
MemoryGuardar y recuperar conocimientoAlmacenamiento local

La tienda también puede mostrar presets para servicios como GitHub, Canva, Notion, Supabase, Mailchimp y otros servidores MCP adecuados. La disponibilidad depende de la plataforma, autenticación y el catálogo actual.

Google y Microsoft

Google Workspace y Microsoft 365 son conexiones integradas de AI-School. Funcionan en web, móvil y escritorio y no dependen de OpenAI ni de un preset MCP local. Tras un permiso único de Google o Microsoft, las herramientas disponibles pueden usarse con OpenAI, Claude, Gemini y Mistral, siempre que el modelo elegido soporte el uso de herramientas.

Selección dinámica de herramientas

Un servidor MCP puede ofrecer decenas de herramientas. Por eso, el Desktop Deep Agent primero carga información compacta de las herramientas y selecciona las relevantes durante la tarea. Así, pueden estar activos varios servidores MCP grandes sin cargar todas las herramientas a la vez en el contexto del modelo.

Instalación segura

La instalación local de MCP tiene un límite estricto entre la interfaz Angular y Electron:

  • el renderer no inicia comandos shell arbitrarios;
  • se controlan comando, argumentos, claves de entorno y accesos solicitados;
  • un diálogo nativo muestra qué se está iniciando;
  • las configuraciones aprobadas reciben una prueba de integridad;
  • los secretos se cifran con el almacenamiento seguro del sistema operativo;
  • los procesos se detienen al apagar, eliminar, cerrar sesión o cerrar la aplicación.

Si eliminas un servidor, también se eliminan las credenciales almacenadas localmente.

Estado y pruebas

En En esta computadora ves todos los servidores locales activos en un solo lugar. En la configuración del chat, las conexiones locales y remotas están juntas bajo Conexiones.

Prueba un servidor con una pregunta concreta, por ejemplo:

  • “¿Qué carpetas hay en mi Nextcloud?”
  • “Busca los últimos correos electrónicos sobre el proyecto.”
  • “¿Qué archivos hay en esta carpeta local?”

Si hay problemas, revisa el registro de la aplicación de escritorio. Una conexión exitosa muestra el nombre del servidor y el número de herramientas cargadas.

Solución de problemas

  • Servidor activo pero la IA no ve herramientas: reinicia el runtime local y verifica que el ID del servidor esté en la solicitud del chat.
  • Falta autenticación: abre el servidor en Preferencias → Herramientas y elige reconectar.
  • Nextcloud no funciona: usa la URL base del entorno Nextcloud y una contraseña de aplicación separada.
  • Archivos locales no accesibles: verifica que la carpeta de trabajo activa aún exista y, si es necesario, selecciónala de nuevo desde el panel.
  • Demasiadas herramientas: deja activada la selección dinámica de herramientas y especifica claramente en tu pregunta qué fuente necesitas.

Añadir un servidor stdio manualmente

Se recomienda usar un preset. Añade un servidor manualmente solo si confías en su origen y comando. Antes de aprobar, verifica:

  • ejecutable y argumentos;
  • claves de entorno;
  • acceso al sistema de archivos;
  • capacidades de lectura y escritura.

Véase también

Acceso a carpetas locales

Las herramientas de archivos integradas solo pueden leer o modificar archivos dentro de la carpeta de trabajo que apruebes explícitamente mediante el selector nativo de carpetas.

Cada ruta se reduce a su ubicación canónica. Trucos con un prefijo similar de una carpeta adyacente y enlaces simbólicos que salgan de una carpeta aprobada serán rechazados. Tras reiniciar el runtime local, los permisos se sincronizan de nuevo; sin una carpeta aprobada, el acceso a archivos se deniega por defecto.

Si pides a la IA eliminar un archivo o subcarpeta, la aplicación de escritorio mueve el ítem a la papelera del sistema. Esto funciona en Windows, macOS y Linux. La carpeta principal aprobada no puede ser movida a la papelera mediante la IA.

WhatsApp