Sin conexión con el hardware
El servidor MCP y el host de gemelos solo inician y controlan máquinas simuladas. No tienen conexión serie ni de red con una MC-1 real; en modo sombra, la IA solo puede leer.
IA y MCP
Dele a su IA una máquina que no pueda romper.
Los modelos de lenguaje escriben código G que parece correcto. Studio le dice si lo es. Su servidor MCP integrado permite que un asistente de IA monte un bruto, haga que el CAM de Studio escriba el programa, lo ejecute en un gemelo y consulte qué ocurrió — alarmas, colisiones, fuerzas, vibración, la forma de la pieza — y después lo haga más rápido.
Cómo encaja todo
Su cliente de IA inicia TwinwrightStudio.exe --mcp, que se conecta a un host de gemelos en su equipo. El host conserva sus gemelos de una conversación a otra: de forma predeterminada, un gemelo de práctica (sandbox), y la máquina de su ventana solo cuando usted activa su acceso de IA. Cada simulación se ejecuta más rápido que en tiempo real en una copia oculta del amarre, a partir de la pieza tal como está ahora o, si se pide, de un bruto nuevo.
Cliente de IAClaude · ChatGPT · Cursor · VS Code · LM Studio
MCP (stdio o HTTP)
TwinwrightStudio.exe --mcp47 herramientas · 3 recursos · 3 prompts
local, con un token
Host de gemelosgemelo de práctica (sandbox) · su ventana, con su aprobación
sin conexión
MC-1fuera del alcance de la IA
Dos formas de conectar una IA
Use el cliente de IA que ya tiene o converse con un modelo dentro de Studio. Las dos formas usan las mismas herramientas MCP en los mismos gemelos.
Su cliente de IA, a través de MCP
Active la IA y haga clic en “Conectar”.
Studio escribe la entrada en la configuración de su cliente, después de mostrarle el cambio, o abre el enlace de instalación del propio cliente. Para cualquier otro cliente MCP, tiene el comando o la dirección local listos para pegar.
- Claude Desktop y ChatGPT para escritorio (modos Codex y Work): Studio escribe la configuración por usted
- Cursor, VS Code (GitHub Copilot) y LM Studio: sus enlaces de instalación con un clic
- Claude Code, Cherry Studio, Trae, Kimi Code y otros: copiar el comando o la dirección HTTP
El asistente integrado en Studio
Use su propia clave o un modelo local.
El panel de IA se comunica con Anthropic, OpenAI, DeepSeek, Qwen (Bailian), Kimi, Zhipu GLM o cualquier servicio compatible con OpenAI, o con un modelo en su propio equipo en LM Studio u Ollama. Puede adjuntar el programa, el amarre y los resultados de la comprobación de la ventana, y muestra las imágenes del gemelo en la conversación.
- Las claves se cifran con Windows DPAPI y solo se envían al proveedor que usted elija
- Con un modelo local, nada sale de su equipo
- “Copiar para una IA” y “Pegar desde la IA” funcionan con cualquier aplicación de chat, sin MCP
Lo que puede hacer la IA
Cuarenta y siete herramientas MCP. Cada una devuelve un breve resumen con el que el modelo puede razonar y datos estructurados con un esquema, y cada resultado indica la máquina de la que procede.
| Máquina | |
|---|---|
machine_status | estado, alarma y su significado, búsqueda de referencia, posiciones, herramienta, bruto; las demás máquinas |
machine_control | referenciar, desbloquear, reiniciar, retener el avance, reanudar, parar, mover, encender o apagar, parada de emergencia |
machine_mdi | líneas MDI de una en una, una respuesta por línea; se detiene en el primer rechazo |
licence_status | la edición, hasta cuándo es válida y qué funciones incluye |
machine_library | la biblioteca de máquinas de la ventana |
| Amarre | |
setup_workpiece | colocar o retirar un bruto en una mordaza, bajo bridas o sobre cinta — o su propio STL |
setup_tool | la herramienta en el husillo y la tabla de herramientas para M6 |
setup_work_zero | G54 en una esquina o en el centro del bruto |
setup_part | la pieza diseñada (STL) con la que comparar |
setup_copy · setup_example | copiar un amarre a otro gemelo, incluido lo ya mecanizado; preparar uno de los ejemplos |
| CAM | |
geometry_import | guardar una forma — SVG, DXF, texto, una fórmula, formas simples o puntos — con un nombre, una versión, un resumen y una vista previa |
program_generate | el CAM: un programa a partir de formas y operaciones, en 2.5 o 3 ejes, con el motivo de cada valor de corte, probado en una ejecución de prueba |
geometry_nest | colocar piezas en una placa, las pequeñas dentro de los huecos de las grandes, con puentes de sujeción (Pro) |
job_get · job_edit | leer el trabajo de CAM de un programa y cambiarlo (valores, operaciones añadidas, quitadas o movidas) como la versión siguiente del programa |
| Palpador e inspección | |
probe_cycle | borde, esquina, agujero, saliente, cara superior o calibración en anillo patrón, probado primero en el gemelo; el origen de pieza solo se fija con su aprobación |
inspect_part | medir la pieza terminada frente al diseño: cajeras, contornos, agujeros, salientes, chaflanes y ranuras en V, según ISO 2768 o ISO 286 (Pro) |
inspect_report | el registro de inspección en CSV y PDF, regenerado byte a byte y encadenado en el registro de auditoría (Pro) |
setup_sheet | una hoja de amarre imprimible: bruto, amarre, herramientas, cero, espacio sobre el bruto, operaciones y tiempos (Pro) |
| Programa | |
program_check | el modo de comprobación del controlador, la vista previa de la trayectoria frente al amarre y las 15 reglas estáticas |
program_simulate | ejecutar hasta el final en una copia oculta, desde la pieza tal como está o desde un bruto nuevo: tiempo, alarmas, colisiones, rápidos que cortan material, cargas, vibración, desviación de la pieza |
program_run · program_load | ejecutar o cargar en la propia máquina (la máquina de su ventana le pregunta antes) |
program_debug · program_restart | ejecutar hasta una línea, inspeccionar, avanzar bloque a bloque; el bloque de inicio para un rearranque |
program_edit · program_optimize | modificar un programa describiendo el cambio (avances, velocidades, desplazamiento en Z, altura de seguridad), como versión nueva; el optimizador |
program_versions | listar, obtener, guardar y comparar versiones |
| Ejecuciones y resultados | |
run_status · run_profile | esperar o detener una ejecución larga; el perfil por línea |
result_compare | la desviación respecto a la pieza diseñada, en cifras |
result_image | imágenes: pieza, trayectoria de herramienta, mapa de desviaciones, líneas más lentas, curvas en el tiempo, comparación A/B |
log_query | buscar en el registro de auditoría: quién hizo qué, cuándo y en qué máquina |
result_export | la pieza mecanizada como archivo STL o mapa de alturas |
| Biblioteca de piezas | |
part_save · part_list · part_get | guardar una pieza mecanizada con la versión del programa, el origen de pieza, el bruto, el amarre y las mediciones; listar los registros, leer uno |
part_load · part_export | preparar la máquina para hacer la pieza otra vez; exportar la pieza de un registro |
part_update · part_delete | nombre, etiquetas y notas; borrar o restaurar un registro |
| La ventana y la ayuda | |
window_show | mostrarle, mientras explica, un espacio de trabajo, una cara de la vista 3D, la trayectoria del programa o un paso del panel Preparación |
settings | leer los ajustes de la ventana; cambiar el idioma, la región, las unidades, la moneda o la tarifa por hora de máquina solo después de que usted pulse Permitir |
manual_search | buscar en el manual de Studio y responder con él |
report_draft · report_list | redactar un informe de problema para que usted lo lea y lo envíe; el estado de sus informes y nuestras respuestas |
Una sesión, tal como ocurrió
Llamadas reales a Studio 1.0 por MCP el 9 de octubre de 2026. Un script hace de cliente de IA; los resultados de las herramientas MCP son los del gemelo, abreviados.
Usted
Aquí tiene un programa de cajera para un bloque de 6061 de 60 × 40 × 10 mm sujeto con bridas. Compruébelo en la MC-1 antes de mecanizarlo.
Asistente
Voy a sujetar el bruto con bridas en el gemelo de práctica, montar la fresa plana de 6 mm en el husillo, poner G54 en la esquina superior delantera izquierda del bruto y ejecutar el modo de comprobación del controlador.
Herramienta MCP
setup_workpiece → {"placed": true, "material": "6061-T6", "fixture": "clamps", "mass_g": 64.8}
setup_tool → {"tool": "flat 6 n3 L20", "stick_out_offset_mm": 4.5}
setup_work_zero → {"g54_mpos": [-130.002, -95.002, -65.501]}
program_check → {"refused": [{"line": 14, "code": 2, "text": "G1 X42 F",
"error": "A number is missing or is not a valid number."}]}
Asistente
La línea 14 tiene una F sin valor. Con eso corregido, el controlador acepta todas las líneas, pero la vista previa frente al amarre aún encuentra dos problemas antes de que se mueva nada.
Herramienta MCP
program_check → {"refused": [], "preview": {"issues": [
{"line": 9, "kind": "rapid_cut", "text": "Line 9: a rapid move (G0) cuts 1.00 mm into the workpiece"},
{"line": 58, "kind": "collision", "text": "Line 58: tool hit clamp 2 strap (X 80.966 Y 62.049 Z -60.501)"}]},
"static_rules": [{"line": 9, "rule": "S10", "severity": "warning"}]}
Asistente
Para ver qué efecto tendrían, lo ejecuté hasta el final en una copia oculta del amarre.
Herramienta MCP
program_simulate → {"completed": false, "simulated_time_s": 85.64, "final_state": "Alarm", "issues": [
"1 collision(s): tool/clamp2_strap at machine position [80.97, 62.05, -60.50] mm",
"5 rapid move(s) into material (28.215 mm3 cut at rapid rate)",
"drive alarm(s): X following error",
"lost steps X/Y/Z: 320 34 0 (1.25 um each): the drives fell behind",
"chatter on 27 line(s) (10-18, 26-34, 42-50), worst at line 26: stability margin 1.88 > 1 - the cut there is
1.00 mm deep, 1.9 times the stable depth (about 0.53 mm) at S15300; cut at most 0.43 mm deep there …",
"ALARM:17 - A motor drive reports a fault.", …], "run": "r1"}
Asistente
Dos problemas reales y un tercero que conviene saber. En la primera capa, la herramienta penetra en el bloque en rápido, y el G0 X0 Y0 final la lleva contra la brida delantera izquierda: los accionamientos dan fallo y la máquina se detiene. Cambié la penetración a G1 Z-1 F150 y ahora la retiro al final con G53 G0 Z-2, lejos de las bridas. El gemelo también ve vibración: capas de 1 mm son unas dos veces la profundidad estable de esta herramienta a 15,300 rpm.
Herramienta MCP
program_simulate → {"completed": true, "simulated_time_s": 88.51, "issues": [
"chatter on 27 line(s) (10-18, 26-34, 42-50), worst at line 42: stability margin 1.88 > 1 - …
cut at most 0.43 mm deep there …"],
"material_removed_mm3": 1776.79, "replay_hash": "964c15c53873b6b6", "run": "r2"}
Asistente
Sin colisión ni cortes en rápido: 1 min 29 s de tiempo de máquina y 1,777 mm³ de material arrancado — la cajera de 30 × 20 × 3 mm menos lo que dejan en las esquinas los radios de la herramienta. La vibración sigue hasta que las capas sean más finas: 0,43 mm como máximo. El optimizador solo cambia avances; encuentra algo de tiempo y deja la profundidad en sus manos.
Herramienta MCP
program_optimize → {"optimized": true,
"verdict": "3.22 s faster (3.6 %), no line cuts heavier than the original's heaviest",
"plan": {"changes": [{"line": 19, "what": "F", "before": 600, "after": 750,
"why": "a lighter cut: up to the spindle load limit"}, …],
"notes": "Tool 0 still chatters (margin 1.88): … a shallower cut does."},
"saved": {"name": "pocket_v3.nc", "version": 1}}
Asistente
Las dos versiones están guardadas. Antes de mecanizar, yo haría capas de 0,4 mm para que el gemelo ya no vea vibración. ¿Lo hago?
Lo que ve la IA
result_image dibuja los resultados del gemelo como imágenes, con las cifras clave en texto al lado. Estas tres salen de la sesión anterior.
Configuración
En Studio: active la IA, después IA ▾ → Conectar clientes de IA, y elija el suyo. Para configurar un cliente a mano, haga que ejecute TwinwrightStudio.exe (instalado en %LOCALAPPDATA%\Programs\Twinwright Studio) con el argumento --mcp:
Claude Desktop · claude_desktop_config.json
{
"mcpServers": {
"twinwright": {
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\Twinwright Studio\\TwinwrightStudio.exe",
"args": ["--mcp"]
}
}
}ChatGPT para escritorio · %USERPROFILE%\.codex\config.toml
[mcp_servers.twinwright]
command = 'C:\Users\<you>\AppData\Local\Programs\Twinwright Studio\TwinwrightStudio.exe'
args = ["--mcp"]VS Code · .vscode/mcp.json
{
"servers": {
"twinwright": {
"type": "stdio",
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\Twinwright Studio\\TwinwrightStudio.exe",
"args": ["--mcp"]
}
}
}Línea de comandos
# Claude Code
claude mcp add twinwright -- "C:\Users\<you>\AppData\Local\Programs\Twinwright Studio\TwinwrightStudio.exe" --mcp
# cualquier cliente por HTTP, solo en este equipo
"C:\Users\<you>\AppData\Local\Programs\Twinwright Studio\TwinwrightStudio.exe" --mcp-http 8766 --mcp-token <your token>
# punto de conexión http://127.0.0.1:8766/mcp, encabezado Authorization: Bearer <your token>Registro de auditoría
Quién hizo qué, en qué máquina y cuándo.
Studio lleva un registro de auditoría en su equipo: las acciones del operador en la ventana, cada llamada de una IA a una herramienta MCP con el nombre del cliente, las alarmas, las colisiones y los programas iniciados y terminados. Cada entrada lleva el hash SHA-256 de la anterior, también de un día al siguiente, de modo que se nota si una entrada se ha modificado o falta.
- Cinco niveles de detalle, ajustables por categoría: máquina, operador, programa, amarre, IA, sistema
- Verificación de la cadena en la ventana del registro o con TwinwrightStudio.exe --audit-verify; exportación a CSV
- Se conserva 180 días o hasta 2 GB de forma predeterminada; las claves de API y los tokens se enmascaran
Diseñado para que la IA se quede en el gemelo
Desactivada hasta que usted la active
El interruptor de IA de la ventana está desactivado de forma predeterminada. Mientras lo está, los clientes de IA trabajan en un gemelo de práctica (sandbox) que usted no ve, y sus resultados lo indican, para que la IA no lo confunda con su máquina.
Su aprobación para su ventana
Cuando una IA quiere modificar la máquina de su ventana, el encabezado pregunta: “Permitir” o “Rechazar”; si no hay respuesta en 60 s, la solicitud se considera rechazada. Usted decide si se le pregunta.
Simulaciones en copias
program_simulate se ejecuta en una copia oculta del amarre, a partir de la pieza tal como está ahora o, si se pide, de un bruto nuevo; así, probar un programa nunca modifica la máquina por la que se preguntó.
Las personas manejan la máquina
Un programa verificado por la IA es un archivo. Una persona lo carga en la máquina real, fija el cero y pulsa el botón de inicio de ciclo.
Evidencia reproducible
Cada ejecución termina con un hash de reproducción: el mismo programa con el mismo amarre da el mismo hash en cualquier equipo, así que lo que afirma la IA se puede comprobar.
Próximamente
Twinwright Cloud
Un punto de conexión MCP alojado para los clientes que solo pueden acceder a internet — claude.ai, ChatGPT en la web, Gemini, Microsoft Copilot — con inicio de sesión y gemelos propios de cada usuario.
Tarjetas de resultados interactivas
Imágenes que puede girar y en las que puede hacer clic dentro del chat, en los clientes compatibles con MCP Apps.
Una prueba comparativa de CNC para IA
Tareas de mecanizado que el gemelo puntúa automáticamente, para comparar lo bien que los modelos escriben y corrigen código G.
FAQ
¿Qué clientes de IA son compatibles?
Cualquier cliente MCP que pueda iniciar un programa local: Claude Desktop, Claude Code, ChatGPT para escritorio (modos Codex y Work), Cursor, VS Code, LM Studio, Cherry Studio, Trae y otros. Las versiones web, como claude.ai o ChatGPT en la web, solo llegan a servidores en internet; el Twinwright Cloud previsto ofrecerá uno. Cada versión publicada se prueba con clientes MCP automatizados por stdio y HTTP; las entradas con un clic siguen la configuración documentada de cada cliente.
¿La IA ve mis archivos?
Solo lo que usted le da o lo que devuelven las herramientas MCP. El servidor se ejecuta en su equipo y Twinwright no recibe nada. Con un modelo en la nube, sus mensajes y los resultados de las herramientas se envían a ese proveedor, según las condiciones de este.
¿Cuánto cuesta?
El servidor MCP y el asistente forman parte de Studio y son gratuitos. El uso de un modelo en la nube lo factura su proveedor a la cuenta de su clave; un modelo local no cuesta nada.
¿Cuánto puede tardar una simulación?
Una llamada responde en 40 s como máximo; una ejecución más larga responde con un identificador de ejecución, y run_status recoge el resultado, porque algunos clientes solo conceden 60 s a una llamada de herramienta MCP. Las simulaciones con arranque de material suelen ejecutarse varias veces más rápido que en tiempo real (los ejemplos de la 1.0: de 8 a 28 veces en un PC de sobremesa actual); los tramos densos, como las entradas en hélice en una cajera profunda, pueden ir brevemente más lentos que el tiempo real (ejemplo 14: 0,6 veces en sus cinco segundos más lentos).
¿Es una IA que escribe código G?
No. Es una forma de que cualquier IA — o cualquier programa — haga que el CAM de Studio escriba código G a partir de una forma, pruebe código G en un modelo físico de la máquina y lo mejore basándose en evidencias. Úselo con su CAM, su propio código o un asistente.
¿Manejará alguna vez una IA mi máquina real?
La IA es audaz en el gemelo y prudente en la máquina. En Studio, los asistentes trabajan en gemelos: ahí pueden probar cualquier cosa. Conectada a una MC-1 real (modo sombra, una vista previa en la 1.0), la IA solo lee: lo que la máquina mide y registra, y su análisis; nunca inicia un programa ni cambia ningún ajuste. Sus llamadas quedan en el registro de auditoría, activado de forma predeterminada.