KiCad Agentic MCP

Diseño de PCB asistido por IA para KiCAD 10. Konnect es un plugin nativo de KiCAD — un único binario Rust — que permite a Claude y otros asistentes de IA diseñar esquemáticos y PCBs a través del Model Context Protocol (MCP).

202 herramientas en 22 conjuntos de herramientas bajo demanda. Captura de esquemáticos, diseño y enrutado de PCB, ERC/DRC, auditorías de revisión de diseño, búsqueda de piezas JLCPCB, Freerouting, circuitos de referencia y un pipeline completo de exportación de fabricación — con habilidades y agentes incluidos que enseñan a Claude las convenciones de KiCAD de serie.

Este repositorio es KiCad Agentic MCP, un fork agéntico de mixelpixx/Konnect v0.2.2, bajo la misma licencia AGPL-3.0. Sobre la superficie de herramientas de Konnect añade una puerta de enlace MCP, un IR de plan con un ejecutor determinista, manejadores de evidencia, estado de tareas y un runtime de modelo local. El binario del servidor sigue llamándose konnect.

Estado: v1.1.1. Lo que mide, lo que le falta y lo que no cubre están en RELEASE_NOTES.md; cada cifra citada a continuación se remonta a docs/benchmark.md. Se aceptan issues y PRs — consulte CONTRIBUTING.md y las convenciones de nomenclatura.

Lo que hace un solo prompt

Un solo prompt, sobre la placa inicial incluida en examples/demo/ — reproducible, no ilustrativo. El veredicto de KiCad, no el nuestro: 5 elementos desconectados antes, 0 después, 11 segmentos de pista, sin errores; ejecutado dos veces desde el mismo estado, el mismo circuito ambas veces, coordenadas diferentes.

Dos números, porque miden dos cosas diferentes: los cambios en la placa se aplican en menos de un segundo (0,69 s y 0,77 s de tiempo de Konnect), mientras que el prompt que los rodea tarda de 6 a 7 minutos, porque el modelo enruta un segmento por turno. Ambas ejecuciones, por llamada, están en demo-run-2.md y demo-run-3.md.

Related MCP server: KiCad MCP Pro

Inicio rápido

Cinco pasos desde la página de lanzamiento hasta un cambio que el propio KiCAD confirma. Probado en una máquina que nunca había tenido Konnect instalado; el registro, incluido lo que salió mal, está en docs/launch/first-run-walk.md.

Lo que midió ese recorrido: aproximadamente nueve clics y diálogos entre lanzar KiCAD y tener un plugin instalado, dos reinicios de KiCAD, y una primera tarea que volvió en 108 ms. El total está dominado por la rapidez con la que haces clic, por lo que no se cita como número.

Antes de empezar necesitas KiCAD 10 (probado contra 10.0.3) y un cliente MCP — Claude Desktop, Claude Code, o cualquier otra cosa que hable MCP. Nada más: no Node, no Python, no árbol de paquetes. Windows es la plataforma más probada; consulte Requisitos para ver dónde están macOS y Linux.

1 — Descarga el paquete del plugin. Desde Releases, toma konnect-pcm-v<version>-windows.zip (o -macos.zip / -linux.zip). Los archivos konnect-pcm-* son los paquetes de plugin de KiCAD; los otros archivos son binarios de servidor independientes que no necesitas para esta ruta.

2 — Instálalo. KiCAD 10 → Plugin and Content Manager → Install from File… → elige el zip. Se instala en el momento en que seleccionas el archivo — el botón Apply Pending Changes permanece atenuado y no hay nada más que confirmar. Reinicia KiCAD.

3 — Activa la API de KiCAD. Preferences → Plugins → marca Enable KiCad API, luego reinicia KiCAD. KiCAD trae esto desactivado, y cada herramienta de PCB aquí habla con KiCAD a través de él. La edición de esquemáticos y las exportaciones funcionan sin él; la edición en vivo de la placa no. Después del reinicio, la misma página debería mostrar Listening on ipc://….

4 — Apunta tu cliente MCP al servidor. Después de una instalación PCM, el binario vive en tu carpeta de documentos de KiCAD:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

Pon esa ruta en la configuración MCP de tu cliente — %APPDATA%\Claude\claude_desktop_config.json para Claude Desktop, un .mcp.json en la raíz de tu proyecto para Claude Code. Las versiones de copiar y pegar de ambos están en examples/, y los fragmentos completos están más abajo. Reinicia el cliente; konnect debería reportar 21 herramientas al inicio. Ese es todo el kit de inicio — el resto del catálogo se carga bajo demanda, o se llama a través de la puerta de enlace sin aparecer nunca en tools/list. No se requiere konnect-settings.json para una instalación estándar de KiCAD 10: v1.1.1 descubre kicad-cli, el binario de la GUI de KiCAD y la dirección IPC. La configuración explícita sigue disponible para instalaciones inusuales o portátiles.

5 — Dale algo que hacer, con un proyecto de KiCAD abierto. Por ejemplo:

Añade un subcircuito regulador LDO de 3,3 V a mi esquemático y ejecuta ERC sobre él.

La respuesta debería nombrar las piezas que colocó — un regulador, sus condensadores de entrada y salida — y llevar un resultado ERC que provenga de kicad-cli, no del modelo. Abre el esquemático en KiCAD: los símbolos están ahí.

Comprueba la instalación en sí en cualquier momento: abre un proyecto (el editor de PCB de KiCAD se niega a abrir sin uno), luego PCB Editor → Tools → External Plugins, donde deberías ver Konnect.

Lo que esto aún no hace

• Las herramientas de PCB necesitan un KiCAD en ejecución con la API activada y la placa abierta. No hay ruta de PCB sin cabeza — pcbnew no tiene ninguna.

• Los binarios de macOS no están firmados ni notarizados. Gatekeeper los detiene en el primer lanzamiento; la sección de macOS tiene el comando xattr exacto.

• Linux compila y pasa CI pero no ha tenido QA por plataforma contra un KiCAD en ejecución.

• Los símbolos y las huellas se colocan, no se crean. Konnect busca y utiliza piezas de biblioteca existentes; crear nuevas está en el roadmap.

Si alguno de esos cinco pasos no te funcionó, eso es lo que vale la pena reportar: presenta un informe de primer uso. Tarda unos dos minutos y es la única manera de que todo esto se mida en una máquina que no es la del mantenedor.

Por qué existe Konnect

Konnect es el sucesor de KiCAD-MCP-Server, un proyecto Python/TypeScript que demostró que el diseño de PCB impulsado por IA funciona — y, en el proceso, mostró exactamente dónde se queda sin camino esa arquitectura. Konnect se construyó para solucionar esos problemas específicos:

La ruta de llamada era demasiado larga. En el servidor original, una sola llamada de herramienta viaja a través de TypeScript, validación de esquema, un subproceso Python generado, JSON sobre stdin/stdout, un enrutador de comandos y finalmente objetos proxy C++ generados por SWIG antes de que algo toque tu placa. Eso son cuatro límites de lenguaje y serialización, cada uno con sus propios modos de fallo — gestión del ciclo de vida del subproceso, análisis de stdout que filtra advertencias que KiCAD filtra en el flujo, reensamblaje de JSON fragmentado. En Konnect, una llamada de herramienta es una llamada de función. Un proceso, un lenguaje, sin tuberías.

La superficie de dependencias era enorme. Ejecutar el original significa llevar Node.js y su árbol npm, Python y sus paquetes pip, wxPython, kicad-skip y los enlaces SWIG de KiCAD — dos ecosistemas de paquetes más una capa de enlace, cada uno de ellos un objetivo móvil que puede romper una instalación. Konnect es un solo binario — 24 MB en Windows, sin intérprete, sin árbol de paquetes. No hay nada que instalar junto a él y nada que igualar en versiones.

SWIG es un callejón sin salida. El backend de PCB del original depende de los enlaces Python SWIG de KiCAD, que KiCAD está deprecando en favor de su API IPC. SWIG también llevaba cicatrices operativas reales: una llamada de relleno de zona que puede provocar un segfault en el backend, errores de comparación de objetos proxy y una ruta de respaldo que puede cambiar silenciosamente de backend a mitad de sesión. Konnect habla con KiCAD 10 a través de la API IPC oficial (protobuf sobre NNG) — la interfaz en la que KiCAD está invirtiendo — con ediciones de placa en tiempo real que se integran con el propio deshacer/rehacer de KiCAD.

Las ediciones de esquemáticos no deberían corromper archivos. Konnect edita archivos .kicad_sch a través de su propio motor de expresiones S con escrituras atómicas (write, fsync, rename), preservación de UUID y pruebas de ida y vuelta — sin biblioteca de esquemáticos de terceros con lagunas conocidas, sin soluciones de manipulación de texto.

La economía de contexto es una característica. Servir todo el catálogo — 215 herramientas una vez que cada conjunto de herramientas está cargado — cuesta 33K tokens de contexto en cada listado. El enrutador de Konnect abre con un kit de inicio de 21 herramientas / 2.8K tokens y permite que el modelo cargue conjuntos de herramientas bajo demanda, o que omita el catálogo por completo y llame a las herramientas a través de la puerta de enlace (kicad_describe / kicad_invoke), que nunca cambia tools/list en absoluto — además de observabilidad integrada (get_recent_calls, server_stats, registros de llamadas JSONL) para que el modelo pueda diagnosticar sus propios fallos de herramientas. Esas cifras están medidas, no estimadas: consulte docs/benchmark.md.

El resultado es más pequeño, más rápido de instalar, alineado con hacia dónde va KiCAD y construido para uso en producción en lugar de experimentación. El proyecto original sigue abierto, mantenido y útil — consulte la comparación a continuación.

Lo que hace

En lugar de describir cambios y aplicarlos a mano, la IA trabaja tu proyecto directamente:

• Coloca y cablea componentes de esquemático — añade resistencias, ICs, conectores; conéctalos por nombre de pin

• Diseña la PCB — coloca, mueve, rota y enruta huellas en tiempo real a través de la API IPC de KiCAD, con integración completa de deshacer/rehacer

• Ejecuta comprobaciones de diseño — ERC, DRC, validación de conectividad, auditorías de desacoplamiento, revisión de rieles de alimentación, comprobaciones de salud de BOM

• Exporta archivos de producción — Gerbers, taladros, BOM, pick-and-place, modelos 3D, PDF

• Busca piezas JLCPCB — encuentra componentes en stock en un catálogo local de 2,5 millones de piezas y sugiere alternativas

• Empieza desde circuitos de referencia — plantillas USB-C, LDO, convertidor buck, STM32, I2C, LED con valores de componentes verificados

• Míralo suceder — un visor de esquemáticos en vivo se actualiza automáticamente mientras la IA edita

El catálogo completo de herramientas está documentado en tool-directory.md.

Cómo funciona

Instalación

Desde el Gestor de Plugins de KiCAD (recomendado)

1. Descarga el paquete para tu sistema operativo desde Releases: konnect-pcm-v<version>-windows.zip, -macos.zip o -linux.zip. Cada uno incluye el binario del servidor de esa plataforma: el paquete de macOS es una compilación universal, por lo que una sola descarga cubre Apple Silicon e Intel. (Los archivos konnect-pcm-* son los paquetes de complementos de KiCAD; los otros archivos son binarios de servidor independientes).

2. Abre KiCAD 10 → Plugin and Content Manager

3. Haz clic en Install from File y selecciona el zip. La instalación se realiza al seleccionarlo: Apply Pending Changes permanece atenuado y no hay nada más que confirmar.

4. Reinicia KiCAD

5. Habilita la API de KiCAD: Preferences → Plugins → Enable KiCad API y reinicia KiCAD de nuevo. Viene desactivada y todas las herramientas de PCB la necesitan.

Verificación: abre (o crea) un proyecto: el editor de PCB de KiCAD no se abrirá sin uno. Luego, PCB Editor → Tools → External Plugins → deberías ver Konnect.

Compilar desde el código fuente

# protoc is required (protobuf code generation), and cmake (the nng crate
# compiles the NNG C library with it).
# Windows: choco install protoc cmake
# macOS:   brew install protobuf cmake
# Linux:   apt install protobuf-compiler cmake
cargo build --release -p konnect

macOS

La página de Releases incluye binarios de servidor independientes tanto para Apple Silicon (aarch64-apple-darwin) como para Intel (x86_64-apple-darwin). Aún no están firmados con código, así que si descargas uno a través del navegador, elimina la marca de cuarentena antes del primer lanzamiento:

tar xzf konnect-v*-aarch64-apple-darwin.tar.gz
xattr -d com.apple.quarantine ./konnect   # only needed for browser downloads
./konnect --help

O compila desde el código fuente como se indicó anteriormente (verificado en Apple Silicon; el mismo binario target/release/konnect es el servidor MCP).

KiCad en macOS mantiene sus herramientas dentro del paquete de la aplicación y no están en PATH; v1.1.1 busca en el paquete de aplicación estándar y usa la dirección IPC predeterminada de KiCad automáticamente. Solo una instalación inusual o renombrada necesita anulaciones explícitas en ~/Library/Application Support/konnect/config.toml:

kicad_cli = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli"
kicad_binary = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad"
# Optional override; the default is ipc:///tmp/kicad/api.sock.
ipc_address = "ipc:///tmp/kicad/api.sock"

La configuración de Claude Desktop se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "/path/to/konnect"
    }
  }
}

Para Claude Code, coloca el mismo fragmento en un .mcp.json en la raíz de tu proyecto.

El paquete PCM para macOS (konnect-pcm-v<version>-macos.zip) incluye un binario de servidor universal, por lo que una sola descarga cubre ambas arquitecturas. El visor de esquemáticos se compila y se lanza en macOS (Tauri 2 usa el WKWebView del sistema; WebView2 es solo un requisito de Windows), pero aún no ha tenido el mismo uso que la versión de Windows.

Configuración con Claude Desktop

Después de una instalación PCM, el binario del servidor se encuentra en tu carpeta de documentos de KiCAD:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

Edita %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "C:\\Users\\<YOU>\\Documents\\KiCad\\10.0\\3rdparty\\plugins\\com_github_mixelpixx_konnect\\bin\\konnect.exe"
    }
  }
}

Reinicia Claude Desktop y aparecerán las herramientas de Konnect. Para Claude Code, coloca el mismo fragmento en un .mcp.json en la raíz de tu proyecto (consulta examples/).

Visor de esquemáticos

Un visor independiente que se actualiza automáticamente cuando cambia el archivo de esquemático:

schematic-viewer.exe path\to\your\root_schematic.kicad_sch

Apúntalo a la hoja raíz de un diseño jerárquico y también se renderizarán todas las subhojas, con un selector de hojas con sangría por profundidad en la barra de herramientas. Las ediciones guardadas desde KiCAD (o realizadas por la IA a través de las herramientas de esquemáticos) vuelven a renderizar solo las hojas que cambiaron y actualizan la vista en vivo: el renderizado se ejecuta contra instantáneas en carpetas temporales, por lo que el visor nunca bloquea a KiCAD para guardar. Desplázate con clic y arrastre, haz zoom con la rueda, 0 para ajustar, R para actualizar, arrastra y suelta para abrir un archivo diferente. También se puede lanzar mediante la IA a través de la herramienta open_schematic_viewer.

Necesita el runtime de WebView2 (preinstalado en Windows 10/11) y una instalación de KiCAD para kicad-cli (se detecta automáticamente, o pasa --kicad-cli <ruta>). Se compila por separado del espacio de trabajo principal; consulta DEV.md para los pasos de compilación.

Requisitos

• KiCAD 10 (Windows es la plataforma más probada; macOS funciona con los binarios de lanzamiento o una compilación desde el código fuente; consulta la sección de macOS anterior. Linux compila y pasa las pruebas en CI, pero aún no ha tenido control de calidad por plataforma; ambos se rastrean en la hoja de ruta)

• kicad-cli (se incluye con KiCAD; se usa para exportaciones, ERC, DRC). El instalador de KiCAD no lo agrega a PATH; el servidor busca en las ubicaciones de instalación habituales, y puedes especificarlo explícitamente si el tuyo está en otro lugar

• Para herramientas de PCB: KiCAD en ejecución con la placa objetivo abierta, y la API de KiCAD activada — Preferences → Plugins → Enable KiCad API, que viene desactivada

Licencia: gratis para los pequeños

Konnect está licenciado bajo la GNU AGPL-3.0.

Si eres aficionado, estudiante, autónomo o proyecto de código abierto: úsalo libremente, sin condiciones. Diseña placas, envíalas, véndelas.

Si eres una empresa: la AGPL exige que cualquier cosa que construyas sobre o alrededor de Konnect, incluido el software proporcionado a través de una red, se publique como código abierto bajo la misma licencia. Si eso no te sirve, hay licencias comerciales disponibles: consulta COMMERCIAL.md.

Relación con KiCAD-MCP-Server

El proyecto original en Python/TypeScript sigue siendo totalmente abierto (MIT) y mantenido. Konnect es donde ocurre el nuevo desarrollo: la arquitectura que demostró, reconstruida para producción:

Solución de problemas

El complemento no aparece en KiCAD — instala a través del Plugin and Content Manager (no copia manual) y luego reinicia KiCAD. La entrada se encuentra en Tools → External Plugins en el editor de PCB, que no se abrirá en absoluto hasta que haya un proyecto abierto.

Las herramientas de PCB devuelven "IPC connect failed" — dos cosas separadas deben ser ciertas: Preferences → Plugins → Enable KiCad API está marcada (KiCAD la trae desactivada), y KiCAD está en ejecución con tu archivo de placa abierto. La página de la API debería mostrar Listening on ipc://… después de un reinicio. docs/TROUBLESHOOTING.md explica ambas.

"Failed to spawn kicad-cli" — el servidor busca kicad-cli en este orden: el valor kicad_cli en tu configuración si lo has establecido, luego PATH, luego los prefijos de instalación conocidos (incluido %LOCALAPPDATA%\Programs\KiCad\<ver>\bin, donde el instalador de KiCAD coloca una instalación por usuario), y luego el registro de Windows. Registra cuál respondió al inicio. Si ninguno lo hace (una ubicación de instalación inusual, una copia portátil), establece kicad_cli explícitamente en el diálogo de configuración del complemento o en tu archivo de configuración.

Un validador informa un error en lugar de cero hallazgos — eso es deliberado. Una verificación que no pudo ejecutarse nunca se informa como una verificación que pasó.

Soporte

• ¿Lo probaste por primera vez? Envía un informe de primera ejecución — seis preguntas, la mayoría de un clic. Un informe de alguien que se rindió vale más que uno de alguien que tuvo éxito. Lo que se recibe se contabiliza en docs/adoption.md.

• Errores y solicitudes de funciones: GitHub Issues

• Atascado en la instalación o en el socket IPC: docs/TROUBLESHOOTING.md

• Hoja de ruta: ROADMAP.md

• Contribuciones: CONTRIBUTING.md

Sin telemetría. Konnect no informa nada, en ningún lugar, nunca. Todo lo que se sabe sobre cómo se comporta en las máquinas de otras personas proviene de alguien que eligió escribirlo. Una herramienta que edita tus archivos de diseño gana confianza al no llamar a casa.