Documentation menu

Conecta tu asistente de IA

Manisma puede conectarse a un asistente de IA que ya utilizas, como Claude Desktop, Claude Code, la aplicación de escritorio de ChatGPT o Codex CLI. La conexión utiliza el protocolo abierto Model Context Protocol. Después puedes hacer preguntas y realizar tareas de planificación en la ventana de chat de tu asistente.

Tu asistente, tu IA

Tu propio asistente es quien piensa. Manisma proporciona la planificación y los datos, pero no ejecuta su propia IA para esta conexión. Tampoco consume las acciones de IA incluidas en tu plan de Manisma.

El botón Propuesta IA de Manisma es independiente. Esa función sí utiliza la IA de Manisma y las acciones de IA de tu plan.

Lo que puede hacer tu asistente

Tu asistente puede buscar órdenes de trabajo, clientes, técnicos, materiales, tipos de tarea y dispositivos. Puede crear y actualizar órdenes de trabajo y clientes, programar una orden de trabajo con un técnico y solicitar una propuesta de planificación. Nunca puede eliminar nada.

Crear una clave

Abre Administración → Claves API, crea una clave y cópiala de inmediato. La clave se muestra una sola vez. La lectura, la escritura y la planificación son permisos separados. Por eso, una clave de solo lectura puede consultar información, pero no modificarla. Trata la clave como una contraseña.

Instalar la conexión

Todas las rutas requieren Node.js 22 o una versión posterior. Comprueba la versión instalada:

node --version

Obtén la clave API en Administración → Claves API. Solo se muestra una vez y tiene el formato msk_ seguido de 40 caracteres hexadecimales. La lectura, la escritura y la planificación son permisos separados.

Ruta 1: Claude Desktop

  1. Descarga https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abre el archivo descargado. Claude Desktop muestra un diálogo de instalación.
  3. Pega la clave API cuando se solicite. Se almacena de forma segura.

No necesitas editar archivos ni usar un terminal.

Ruta 2: Claude Code

  1. Descarga https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abre un terminal en la carpeta de descarga y ejecuta:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Sustituye msk_your_key_here por la clave API.
  2. En Claude Code, usa el comando /mcp para comprobar la conexión.

Ruta 3: Codex CLI y la aplicación de escritorio de ChatGPT

  1. Descarga https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abre un terminal en la carpeta de descarga y descomprime el archivo:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Añade este bloque a ~/.codex/config.toml y sustituye la ruta y la clave. La ruta debe ser absoluta, porque ~ no se expande en este archivo.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Ejecuta codex mcp list. Debe mostrar manisma como enabled.

En Windows, el archivo .mcpb es un archivo ZIP. Si Windows no lo descomprime, cambia la extensión a .zip y usa Extraer todo.

Qué puedes esperar

Tu asistente pide confirmación antes de cambiar nada y gestiona una orden de trabajo cada vez. Una propuesta de planificación se muestra primero y no se aplica hasta que la confirmes.

El asistente no puede ver las horas de trabajo ni los días libres. Comprueba una hora propuesta con el calendario real. Las propuestas de planificación se limitan a unas pocas solicitudes cada diez minutos.

Limitaciones

La conexión funciona con los datos guardados en Manisma. No sustituye el tablero de planificación y solo está tan actualizada como lo que se ha guardado.