This website requires JavaScript.
Cupones
Envie a
Blog

KiCad MCP: cómo diseñar una PCB con Claude Code paso a paso

Publicado originalmente Nov 21, 2026, Actualizado Nov 21, 2026

19 min

Tabla de contenidos
  • Introducción
  • ¿Cómo diseña Claude Code una PCB en KiCad con MCP?
  • Ejemplo de Claude con KiCad MCP: PCB de un convertidor reductor XL4015 de 5 A
  • Cómo configurar un servidor MCP de KiCad de forma segura
  • Flujo de trabajo con KiCad MCP: del esquemático a la placa terminada
  • Problemas con KiCad MCP: qué falló y cómo se corrigió
  • Del diseño con KiCad MCP al pedido en JLCPCB: Gerber, BOM y componentes
  • Conclusión
  • Preguntas frecuentes sobre KiCad MCP
banner_PCB_HDI_ES_500KB

Puntos clave

  • Claude puede diseñar PCB en KiCad: si conectas Claude a KiCad mediante un servidor MCP, puedes usar la IA para crear y modificar diseños de PCB. En este proyecto, Claude ayudó a convertir la netlist de un convertidor reductor XL4015 de 5 A en un layout de PCB de dos capas y 63 × 33 mm, con cero infracciones de ERC y cero errores de DRC tras unas pequeñas correcciones iniciales.
  • Configura Claude de forma segura: usa un servidor MCP de KiCad que arranque en modo de solo lectura. Revisa el código del servidor antes de instalarlo, conéctalo por stdio y permite la edición solo en una carpeta de proyecto dedicada y controlada con Git.
  • Revisa el circuito antes de diseñar: antes de crear el esquemático, se revisó el diseño de referencia con las hojas de datos de los componentes y aparecieron cuatro problemas. Entre ellos, una conexión a masa incorrecta en el pin VC del XL4015 y un regulador 78L05 que no soportaba la tensión de entrada máxima del circuito, de 36 V.
  • No te fíes solo del ERC: el comprobador de reglas eléctricas (ERC) de KiCad no detectó un error de conexión entre las redes de medida de corriente y de consigna del límite de corriente. Una comparación pin a pin de la netlist exportada sacó a la luz el problema y sirvió para verificar las 16 redes.

kicad_mcp_es_under_0_5MB

Introducción

¿Y si pudieras pedirle a Claude que diseñe una PCB en KiCad y ver cómo crea el esquemático, coloca los componentes y rutea la placa? Con un servidor MCP de KiCad, Claude puede trabajar directamente con KiCad 10 y convertir las instrucciones de diseño en un layout de PCB real.

Pero ¿qué tal funciona con un circuito real? Para averiguarlo, usamos Claude para diseñar la PCB de un convertidor reductor XL4015 de 5 A, desde el esquemático hasta el layout de una placa de dos capas. Por el camino, vimos qué puede hacer Claude por sí solo, en qué se equivoca y por qué la verificación humana sigue siendo importante.

En este artículo verás cómo se conecta Claude a KiCad, cómo configurar el servidor MCP de forma segura y qué pasó cuando pusimos a prueba el diseño de PCB asistido por IA.

En esta guía verás:

  • Cómo se conecta Claude a KiCad para diseñar y editar PCB
  • Cómo configurar un servidor MCP de KiCad de forma segura
  • El diseño paso a paso: del esquemático generado al layout final de la placa
  • Qué errores pasaron el ERC y cómo verificar la placa

PCB del convertidor reductor XL4015 diseñada con Claude en KiCad 10

Figura: Vista 3D de la PCB del convertidor reductor XL4015 diseñada con Claude en KiCad 10

¿Cómo diseña Claude Code una PCB en KiCad con MCP?

Claude Code puede diseñar una PCB en KiCad usando el Model Context Protocol (MCP) para comunicarse con las herramientas de diseño de KiCad.

El servidor MCP hace de puente y permite a Claude Code leer los archivos del proyecto, crear esquemáticos, colocar componentes, rutear pistas y hacer comprobaciones de diseño. En lugar de limitarse a sugerir ideas de diseño, Claude Code puede hacer cambios reales en el proyecto de KiCad.

Eso sí, las operaciones que puede hacer dependen del servidor MCP, y el diseño resultante sigue necesitando una verificación de ingeniería.

Una configuración de KiCad MCP tiene tres partes:

  • Cliente de IA: Claude Code o la aplicación de escritorio de Claude, que decide qué herramienta llamar y con qué valores.
  • Servidor MCP: un programa local que expone acciones de KiCad como herramientas, por ejemplo, crear un esquemático, mover una huella o ejecutar el DRC.
  • KiCad: al editor de KiCad se accede mediante la API de KiCad mientras el proyecto está abierto, y mediante kicad-cli para las exportaciones y las comprobaciones de diseño.

cómo funciona KiCad MCP

Figura: Cómo funciona KiCad MCP

KiCad MCP no es un producto único. Hay varios servidores de código abierto, y se diferencian en cuánto pueden cambiar de tu proyecto. Forma parte del grupo más amplio de herramientas de IA para el diseño de PCB y trabaja directamente con tu proyecto de KiCad.

Ejemplo de Claude con KiCad MCP: PCB de un convertidor reductor XL4015 de 5 A

En una sola sesión de trabajo, Claude y un servidor MCP de KiCad crearon una placa de convertidor reductor XL4015 de dos capas y 63 × 33 mm, con 0 infracciones de ERC y 0 errores de DRC. Es un rediseño de un módulo CC/CV de 5 A muy común y todavía no se ha fabricado ni probado en banco.

ParámetroValor
CI del convertidorConvertidor reductor XL4015E1, 180 kHz
Entrada8–36 V CC, el rango de entrada nominal del XL4015
Salida1,25–32 V, ajustable con el trimmer RV1
Corriente de salida5 A nominales; el trimmer de límite de corriente (RV2) ajusta hasta unos 5,9 A
Control de corrienteLazo de corriente con LM358 sobre una resistencia shunt en el lado bajo, referencia TL431 de 2,5 V
Indicadores3 LED: modo CC, cargando y carga completa
Placa63 × 33 mm, 2 capas, cobre de 1 oz, 4 taladros M3
EstadoSin errores de DRC en KiCad 10.0.4; no fabricada ni probada en banco

Correcciones de diseño respecto al módulo XL4015 de referencia

Antes de crear el esquemático, una revisión del módulo de referencia con las hojas de datos encontró cuatro problemas. La corrección dimensiona la etapa de entrada para la tensión de entrada máxima de funcionamiento del XL4015, 36 V, en lugar del rango más estrecho que indica la página del vendedor.

La revisión se hizo primero porque KiCad MCP crea el esquemático a partir de la netlist que le das.

Problema en el módulo de referenciaRiesgoCorrección en este diseño
Pin VC del XL4015 (pin 4) conectado a GNDNo sigue la hoja de datos, que pide un condensador de 1 µF entre VC y VINC3, 1 µF entre VC y VIN
Regulador 78L05, para una entrada máxima de 30 VPor debajo de la entrada máxima de funcionamiento del XL4015, 36 VLDO BL8078, para una entrada máxima de 40 V
Una sola resistencia shunt de 0,05 ΩDisipa 1,25 W a 5 ADos resistencias de 0,1 Ω y 2 W en paralelo, unos 0,63 W cada una
Condensadores de reserva (bulk) de 35 VPor debajo de la entrada máxima de funcionamiento del XL4015, 36 VCondensadores de 220 µF y 50 V

Cómo configurar un servidor MCP de KiCad de forma segura

Elige un servidor que sea de solo lectura por defecto, instálalo a partir de una copia que hayas revisado, conéctalo por stdio y limítalo a una carpeta de proyecto controlada con Git. Después, activa la API de KiCad para que el servidor pueda acceder al editor abierto.

Elegir un servidor MCP de KiCad: comparativa de acceso

¿Qué servidor MCP de KiCad te conviene?

La principal diferencia entre servidores es lo que pueden cambiar por defecto:

ServidorAcceso por defectoDiseño de placaNota
oaslananka/kicad-mcp-proHerramientas de revisión de solo lecturaSí, con su perfil build (escritura)Los perfiles de escritura y de fabricación hay que activarlos expresamente
Seeed-Studio/kicad-mcp-serverSobre todo análisis: ERC, DRC, seguimiento de redesLimitado; la edición de esquemáticos es experimentalAdecuado para revisar diseños
mixelpixx/KiCAD-MCP-ServerLectura y escritura completasSí, el conjunto de funciones más amplioDa acceso de escritura desde el principio
lamaalrajih/kicad-mcpLectura y edición parcialParcialSin actualizaciones desde hacía un año cuando se hizo este proyecto

En este proyecto se usó kicad-mcp-pro, porque al ser de solo lectura por defecto limita lo que puede cambiar un error de la IA.

Instalar KiCad MCP y conectarlo a Claude

La instalación tuvo cinco pasos (puedes copiarlos y pegarlos directamente en Claude para que se encargue de la instalación):

carpeta sandbox usada por el servidor MCP de KiCad

Figura: Árbol del proyecto de KiCad en la carpeta sandbox que usa el servidor MCP de KiCad

  1. Revisa primero el código: la revisión se centró en las llamadas de red y la telemetría, los subprocesos que lanza (solo kicad-cli, git y ngspice) y si las rutas de archivo se quedan dentro de la raíz del espacio de trabajo.
  2. Instala una copia fijada: la versión revisada se copió en un repositorio privado y se instaló desde ahí, con el archivo de dependencias bloqueado por hash.
  3. Regístralo en Claude Code por stdio: stdio no abre ningún puerto de red, así que solo el cliente local puede acceder al servidor.
  4. Limítalo a una carpeta sandbox controlada con Git: activa el perfil build (escritura) del servidor solo para esa carpeta. Así puedes revisar con Git cada cambio que haga la IA y deshacerlo si hace falta.
  5. Activa la API de KiCad: en KiCad, abre Preferences > Plugins y selecciona Enable KiCad API.

preferencias de KiCad 10 con la opción Enable KiCad API seleccionada

Figura: Preferencias de KiCad 10 con la opción Enable KiCad API seleccionada

Problemas de conexión de KiCad MCP y soluciones

Estos cuatro problemas bloquearon la conexión durante el proyecto:

SíntomaCausaSolución
El servidor no se conecta y no muestra ningún errorUna segunda ventana de KiCad, abierta con otro proyecto, ocupa la conexión de la APIDeja abierta una sola instancia de KiCad
Las llamadas a la API dejan de responderHay un diálogo modal esperando en KiCad, como «File Open Warning»Cierra el diálogo
Faltan las herramientas de edición de la placaLa placa no está abierta en el PCB EditorAbre la placa en el PCB Editor
El servidor no llega a KiCad en absolutoLa API de KiCad está desactivadaActívala en Preferences > Plugins

Flujo de trabajo con KiCad MCP: del esquemático a la placa terminada

El diseño pasó de la netlist a la placa terminada en cuatro pasos. En cada paso, la IA hizo la edición y una comprobación confirmó el resultado antes de pasar al siguiente.

Paso 1: generar el esquemático de KiCad a partir de una netlist

Claude creó el esquemático con una sola llamada MCP, sch_build_circuit, a partir de una netlist de 16 redes. Cada pin recibió un tramo corto de cable y una etiqueta de red con nombre, así que las redes se conectan por nombre.

esquemático generado con KiCad MCP

Figura: Esquemático generado con KiCad MCP para el convertidor reductor CC/CV XL4015 de 5 A

En este paso aparecieron dos problemas:

  • Unidades del LM358 superpuestas: al distribuir automáticamente el esquemático, Claude Code colocó las unidades del LM358 unas encima de otras. Además, al servidor MCP le costó identificar qué pines pertenecían a cada unidad.
  • Etiquetas de red superpuestas: dos etiquetas superpuestas conectaron por error la red de medida de corriente (ISENSE) y la de consigna del límite de corriente (ISET). El ERC de KiCad solo dio un aviso, sin marcar la conexión como error. Una comparación pin a pin de la netlist exportada sacó a la luz el fallo y permitió corregirlo.

El esquemático final pasó el ERC con 0 infracciones, y la netlist exportada coincidió con la prevista en las 16 redes.

Paso 2: dimensionar la placa y colocar los componentes

Las zonas de ocupación (courtyards) de los componentes necesitaban unos 1.500 mm², más que los 1.272 mm² del contorno de 50,5 × 25,2 mm del módulo de referencia. La placa creció hasta 63 × 33 mm, con cuatro taladros M3.

La colocación se planificó fuera de KiCad con un script que comprobaba los solapamientos y generaba una vista previa con las líneas de conexión (ratsnest). Después, las posiciones se aplicaron en directo en KiCad con la herramienta pcb_move_footprint.plan de colocación de la PCB del convertidor reductor XL4015

Figura: Plan de colocación de la PCB del convertidor reductor XL4015, con las zonas de ocupación y las líneas de conexión

El layout sigue el principio de diseño de PCB de un camino de potencia corto y directo:

  • Flujo de potencia, de izquierda a derecha: J1 > C1 > XL4015 > nodo de conmutación > L1 y D1 > condensadores de salida C4 y C5 > J2.
  • Lazo de conmutación: el condensador cerámico de entrada C2 se sitúa entre el pin VIN del XL4015 y el ánodo del diodo de libre circulación D1, lo que mantiene pequeño el lazo de conmutación de alta corriente.
  • Medida de corriente: las resistencias shunt van en el camino de retorno, y los trimmers, en el borde inferior para que sean accesibles.

Paso 3: rutear las redes de potencia y de realimentación

El servidor MCP de KiCad no incluía autorruteador, así que Claude Code creó su propia herramienta de ruteado básica en Python. Usaba el algoritmo de búsqueda de caminos A* para encontrar rutas en una rejilla de 0,1 mm en las dos capas de la PCB. Para las conexiones de alta corriente, Claude usó zonas de cobre en lugar de pistas estrechas, para dar caminos más anchos a la corriente:pista FB junto al nodo SW en la primera pasada

Figura: Pista FB junto al nodo SW en la primera pasada

  • Zonas de cobre: VIN, SW, VOUT y el camino de medida de corriente.
  • Masa: un plano de GND en la capa inferior y un relleno de GND en la capa superior.

En la primera pasada, la pista de realimentación (FB) quedó justo al lado del nodo de conmutación, donde el ruido de conmutación puede acoplarse al lazo de regulación. Una zona de exclusión (keepout) de 1,2 mm alrededor de SW para las redes analógicas lo solucionó, de acuerdo con las reglas habituales de ruteado de PCB. Ahora FB sale hacia la izquierda y pasa por debajo de VIN en la capa inferior.

Paso 4: ejecutar el DRC de KiCad y limpiar la serigrafía

La primera comprobación de reglas de diseño (DRC) dio 7 errores de distancia entre cobre y borde. El ruteador había usado una separación al borde de 0,35 mm, mientras que la regla de la placa era de 0,5 mm. Después de corregir el ruteador y volver a rutear la placa, el DRC final dio 0 errores, 0 elementos sin conectar y 0 diferencias con el esquemático.

placa de KiCad MCP con la leyenda de características en la serigrafía

Figura: Cara inferior de la placa de KiCad MCP con la leyenda de características en la serigrafía

Después, un script de colocación de etiquetas apartó cada designador de referencia de los pads y del resto de la serigrafía. Los avisos de serigrafía bajaron de 47 a 2, ambos por los cuerpos de las bornas en el borde de la placa. La leyenda de la cara inferior indica las características nominales, la función de cada trimmer y el significado de los LED.

Problemas con KiCad MCP: qué falló y cómo se corrigió

La IA o el servidor provocaron siete problemas distintos durante el proyecto. Todos se detectaron con alguna comprobación: la comparación de la netlist, el DRC, una revisión del layout o una consulta directa de componentes.

ProblemaEfectoCorrección
La distribución automática apiló las tres unidades del LM358 en el mismo sitioLos pines superpuestos crearon conexiones no deseadasCada unidad se coloca en sus propias coordenadas libres; se vuelve a comprobar la netlist: 16/16 redes
El servidor no podía cablear componentes de varias unidadesLas unidades del LM358 se quedaron sin conectarParche de 9 líneas en la copia privada del servidor para que resuelva los pines de cada unidad
Colisión de etiquetas de redISENSE quedó en cortocircuito con ISET, y el ERC solo dio un avisoDetectado con la comparación pin a pin de la netlist
Pista FB ruteada junto a SWEl ruido de conmutación podía acoplarse a la realimentaciónZona de exclusión de 1,2 mm para las redes analógicas y nuevo ruteado
El ruteador usó una separación al borde de 0,35 mm7 errores de DRC de cobre a borde con una regla de 0,5 mmSe corrigió el ruteador y se volvió a rutear la placa
La búsqueda de componentes del servidor daba resultados poco fiablesNo se podía confiar en las coincidencias de componentesConsulta directa de los datos de componentes de JLCPCB
El lote de colocación se ejecutó dos vecesEl contorno de la placa se dibujó dos vecesSe eliminó el contorno duplicado

Por qué el ERC no basta en los diseños de PCB generados por IA: verifica la netlist de KiCad

El ERC comprueba reglas eléctricas, como pines sin conectar o salidas en conflicto. No sabe qué pines querías conectar, así que un cortocircuito entre dos redes válidas puede pasar sin problema. Después del ERC, haz estas comprobaciones:

  1. Anota la netlist prevista: enumera cada red y todos sus pines antes de que la IA cree nada.
  2. Exporta la netlist con kicad-cli: usa el esquemático que generó la IA, no el que tenías planeado.
  3. Compara cada red, pin a pin: en este proyecto coincidieron las 16 redes después de corregir el cortocircuito de ISENSE.

Nota

Cero errores de DRC significa que el layout cumple sus reglas. No confirma que el esquemático se corresponda con lo que querías ni que el orden de los pines coincida con el de los componentes, así que completa las comprobaciones de netlist y de patillaje antes de generar los archivos de fabricación.

Del diseño con KiCad MCP al pedido en JLCPCB: Gerber, BOM y componentes

El diseño todavía no está listo para pedir: no se han generado los archivos Gerber, BOM ni CPL porque el perfil de fabricación del servidor sigue desactivado. Los componentes ya están elegidos con sus referencias LCSC, usando componentes Basic de JLCPCB siempre que ha sido posible.

Componentes clave, comprobados en la biblioteca de componentes de JLCPCB:

  • XL4015E1 (C51661): CI del convertidor reductor
  • LM358DR2G (C7950): amplificador operacional del lazo de corriente, componente Basic
  • BL8078CC3TR50 (C692269): LDO de 5 V, para una entrada máxima de 40 V
  • TL431 (C181103): referencia de 2,5 V
  • CYA1265-33UH (C19268671): bobina de 33 µH y 6 A
  • SS54 (C5204950): diodo de libre circulación
  • 0,1 Ω, 2 W, 2512 (C160587): resistencia shunt de medida de corriente, dos en paralelo

Los pasos que quedan son el flujo de exportación habitual de KiCad.

Genera los archivos Gerber y de taladrado con la guía de exportación de Gerber en KiCad y, después, exporta los archivos BOM y CPL con la guía de BOM y CPL en KiCad para el montaje SMT.

Conclusión

Claude Code puede convertir una netlist en un layout de PCB completo y sin errores de DRC en KiCad mediante MCP, pero la verificación humana sigue siendo imprescindible. En este proyecto, Claude Code se encargó del diseño de la PCB, mientras que las comprobaciones manuales de la netlist y de las hojas de datos ayudaron a detectar y corregir los errores que se le escaparon a la IA.

Usa KiCad MCP para la captura del esquemático, la colocación y las correcciones de reglas, y deja en manos del ingeniero la comparación de la netlist, la comprobación del patillaje y la revisión del layout. Con este reparto mantienes la rapidez de la edición con IA y, al mismo tiempo, compruebas cada conexión con la intención del diseño.

Cuando tengas el diseño verificado, sube tus archivos a JLCPCB para obtener un presupuesto al instante.

fabricación de PCB con JLCPCB

Preguntas frecuentes sobre KiCad MCP

1. ¿Puede Claude diseñar una PCB en KiCad por sí solo?

No del todo. Aunque Claude puede generar el esquemático y el layout de la placa, la revisión del ingeniero, con la comparación de la netlist y la comprobación de las hojas de datos, sigue siendo imprescindible para detectar errores sutiles que pasan el ERC.

2. ¿Qué servidor MCP de KiCad debería usar?

Empieza con un servidor que sea de solo lectura por defecto, como kicad-mcp-pro. Activa la escritura solo para un proyecto sandbox controlado con Git.

3. ¿El servidor MCP de KiCad incluye autorruteador?

El que se usó aquí, no. Las pistas salieron de un pequeño ruteador en rejilla escrito en Python que Claude creó durante la sesión, con zonas de cobre para las redes de potencia.

4. ¿Una placa sin errores de DRC puede ir directamente a fabricación?

No por sí sola. El DRC comprueba el layout con sus reglas, pero no comprueba que el esquemático se corresponda con lo que querías ni que el patillaje coincida con tus componentes.

5. ¿KiCad MCP funciona con KiCad 10?

Sí. En este proyecto se usó KiCad 10.0.4 con la API de KiCad activada en Preferences > Plugins. Consulta las notas de compatibilidad de cada servidor, porque el soporte varía según la versión.

Siga aprendiendo