This website requires JavaScript.
Cupões
Enviar para
Blog

Altium MCP com Claude Code: Da Configuração ao Design de PCB

Originalmente publicada Nov 21, 2026, atualizada Nov 21, 2026

27 min

Índice de Conteúdos
  • Introdução
  • O que é um servidor MCP para Altium?
  • Como configurar o servidor MCP para Altium com o Claude Code
  • O projeto de teste do MCP para Altium: um testador de componentes CH32V005
  • Etapa 1: escolher os componentes para o projeto com MCP para Altium
  • Etapa 2: desenhar o esquema elétrico no Altium através do MCP
  • Etapa 3: posicionar os componentes através do MCP para Altium
  • Etapa 4: traçar automaticamente as pistas da placa através do MCP para Altium
  • Etapa 5: ficheiros de saída e documentos do projeto com MCP para Altium
  • Precisão do MCP para Altium: onde foi necessária revisão humana
  • Consumo de tokens do MCP para Altium: modelos e chamadas de ferramentas por sessão
  • Conclusão
  • Perguntas frequentes sobre o MCP para Altium

altium mcp pcb design with claude code

Introdução

Pode o Claude Code ajudar a projetar uma PCB diretamente no Altium Designer? Com um servidor MCP para Altium, consegue aceder a um projeto aberto, criar e modificar elementos do projeto e executar tarefas através de chamadas de ferramentas. Mas que parte do processo de projeto de uma PCB consegue realmente realizar?

Para o descobrir, utilizei o eda-agent, um servidor MCP de código aberto desenvolvido por terceiros, para refazer o meu testador de componentes CH32V005 numa PCB de 2 camadas. O projeto abrange tudo, desde a seleção dos componentes e a criação do esquema elétrico até ao posicionamento dos padrões de ilhas, ao traçado de pistas e às verificações do projeto. Este artigo apresenta uma demonstração prática do fluxo de trabalho, incluindo o que o Claude Code conseguiu automatizar e quais as decisões de engenharia que permaneceram sob o meu controlo.

Neste guia, irá aprender:

  • O que é um servidor MCP para Altium e como funciona o eda-agent
  • Como ligar o eda-agent ao Claude Code e verificar a configuração
  • Como desenvolver uma PCB, desde a seleção dos componentes até a uma placa de 2 camadas com as pistas traçadas
  • Em que situações o Claude Code precisou de correções e intervenção humana
  • Quantos tokens foram consumidos pelo fluxo de trabalho e quais foram as suas limitações práticas

the ch32v005 component tester routed in altium designer

Figura: O testador de componentes CH32V005 com as pistas traçadas no Altium Designer através do servidor MCP para Altium, numa placa de 60 x 45 mm com 2 camadas.

Nota

O eda-agent é um projeto de código aberto desenvolvido por terceiros. Nem a JLCPCB nem a Altium o desenvolvem, recomendam ou apoiam, e este artigo destina-se exclusivamente a fins educativos.

Antes de instalar qualquer repositório, analise o respetivo código, os dados que partilha e o que pode alterar. O autor, a JLCPCB e a Altium não se responsabilizam por quaisquer danos em projetos, ficheiros ou computadores, nem por informações partilhadas através do servidor.

O que é um servidor MCP para Altium?

Um servidor MCP para Altium funciona como uma ponte que disponibiliza as funções de execução de scripts do Altium Designer como chamadas de ferramentas que um cliente de IA pode solicitar. O Claude Code solicita uma operação; o servidor executa-a no projeto aberto e o Altium devolve o resultado sob a forma de dados.

O MCP, Model Context Protocol, é a norma aberta que o Claude Code utiliza para comunicar com estes servidores. O Altium Designer não executa, por si próprio, um modelo de IA; é o modelo que suporta o Claude Code que decide quais as ferramentas a chamar.

altium mcp data path from claude code

Figura: Percurso dos dados do MCP para Altium, desde o Claude Code, passando pelo servidor eda-agent e pelos ficheiros da sua área de trabalho, até ao ciclo DelphiScript no Altium Designer.

O eda-agent gravava cada chamada de ferramenta do Claude Code num ficheiro de pedido, tendo sido utilizado o Claude Opus 5.5 durante a maior parte deste projeto. Um ciclo DelphiScript no Altium executava o pedido e gravava a resposta.

O servidor MCP para Altium utilizado neste projeto

Utilizei o eda-agent 0.8.1 de George Saliba (salitronic), disponibilizado sob a licença Apache-2.0. Edita uma sessão aberta do Altium, em vez de ficheiros exportados, e abrange bibliotecas, esquemas elétricos e placas num único servidor. O autor classifica-o como experimental e indica que algumas ferramentas podem provocar a falha do motor DelphiScript do Altium, pelo que deve ser utilizado num projeto com cópia de segurança. A mesma abordagem funciona no KiCad, como mostra este guia de MCP para KiCad.

Funcionalidades do MCP para Altium: grupos de ferramentas e opções de segurança

O eda-agent regista várias centenas de ferramentas, agrupadas segundo o documento sobre o qual atuam. No conjunto mínimo de ferramentas, o Claude Code vê duas metaferramentas, tool_catalog para pesquisar e tool_invoke para executar, e acede às restantes através delas.

Prefixo da ferramentaAtua sobreUtilização neste projeto
lib_Bibliotecas .SchLib e .PcbLibSímbolos, padrões de ilhas e associações aos padrões de ilhas
sch_O ficheiro .SchDoc abertoDesenho de folhas a partir de modelos
pcb_O ficheiro .PcbDoc abertoPosicionamento e traçado de pistas
obj_Objetos do esquema elétrico ou da placaCobertura de vias com máscara, edições e eliminações
proj_O projetoCompilação, redes e ERC
app_O próprio AltiumGravação e alternância entre documentos

Quatro mecanismos de proteção limitam o que o servidor pode fazer:

  • EDA_AGENT_READONLY=1: Recusa todos os comandos que não sejam de leitura. Comecei neste modo.
  • EDA_AGENT_UI_AUTOMATION=0: Recusa entradas de teclado e rato simuladas, pelo que o servidor não consegue interagir por cliques com as caixas de diálogo do Altium.
  • Bloqueio de scripts: Mesmo no modo de escrita, o servidor recusa executar os processos de scripts do Altium.
  • EDA_AGENT_UPDATE_CHECK=0: Impede que a verificação diária de atualizações aceda à rede.

Como configurar o servidor MCP para Altium com o Claude Code

A configuração tem quatro partes: instalar o eda-agent num ambiente Python, carregar o respetivo script de projeto no Altium, iniciar o ciclo de consulta periódica e registar o servidor no Claude Code. Comece no modo de apenas leitura e ative o acesso de escrita quando for necessário.

A forma mais simples: Forneça ao Claude a ligação para o repositório ou capturas de ecrã destas linhas e peça-lhe que instale e configure o ambiente para a sua conta de utilizador.

1. Instale o eda-agent num ambiente virtual com Python 3.11 ou posterior e copie depois os respetivos scripts para Altium:

git clone https://github.com/salitronic/eda-agent
cd eda-agent
python -m venv .venv
.venv\Scripts\python -m pip install -e .
.venv\Scripts\python -m eda_agent install-scripts

2. Registe o projeto de scripts no Altium uma única vez: Preferences > Scripting System > Global Projects > Install from file e selecione Altium_API.PrjScr.

eda agent altium_api.prjscr script project 1

Figura: As preferências do Altium a mostrar o projeto de scripts Altium_API.PrjScr do eda-agent em Global Projects.

3. Inicie o ciclo de consulta periódica: File > Run Script, expanda Altium_API e Dispatcher.pas, selecione StartMCPServer e clique em OK.

startmcpserver selected in altium designer

Figura: StartMCPServer selecionado na caixa de diálogo Run Script do Altium Designer para iniciar o ciclo de consulta periódica do MCP para Altium.

4. Registe o servidor no Claude Code no modo de apenas leitura. Execute este comando manualmente, porque, na minha configuração, o Claude Code não tinha autorização para alterar a sua própria configuração MCP:

claude mcp add altium --scope user -e EDA_AGENT_READONLY=1 -e EDA_AGENT_TOOLSET=minimal -e EDA_AGENT_UI_AUTOMATION=0 -e EDA_AGENT_UPDATE_CHECK=0 -- "<path-to-venv>\Scripts\python.exe" -m eda_agent --headless

5. Reinicie o Claude Code. As ferramentas do Altium só são carregadas numa nova sessão.

6. Ative o acesso de escrita quando estiver pronto: execute claude mcp remove altium --scope user, repita o comando de adição com EDA_AGENT_READONLY=0 e reinicie novamente o Claude Code.

A opção --headless dispensa o painel de controlo Web do eda-agent; a janela de estado no Altium continua a funcionar.

O projeto de teste do MCP para Altium: um testador de componentes CH32V005

A placa de teste é um testador de componentes capaz de identificar e medir componentes eletrónicos comuns. Liga-se um componente às suas três pontas de prova e o firmware identifica-o e mede-o: transístores, MOSFETs, díodos, tirístores, resistências, condensadores ou indutores.

Existem muitos projetos de testadores de transístores, e vários baseiam-se num mesmo projeto AVR de código aberto. Eu já tinha escrito o meu próprio firmware RISC-V para os circuitos integrados WCH CH32V, pelo que a tarefa seguinte era criar uma PCB. A minha versão alarga o projeto AVR aos MCU CH32V.

O projeto baseia-se em:

O meu firmware reimplementa esses métodos de medição para RISC-V, em vez de traduzir o código AVR. Depois de compilado, ocupa 19,448 bytes de memória flash e 732 bytes de RAM, e ainda não foi ensaiado em bancada.

Etapa 1: escolher os componentes para o projeto com MCP para Altium

Pedi ao Claude Code que escolhesse os componentes, começando pelo MCU. Comparou seis candidatos com as existências da JLCPCB em tempo real e recomendou o CH32V005F6P6 por estar disponível e ter uma disposição de pinos idêntica à do circuito integrado original.

Porque escolheu o Claude Code o MCU CH32V005F6P6

MCUExistências da JLCPCB em 2026-11-03Alteração necessária na placa
CH32V006F8P6 (original)0Nenhuma, mas não estava disponível para compra
CH32V005F6P6 (C54824605)195Nenhuma, disposição de pinos idêntica em TSSOP-20
CH32V0070Novo encapsulamento
CH32V003F4P625,148Nenhuma, mas os 16 KB de memória flash não chegam para o firmware de 19,448 bytes
PY32F030F18P6379Nova disposição de pinos e adaptação do firmware
ATmega328P-AU35,775Reformulação completa do projeto

O que o CH32V005F6P6 oferece ao testador:

  • Núcleo e memória: Um núcleo de 32 bits QingKe RISC-V2C, até 48 MHz, com 32 KB de memória flash e 6 KB de SRAM.
  • Funcionamento a 5 V: Especificado para 2.0 a 5.5 V, ou 2.4 a 5.5 V com o ADC em funcionamento, pelo que funciona a 5 V, tal como o original AVR.
  • ADC: 12 bits, com amostragem superior a 1 Msps para uma alimentação de 4.5 a 5.5 V.
  • Medição de tempos com o comparador: A saída do amplificador operacional em PD4 é também a entrada de captura TIM2_CH1, pelo que o método de medição de tempos com o comparador do testador AVR se mantém aplicável.

O Claude recomendou a alteração com base nos dados de existências e na ficha técnica da WCH, e eu aprovei-a.

Outros componentes da BOM do testador

Para o resto da placa, o Claude manteve os valores já comprovados do testador e verificou cada componente nas existências da JLCPCB.

ReferênciaReferência do fabricante #Referência JLCPCB #Função
U2MCP1702-5002E/MB, SOT-89C18299LDO de 9 V para 5 V, corrente de repouso típica de 2 µA
D4SS14 Schottky, SMAC2480Proteção contra inversão da polaridade da bateria
J4SHOU HAN USB-C de 6 pinosC456012Entrada USB apenas para alimentação
F1SMD0603P025TFC20786Fusível PTC de 250 mA na ligação USB
R1 a R6680 Ω e 470 kΩ 1%, 0603C23228, C23178Resistências das pontas de prova
C3, C610 µF 25 V, 0603C96446Condensadores de reserva de energia
SW1, SW2HRO K2-1102DP-C4SW-04C110153Botões táteis de montagem em furos passantes de 6 x 6 mm

O Claude também comparou o padrão de ilhas USB-C com o desenho do fabricante e verificou que as ilhas do padrão antigo eram mais compridas e estavam recuadas 0.25 mm. Cada componente disponível para compra tem uma referência JLCPCB e um MPN, que pode consultar na Biblioteca de Peças da JLCPCB.

Etapa 2: desenhar o esquema elétrico no Altium através do MCP

O Claude Code desenhou 16 símbolos e as folhas do esquema elétrico através do MCP. Depois, comparou a lista de ligações compilada pelo Altium com uma especificação da correspondência entre pinos e redes obtida do projeto EasyEDA verificado. A primeira verificação confirmou a correspondência das 33 redes e dos 134 pinos, com 0 erros ERC.

  • Primeiro, a especificação: a lista verificada da correspondência entre pinos e redes foi adicionada a build_spec.json, a referência para todas as verificações da lista de ligações.
  • Símbolos e folhas: os símbolos foram criados um por chamada, e sch_draw_template desenhou cada folha a partir de um modelo, interrompendo o processo antes do primeiro fio se as ligações fossem provocar um curto-circuito entre duas redes.
  • Padrões de ilhas: uma biblioteca de 14 padrões de ilhas criada a partir das dimensões do KiCad 10, incluindo padrões personalizados para USB-C, ilhas das pontas de prova, ilhas de teste e interruptores.

Folha 1: circuito de entrada do MCU e rede das pontas de prova

A folha 1 contém o MCU, a rede das pontas de prova e o limiar do comparador, onde começa cada medição do testador.

altium mcp schematic

Figura: Folha 1 do esquema elétrico criado com MCP para Altium: o CH32V005F6P6, as resistências de 680 Ω e 470 kΩ das pontas de prova, o divisor VTH e os conectores J3 e J7 das pontas de prova.

Pino do MCURedeFunção
PA2, PD3, PD2TP1, TP2, TP3Entradas ADC das pontas de prova; TP1 e TP2 também estão ligados ao comparador
PD0, PC7, PC5RL1 a RL3Excitação das pontas de prova através de 680 Ω
PC0, PC6, PC3RH1 a RH3Excitação das pontas de prova através de 470 kΩ
PA1VTHEntrada do limiar do comparador
PD4CMP_OUTSaída do comparador para a captura do TIM2
PC4BTN_VBATMedição da alimentação e botão TEST
PC1, PC2SDA, SCLBarramento I2C do OLED
PD5, PD6DBG_TX, DBG_RXDepuração UART
PD1, PD7SWIO, NRSTProgramação e reinicialização
  • Divisor VTH: R7 (18 kΩ) e R8 (5.1 kΩ) definem o limiar em 0.2208 x VDD, cerca de 1.10 V para uma alimentação de 5 V. Isto reproduz a relação de 1.1 V para 5 V do testador AVR, mantendo válidas as suas tabelas de consulta.
  • Conectores das pontas de prova: J3, um conector de 3 pinos, e J7, três ilhas SMD expostas, estão ligados em paralelo para componentes com terminais e de montagem em superfície.
  • Componentes auxiliares: C2 e C3 asseguram o desacoplamento de VDD, SW2 reinicializa o MCU (C5 é DNP) e TP4 a TP6 dão acesso a CMP_OUT, VDD e GND.

Folha 2: alimentação, USB-C e interfaces

A folha 2 contém ambas as entradas de alimentação, os seletores de alimentação e de medição e os conectores de interface.

altium mcp schematic 2

Figura: Folha 2 do esquema elétrico criado com MCP para Altium: a entrada USB-C, o percurso da bateria de 9 V através do LDO MCP1702, as pontes de configuração PWR SEL e SENSE SEL e os conectores de interface.

  • Entrada USB-C: R13 e R14 (5.1 kΩ) ligam CC1 e CC2 à massa, identificando assim a placa como consumidora de energia, e F1 fornece USB_5V.
  • Percurso da bateria de 9 V: J5 alimenta JP4 (BAT EN), D4 e o LDO MCP1702 para gerar BAT_5V. D4 bloqueia a ligação de uma bateria com polaridade invertida, e a remoção de JP4 desliga completamente a bateria.
  • Seleção da alimentação: JP2 liga VDD a USB_5V nos pinos 1–2 ou a BAT_5V nos pinos 2–3; aberto significa desligado.
  • Seleção da medição: JP3 encaminha USB_5V ou VBAT_PROT para o divisor de medição e tem de corresponder a JP2, mas nada na placa impõe essa correspondência.
  • Medição e botão: R11 (18 kΩ) e R12 (10 kΩ) reduzem a tensão medida por um fator de 10/28, pelo que 9 V correspondem a cerca de 3.2 V em BTN_VBAT. SW1 força o mesmo nó ao nível baixo, permitindo que um único pino ADC leia a alimentação e o botão TEST.
  • Conectores de pinos: J1 é o conector WCH-LinkE, com JP1 deixado aberto para que o WCH-LinkE não alimente VDD por predefinição. J6 disponibiliza a UART e J2 o barramento I2C do OLED.

Alterações ao esquema elétrico durante a revisão

RevisãoAlteraçãoComponentes, redes
C2Interruptor deslizante substituído por duas pontes de configuração 1x3 separadas (JP2, JP3), para que uma ponte amovível mal colocada não possa ligar 9 V à linha de 5 V48, 33
C4Adicionada a ponte de configuração da bateria JP452, 34
C5Removido o conversor de níveis I2C (Q1, Q2, R16, R17)48, 32
C6Removidas R9 e R10, porque o módulo OLED tem as suas próprias resistências de elevação; três folhas reunidas em duas46, 32
C8OLED passou a 5 V (removidos U3, C8, C9), removidos os díodos limitadores BAV199 de D1 a D3 e botões alterados para montagem em furos passantes40, 31

Etapa 3: posicionar os componentes através do MCP para Altium

O Claude Code efetuou o primeiro posicionamento através do MCP. Não havia sobreposições, mas as linhas de ligação por traçar atravessavam toda a placa, pelo que posicionei manualmente todos os componentes.

Primeiro posicionamento pelo Claude Code

pcb_place_components posicionou 46 componentes numa placa de 75 x 55 mm, cada um com o respetivo UniqueId do esquema e as redes das ilhas. Assim, o Altium considerou a placa sincronizada sem apresentar uma caixa de diálogo ECO. O Claude propôs uma placa de 60 x 45 mm. Aprovei a proposta e os componentes foram deslocados com pcb_import_placement.

claude code placement through the altium mcp

Figura: Posicionamento efetuado pelo Claude Code através do MCP para Altium, antes do posicionamento manual.

Posicionamento manual e correção da serigrafia

Posicionei o conector USB-C no bordo superior, os conectores das pontas de prova no bordo inferior, o conector OLED no topo e as pontes de configuração da alimentação junto da entrada da bateria. Antes de editar, o Claude voltou a ler as posições que eu tinha definido na placa, pelo que não substituiu a minha disposição.

  • Face inferior: J1, J6 e JP1 passaram para a camada inferior e, posteriormente, para padrões de ilhas de conectores SMD apenas nessa face. Como obj_modify não consegue alterar um padrão de ilhas, o Claude eliminou cada componente e voltou a colocá-lo com a mesma posição, rotação e UniqueId.
  • Alinhamento: os componentes equivalentes foram alinhados, por exemplo, com R3-R6 uniformemente espaçadas e J7 alinhado com J3.
  • Legendas de serigrafia: 28 legendas de redes e funções, como números das pontas de prova, pinos do OLED e posições das pontes de configuração.

hand placement of tester on the 60 x 45 mm altium mcp board

Figura: Posicionamento manual do testador na placa de 60 x 45 mm criada com MCP para Altium.

Etapa 4: traçar automaticamente as pistas da placa através do MCP para Altium

A ferramenta pcb_autoroute do eda-agent executa o sistema de traçado de pistas do próprio servidor, e não o sistema Situs do Altium, de acordo com as regras de projeto da placa. Com as regras predefinidas do Altium, atingiu 97.6%; com regras definidas dentro das capacidades de fabrico de placas de 2 camadas da JLCPCB, atingiu 100%.

Regras predefinidas do Altium versus regras ajustadas às capacidades da JLCPCB

RegraPredefinição do AltiumValor utilizadoMínimo da JLCPCB para 2 camadas
Distância de isolamento10 mil0.20 mm0.10 mm
Diâmetro da via e do furo50 e 28 mil24 e 12 mil (0.61 e 0.30 mm)0.25 e 0.15 mm
Barreira de máscara de soldadura10 mil4 mil (0.10 mm)Barreira de 0.10 mm, verde, 1 oz
Largura das pistas10 mil10 mil0.10 mm

Todos os valores ajustados cumprem os mínimos da JLCPCB, e a distância de isolamento e as dimensões das vias mantêm uma margem acima desses mínimos. As regras gerais de traçado de pistas de PCB abrangem a largura e o espaçamento para além desta placa.

ResultadoExecução 1: regras predefinidasExecução 2: regras ajustadas
Conclusão do traçado97.6%100%
Redes por traçar2 (RL2, RL3)0
Pistas de 10 mil269270
Vias e vias em ilhas37, das quais 7 em ilhas48, das quais 0 em ilhas
Alertas de distância de isolamento18, todos entre pares de ilhas de U10
Alertas de barreiras de máscara3114
Aplicado à placaNãoSim

A execução 1 falhou no MCU: RL2 e RL3 não conseguiram chegar a U1, e os 18 alertas de distância de isolamento dizem respeito às próprias ilhas de U1, separadas por 9.84 mil num passo de 0.65 mm, abaixo da distância predefinida de 10 mil. A execução 2 foi aplicada com 270 pistas, 48 vias e sem enchimento de cobre.

Resultados DRC do Altium após o traçado das pistas

A verificação das regras de projeto do Altium encontrou 0 violações no cobre

Regra DRCViolações
Distância de isolamento, curto-circuito, rede por traçar, largura, furo0
Barreira mínima de máscara de soldadura, 4 mil0
Serigrafia à máscara de soldadura, 10 mil0
Serigrafia a serigrafia, 10 mil0

altium drc summary for the altium mcp routed tester

Figura: Resumo DRC do Altium para o testador com pistas traçadas através do MCP para Altium

Etapa 5: ficheiros de saída e documentos do projeto com MCP para Altium

O projeto com MCP produziu o projeto Altium, as respetivas bibliotecas, uma especificação de verificação e relatórios de revisão. Os ficheiros Gerber, de furação, BOM e de posicionamento de componentes ainda não foram gerados, e a placa ainda não foi encomendada.

FicheiroConteúdo
Projeto .PrjPcb e duas folhas SchDocO projeto e o esquema elétrico do Altium
.PcbDocA placa de 60 x 45 mm com as pistas traçadas
.SchLib e .PcbLib16 símbolos; 14 padrões de ilhas mais 2 conectores SMD da face inferior
build_spec.jsonA especificação da correspondência entre pinos e redes para comparação das listas de ligações
Relatório DRC e resultados das tarefas de traçado automáticoVerificação de regras e ambas as execuções do sistema de traçado
PDF do esquema elétricoUma impressão de ambas as folhas

Ficheiros e tarefas ainda necessários para uma encomenda à JLCPCB

  • Questões por resolver: texto de serigrafia de 1.0 mm, a decisão sobre TP4 a TP6, um enchimento ligado à massa, as larguras das pistas de alimentação, a cobertura das vias com máscara e as barreiras de máscara, e a rotação de três referências de componentes.
  • Ficheiros Gerber e de furação: exporte-os seguindo este guia sobre como gerar ficheiros Gerber no Altium Designer.
  • BOM e posicionamento de componentes: exporte ambos a partir das referências JLCPCB já associadas aos componentes para a montagem de PCB.
  • Revisão DFM: carregue os ficheiros Gerber no JLCDFM e verifique aí as barreiras de máscara.

output job setup in altium designer for the ch32v005 tester

Figura: Configuração de Output Job no Altium Designer para o testador CH32V005, pronta para gerar os ficheiros Gerber, de furação, BOM e de posicionamento de componentes para uma encomenda à JLCPCB.

Precisão do MCP para Altium: onde foi necessária revisão humana

O trabalho produzido através do MCP para Altium foi rápido, mas não se verificava a si próprio. A maioria dos erros surgiu durante uma compilação, uma execução ERC ou uma nova leitura da placa, e as decisões de engenharia continuaram a exigir intervenção humana.

Erros e limitações das ferramentas do MCP para Altium neste projeto

ProblemaCorreção
A criação de símbolos em lote colocou todos os pinos no último símboloUm símbolo por chamada, com verificação do número de pinos
Uma alteração do Claude ao script de geração de folhas colocou duas etiquetas de rede em comentárioDetetado na compilação e no ERC; etiquetas repostas
O redesenho de uma folha voltou a atribuir quatro UniqueIdsQuatro componentes da placa novamente posicionados com os novos ID
U1 deslocou-se até 0.5 mm após edições por eliminação e reposicionamentoReposto na posição; as posições são agora relidas após cada edição
Uma consulta à PCB leu outra placa abertaA placa é agora ativada antes de cada consulta
obj_modify não consegue alterar um padrão de ilhas nem a rotação do textoComponentes novamente posicionados; três rotações ficaram para correção manual
A chamada pcb_autoroute ficou bloqueada durante cerca de 30 minutos após a conclusão da tarefaResultado recuperado a partir do estado da tarefa

Decisões de projeto tomadas pelo engenheiro

  • Aprovar o CH32V005F6P6 e as dimensões de 60 x 45 mm da placa
  • Duas pontes de configuração separadas em vez de um interruptor deslizante
  • Remover o conversor de níveis e os limitadores das pontas de prova, e alimentar o OLED a 5 V
  • Posicionar todos os componentes, deslocar J1, J6 e JP1 para a face inferior e aprovar cada eliminação

Onde a IA poupa tempo na criação de protótipos com MCP para Altium

A IA pode reduzir o tempo necessário para obter um protótipo, produzindo ficheiros de projeto repetitivos mais depressa do que seriam desenhados manualmente.

  • Bibliotecas e folhas: os primeiros 16 símbolos e três folhas de esquema elétrico demoraram cerca de 17 minutos, e a biblioteca de 14 padrões de ilhas cerca de 9 minutos.
  • Pesquisa de componentes: o Claude comparou seis MCU com as existências da JLCPCB em tempo real e encontrou uma alternativa com disposição de pinos idêntica, uma comparação com verificação de disponibilidade que uma pesquisa Web genérica não fornece num único passo.
  • Verificações repetidas: após cada alteração, foram executados o ERC, comparações das listas de ligações e resumos DRC.

Ainda assim, neste projeto, todas as etapas do desenvolvimento da PCB continuaram a exigir intervenção humana.

Consumo de tokens do MCP para Altium: modelos e chamadas de ferramentas por sessão

O projeto decorreu ao longo de duas sessões do Claude Code e processou cerca de 186 milhões de tokens. Cerca de 98% corresponderam a leituras da memória cache, porque cada resposta relê toda a conversa. Na sessão 2, os modelos foram alterados com /model.

ItemSessão 1Sessão 2Total
Trabalho abrangidoDo esquema elétrico ao posicionamento manualPadrões de ilhas, traçado de pistas, DRCProjeto completo
ModeloClaude Opus 5.5Claude Opus 5.5 (49 respostas), Claude Sonnet 5.5 (45)Misto
Respostas do assistente36596461
Total de chamadas de ferramentas536109645
Chamadas de ferramentas MCP para Altium34084424
Tokens de saída345,67939,036384,715
Entrada sem cache8002021,002
Entrada gravada na cache2,386,008664,0513,050,059
Entrada lida da cache165,279,61617,456,267182,735,883
Total processado168,012,10318,159,556186,171,659
  • O que aumentou a contagem: resultados extensos de ferramentas inseridos diretamente na conversa, como dados de posicionamento, listas de ligações e uma lista DRC com 207 entradas, além dos redesenhos após o erro na criação de símbolos em lote.
  • Como reduzi-la: guardar os resultados extensos num ficheiro e resumi-los com um script, como foi feito para o relatório DRC.

the eda agent status window in altium designer

Figura: A janela de estado EDA Agent no Altium Designer a registar pedidos MCP para Altium: 440 pedidos em 2 h 10 min de funcionamento, cada um com a respetiva duração.

Conclusão

Um servidor MCP para Altium transforma o Claude Code num operador CAD rápido dentro do Altium Designer, e não num projetista autónomo de PCB. Utilize o Claude Code para pesquisar componentes com verificação de disponibilidade e o servidor para símbolos, padrões de ilhas, desenho do esquema elétrico e execuções de traçado de pistas, mantendo as decisões do circuito, o posicionamento e a revisão final sob a responsabilidade do engenheiro.

Com esta divisão de tarefas, o testador CH32V005 passou da seleção dos componentes a uma placa de 2 camadas com as pistas traçadas em duas sessões. Analise qualquer servidor MCP de terceiros antes de o instalar.

jlcpcb pcb assembly service banner 1
Dê vida ao seu projeto de PCB no Altium
Obter um orçamento instantâneo
  • Depois de finalizar o projeto da PCB e de este passar nas verificações DFM necessárias, exporte os ficheiros Gerber e carregue-os na JLCPCB para obter um orçamento instantâneo de fabrico.

  • Transforme o seu projeto de PCB assistido por IA numa placa física.

Perguntas frequentes sobre o MCP para Altium

Pode um servidor MCP para Altium projetar uma PCB de forma autónoma?

Não. Neste projeto, o Claude Code desenhou o esquema elétrico, posicionou os componentes e traçou as pistas da placa, mas o engenheiro tomou as decisões do circuito, definiu o posicionamento final e aprovou cada eliminação.

Um servidor MCP para Altium envia os dados do meu projeto para a IA?

Sim. Tudo o que o servidor lê, como valores dos componentes, nomes de redes e parâmetros, entra na conversa do Claude Code e é processado pelo fornecedor de IA. Verifique esta questão antes de abrir projetos confidenciais.

O servidor MCP para Altium utiliza o sistema de traçado automático do próprio Altium?

Não. A ferramenta pcb_autoroute do eda-agent executa o sistema de traçado desenvolvido pelo próprio servidor segundo as regras de projeto da placa e só grava pistas e vias depois de a tarefa ser aplicada.

Que versão do Altium Designer funciona com este servidor MCP?

Segundo o README do eda-agent, é preferível utilizar o Altium Designer 20 ou posterior, com Python 3.11 ou posterior. Neste projeto foram utilizados o Altium Designer 26.11.1.5 e o eda-agent 0.8.1.

Pode uma placa criada com MCP para Altium seguir diretamente para fabrico?

Não. Esta placa ainda necessita dos ficheiros Gerber, de furação, BOM e de posicionamento de componentes, de texto de serigrafia de 1.0 mm e de uma revisão DFM das barreiras de máscara antes da encomenda.

Saber mais