Conectar asistentes de IA (MCP)

CUTL puede trabajar dentro de tu asistente de IA. En lugar de ir haciendo clic por la aplicación web, le dices a Claude, ChatGPT, Gemini o Cursor lo que quieres con palabras normales ("Crea un proyecto para Van Dijk con estos tres DXF, S235 de 3 mm, 50 de cada uno, y dime el total") y el asistente lo hace en CUTL por ti: crea el proyecto, añade los planos, lee el presupuesto, lo envía por correo, lanza la producción, ejecuta el anidado, lee informes, abre modelos STEP, presupuesta ensamblajes y configura tu taller.

Qué es MCP

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para llamar a herramientas externas. CUTL ejecuta un servidor MCP: un conjunto de herramientas que tu asistente puede llamar en tu nombre, con los permisos de tu rol en tu equipo.

Todo lo que hace el asistente ocurre como tú y aparece en CUTL al momento como proyectos, piezas, presupuestos y tareas de producción normales. Lo que hace cada herramienta se explica en Qué pueden hacer los asistentes de IA.

Conjuntos de herramientas y sus direcciones

Las herramientas de CUTL se agrupan en conjuntos de herramientas. Cada conjunto tiene su propia dirección de servidor y se añade al asistente como un conector aparte. Añade solo los que uses: un asistente elige peor las herramientas de una lista muy larga, y un presupuestador normalmente solo necesita Básico.

Token o inicio de sesión

Hay dos formas de conectar un asistente. En ambos casos actúa como tú: puede leer y cambiar exactamente lo que tu rol en CUTL te permite leer y cambiar, nada más.

La pestaña Integraciones

Todo lo relativo a los asistentes está en la página Configuraciones, pestaña Integraciones. De arriba abajo muestra:

1. Conectar un asistente de IA: las URL de los servidores, cada una con un botón Copiar; Conjunto de herramientas para los ejemplos, un selector que decide qué dirección usan los textos de configuración (de entrada está elegido Básico); una pestaña por asistente con su texto de configuración y Copiar; el aviso sobre el token; una línea sobre datos y privacidad; y los Límites de monedas del asistente.
2. La lista de tokens, con Generar token. Contiene todos los tokens del equipo con su etiqueta, quién lo creó, cuándo caduca, cuándo se usó por última vez y su estado (Activo, Expirado, Revocado), y un botón Revocar.
3. Asistentes conectados: los asistentes que conectaste iniciando sesión, cada uno con Desconectar.
4. Clientes registrados: solo para los administradores del equipo.

Si un bloque no se puede cargar, simplemente no se muestra y el resto de la pestaña sigue funcionando.

Crear un token

El token se rellena en el texto de configuración solo en esta página, hasta que sales de ella o la recargas. Si lo pierdes, revócalo y crea uno nuevo.

Un equipo puede tener como máximo 5 tokens activos. Un sexto se rechaza con "Revoca primero un token sin usar: máximo 5 activos." Cualquier miembro puede crear un token y revocar cualquier token del equipo. Un token siempre actúa como la persona que lo creó, y deja de funcionar si esa persona sale del equipo.

Conectar cada asistente

La pestaña de cada asistente en Configuraciones > Integraciones tiene su propio texto de configuración con un botón Copiar. Los menús dentro de los asistentes cambian a menudo: consulta la documentación actual del proveedor si un nombre no coincide.

Claude Code (token)

Crea un token en la pestaña Claude Code, copia el comando y ejecútalo en tu terminal. Añade un servidor llamado cutl:

claude mcp add --transport http cutl https://api.cutl.online/mcp --header "Authorization: Bearer <token>"

Para otro conjunto de herramientas, cambia Conjunto de herramientas para los ejemplos, vuelve a copiar el comando y cambia el nombre cutl (por ejemplo a cutl-step), porque dos servidores no pueden compartir nombre. El mismo token sirve para todos los conjuntos.

Claude Code también puede iniciar sesión: ejecuta el comando sin la parte --header y sigue el aviso de inicio de sesión de Claude Code. CUTL muestra entonces la página de consentimiento.

Cursor (token)

Crea un token en la pestaña Cursor y pon el bloque en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json de un proyecto. Si el archivo ya tiene una sección "mcpServers", añade dentro solo la entrada "cutl". Después reinicia Cursor o recarga sus servidores MCP.

{
  "mcpServers": {
    "cutl": {
      "url": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Gemini CLI (token)

Crea un token en la pestaña Gemini CLI y añade la entrada "cutl" bajo "mcpServers" en el settings.json de Gemini CLI. Es el mismo bloque que para Cursor, con "httpUrl" en lugar de "url". Después reinicia Gemini CLI.

{
  "mcpServers": {
    "cutl": {
      "httpUrl": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Claude.ai y Claude Desktop (inicio de sesión)

Copia la dirección desde la pestaña Claude.ai / Desktop. En Claude, ve a Settings, Connectors, Add custom connector y pégala. Claude abre CUTL: inicia sesión si te lo pide, revisa la página de consentimiento y pulsa Conectar. No hace falta token. En una organización de Claude Team o Enterprise, un propietario añade el conector y después los miembros se conectan. Para otro conjunto de herramientas, añade otro conector con la dirección de ese conjunto.

ChatGPT (inicio de sesión)

Solo ChatGPT Business, Enterprise o Edu, y solo en la aplicación web. Copia la dirección desde la pestaña ChatGPT, activa el modo de desarrollador en ChatGPT, añade un conector con la dirección e inicia sesión en CUTL. No hace falta token. ChatGPT también puede pasar directamente a CUTL los archivos que adjuntas en el chat.

Gemini Enterprise (inicio de sesión con un cliente registrado)

1. Un administrador del equipo de CUTL registra un cliente (consulta Clientes registrados) con la dirección de redirección que le da el administrador de Gemini Enterprise, y le pasa el ID de cliente y el Secreto del cliente.
2. El administrador de Gemini Enterprise añade la dirección de CUTL como conector, con OAuth, ese ID de cliente y ese secreto, y activa PKCE.
3. Un usuario del conector llega a la página de consentimiento de CUTL, que muestra Registrado por su equipo, y pulsa Conectar.

La página de consentimiento

Cuando un asistente se conecta iniciando sesión, CUTL muestra la página Conectar un asistente (después del inicio de sesión normal de CUTL si no has iniciado sesión). Muestra:

• qué asistente quiere conectarse;
• Después de decidir, se le envía a: la dirección a la que el asistente te devolverá, por ejemplo claude.ai. Comprueba que es la dirección de tu asistente; si no lo es, pulsa Denegar;
• Identificado por: Una identidad de cliente publicada (el asistente publicó su identidad en su propia dirección web, como hace Claude), Autorregistro (no verificado) (CUTL no puede garantizar quién lo gestiona) o Registrado por su equipo;
• Equipo y Sesión iniciada como: el equipo y la persona como la que actuará el asistente, y el Conjunto de herramientas;
• Podrá: "Usar CUTL en su nombre, con sus permisos" y "Seguir conectado hasta que lo desconecte";
• que el proveedor del asistente verá lo que el asistente lea de CUTL, como nombres de proyectos, presupuestos y datos de clientes;
• una cuenta atrás: la solicitud caduca en 10 minutos.

Pulsa Conectar para permitirlo o Denegar para rechazarlo; en ambos casos vuelves al asistente. Una solicitud abierta después de 10 minutos, por segunda vez o por otra persona muestra "Esta solicitud ha caducado o ya se usó: inicie la conexión de nuevo desde su asistente."

El asistente renueva su acceso por sí solo y sigue conectado mientras use CUTL al menos una vez cada 30 días. Para terminarlo al instante, pulsa Desconectar en Asistentes conectados. Quitar el conector dentro del asistente no termina la conexión en el lado de CUTL: desconéctalo también en CUTL. Cada persona ve solo sus propias conexiones.

Clientes registrados (administradores del equipo)

Para asistentes que no pueden registrarse solos, como Gemini Enterprise, un administrador del equipo registra un cliente en Clientes registrados, Registrar un cliente:

Después de Registrar, la ventana Cliente registrado muestra el ID de cliente y el Secreto del cliente. El secreto se muestra una sola vez y no se puede recuperar después: copia ambos y pulsa Ya lo he copiado. Eliminar borra un cliente, y los asistentes que lo usan dejan de funcionar. Si pierdes el secreto, tienes que eliminar el cliente y registrar uno nuevo.

Límites de monedas del asistente

Algunas herramientas gastan monedas, exactamente igual que la misma acción en CUTL: añadir un plano a un proyecto (un cálculo de pieza por pieza), copiar un proyecto (un cálculo por pieza) y valorar las piezas de un ensamblaje (un cálculo de pieza por cada pieza iniciada). Todas las demás herramientas son gratuitas. El asistente puede decirte los precios y tu saldo. Consulta Monedas y facturación.

Además de tu saldo, los Límites de monedas del asistente del equipo fijan un tope a lo que pueden gastar entre todos los asistentes del equipo, sea cual sea la persona o el token que lo gastó. No limitan lo que las personas gastan en la aplicación web.

Debajo de los campos ves lo que se ha usado en la última hora y hoy. Solo un administrador del equipo puede cambiar los límites, con Guardar y Restablecer valores predeterminados; los demás los ven en solo lectura. Cada límite debe ser mayor que 0, el límite por llamada no puede superar el límite por hora y el límite por hora no puede superar el diario. Un campo vacío significa "usar el valor predeterminado", y los valores predeterminados se rellenan antes de estas comprobaciones: con el límite por llamada predeterminado de 2.000, un límite por hora de 1.000 se rechaza hasta que bajes también el límite por llamada.

Cuando una llamada superaría un límite, el asistente te dice cuál, cuánto queda y cuándo vuelve a haber margen, por ejemplo "Esta llamada costaría 2.500 monedas; el tope por llamada para asistentes es de 2.000. Divide el trabajo en llamadas más pequeñas o sube el tope en la página Connect." La "página Connect" de estos mensajes es la pestaña Integraciones.

Preguntar el precio primero

Las tres herramientas de pago pueden hacer una simulación: lo comprueban todo (archivos, materiales, el estado del proyecto) y dicen cuánto costaría, sin hacer ni cobrar nada. Pregunta al asistente "¿Cuánto costaría eso? No lo hagas todavía" y después "Vale, hazlo". Una simulación no comprueba los límites de monedas; la llamada real sí. Repetir la misma subida nunca cobra dos veces.

Llevar archivos a CUTL: el enlace de subida

Los asistentes en un navegador o en un móvil no siempre pueden pasar un archivo, así que CUTL da a todos los asistentes un enlace de subida.

Un archivo de otro tamaño se rechaza: "Este no es el archivo que anunció el asistente (se esperaban 49.352 bytes). Pídele un enlace nuevo." Un nombre distinto con el tamaño correcto solo da un aviso y se sube igualmente. Un enlace caducado dice "Este enlace ha caducado: pídele al asistente uno nuevo." La parte secreta del enlace se quita de la barra de direcciones en cuanto se abre la página, así que si recargas la página verás que el enlace está incompleto o dañado: vuelve a abrir el enlace original desde el chat.

Los asistentes que funcionan en tu ordenador (Claude Code, Cursor, Gemini CLI) pueden subir el archivo por sí mismos. Para un proyecto, un asistente también puede dar a CUTL un enlace https público a un plano, y ChatGPT puede pasar un archivo que hayas adjuntado en el chat. Los archivos para las herramientas de STEP y de ensamblajes llegan solo mediante un enlace de subida.

Acciones que confirmas

Las acciones que llegan a personas fuera de la conversación las retiene el servidor de CUTL hasta que las confirmas, decida lo que decida el asistente.

En el chat, el asistente te muestra primero una vista previa de lo que va a hacer, y solo actúa cuando estás de acuerdo.

En la página de confirmación, el asistente te da un enlace. Ábrelo con la sesión iniciada en CUTL como la misma persona como la que actúa el asistente, revisa la vista previa (una dirección nueva aparece resaltada) y pulsa Confirmar o Rechazar. Después vuelve al asistente y dile que continúe: la página en sí no hace nada. Una confirmación caduca 10 minutos después de que el asistente la pidiera. Después, la página muestra uno de estos mensajes:

• "Hecho: vuelva a su asistente y dígale que continúe."
• "Rechazado. No se hizo nada; puede volver a su asistente."
• "Hecho: el asistente ya lo ha llevado a cabo."
• "Esta confirmación ha caducado. Pida a su asistente que empiece de nuevo."
• "Esta confirmación no existe o pertenece a otra persona." (un enlace erróneo, o el de otra persona)

Límites y errores

El asistente no puede pulsar botones donde CUTL quiere a una persona: confirmar un lanzamiento, revisar las lecturas de un enriquecimiento, elegir planos de un PDF con varios planos o responder a una pregunta de PDF a STEP. Te dice que hagas ese paso en CUTL y continúa después.

El servidor demo

Para probar CUTL desde un asistente sin cuenta, conecta el servidor demo sin autenticación:

claude mcp add --transport http cutl-demo https://mcp-demo.cutl.online/mcp/demo

En otros asistentes, añade https://mcp-demo.cutl.online/mcp/demo como servidor sin token y sin inicio de sesión. Es un taller de chapa ficticio con seis herramientas de solo lectura: buscar proyectos, estado de la producción, explicar el precio de una pieza, informes, consultar materiales y clientes, y resultados de anidado. Allí no se puede crear, cambiar, subir, enviar ni cobrar nada. Prueba "¿Qué hay en producción hoy?" o "¿Por qué la pieza X cuesta tanto?". Demasiadas llamadas reciben "Demasiadas solicitudes a la demo de CUTL; inténtalo de nuevo en breve".

Privacidad

• Todo lo que devuelve una herramienta (nombres de proyectos y piezas, nombres y direcciones de clientes, precios, comentarios, informes) lo lee el asistente, que se ejecuta en su proveedor (Anthropic, OpenAI, Google, etc.) según las condiciones de ese proveedor. Conecta solo asistentes a los que confíes esos datos, y solo los conjuntos de herramientas que necesites.
• Los archivos que sueltas en la página de subida van directamente al almacenamiento de CUTL, no pasan por el asistente.
• CUTL no ve tu conversación, solo las llamadas a herramientas y sus datos de entrada. Cada llamada a una herramienta queda registrada en CUTL.
• El texto escrito por personas (nombres, comentarios, textos de planos) se entrega al asistente como datos de los que no debe aceptar instrucciones, y CUTL aplica las reglas de confirmación anteriores decida lo que decida el asistente.
• Los informes de errores enviados a través del asistente llevan tus identificadores de usuario y de equipo, no tu dirección de correo electrónico.