Conectar agentes de IA externos con MCP
Da a Claude Code, Cursor, VS Code, OpenCode o Codex herramientas acordes al rol para el proyecto abierto en Kosmico escritorio.
Kosmico puede exponer el proyecto abierto en la aplicación de escritorio como servidor local de Model Context Protocol. Claude Code, Cursor, VS Code, OpenCode y Codex pueden trabajar así sobre el proyecto vivo en vez de una carpeta copiada o un volcado de contexto.
Kosmico es el servidor MCP en esta configuración. No se conecta como cliente a servidores MCP arbitrarios de terceros.
Antes de empezar
- Mantén abierta la aplicación de escritorio para macOS o Windows con el proyecto correcto.
- Instala Node.js 18 o posterior para que el cliente externo pueda iniciar
@kosmico/mcp-servermediantenpx.
La aplicación web no puede alojar el puente local. Los proyectos remotos por SSH no se registran en él.
Activar el servidor
Abre Configuración → Conexiones → Servidor MCP y activa el servidor. La configuración indica si está en marcha y qué proyecto está exponiendo.
Elige Claude Code, Cursor, VS Code, OpenCode o Codex en el panel de configuración. Kosmico genera el comando o la configuración completa para ese cliente. Copia el valor generado en lugar de adaptar el ejemplo de otro cliente, porque cambian los formatos y los selectores de capacidades.
Elegir las herramientas disponibles
Usa la conexión completa de compatibilidad cuando el cliente espere un único servidor amplio. Para un esquema menor, selecciona paquetes de capacidades y conéctalos como servidores con nombres independientes:
- espacio de trabajo
- investigación
- documentos Word
- presentaciones
- notebooks
- panel
- Mapa del proyecto
- Mapa de investigación
- colaboración
- LaTeX
- ejecución
Cada conexión seleccionada conserva el descubrimiento del espacio de trabajo abierto. El paquete de ejecución es opcional porque puede iniciar comandos de shell y celdas de notebook en el equipo de escritorio.
Proyectos locales, en la nube y compartidos
| Proyecto abierto | Qué expone MCP |
|---|---|
| Carpeta local | El espacio de trabajo registrado y sus herramientas nativas disponibles |
| Proyecto solo en la nube o compartido | Archivos autenticados y herramientas permitidas por tu rol actual |
| Proyecto remoto por SSH | No disponible mediante MCP |
| Aplicación web sin escritorio | No disponible |
Los permisos se vuelven a comprobar en cada llamada a la nube. Los Propietarios reciben toda la superficie de archivos, incluida la eliminación confirmada. Los Editores pueden cambiar archivos, pero no eliminarlos. Los Lectores reciben herramientas de solo lectura. Los textos y notebooks en la nube funcionan mediante el proyecto compartido; los binarios y PDF siguen necesitando una carpeta local.
Seguridad y actualizaciones
El puente es un stdio local alojado por la aplicación de escritorio en marcha. Kosmico no publica un endpoint MCP HTTP u OAuth. Mantén privada la configuración generada y activa la ejecución solo para agentes a los que confiarías el proyecto y la terminal.
La configuración avisa cuando el paquete MCP local es más antiguo que la versión esperada por la aplicación. Reiniciar el cliente externo suele permitir que npx obtenga la versión nueva; la configuración también explica cómo vaciar la caché cuando haga falta.