Altium MCP com Claude Code: Da Configuração ao Design de PCB
27 min
- 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

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

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.

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 ferramenta | Atua sobre | Utilização neste projeto |
|---|---|---|
| lib_ | Bibliotecas .SchLib e .PcbLib | Símbolos, padrões de ilhas e associações aos padrões de ilhas |
| sch_ | O ficheiro .SchDoc aberto | Desenho de folhas a partir de modelos |
| pcb_ | O ficheiro .PcbDoc aberto | Posicionamento e traçado de pistas |
| obj_ | Objetos do esquema elétrico ou da placa | Cobertura de vias com máscara, edições e eliminações |
| proj_ | O projeto | Compilação, redes e ERC |
| app_ | O próprio Altium | Gravaçã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:
|
|---|
2. Registe o projeto de scripts no Altium uma única vez: Preferences > Scripting System > Global Projects > Install from file e selecione Altium_API.PrjScr.

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.

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:
|
|---|
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:
- AVR Transistortester: o projeto original de Markus Frejek, continuado por Karl-Heinz Kübbeler, na página AVR Transistortester do mikrocontroller.net.
- Código-fonte e manuais: o repositório transistortester, com o firmware, os ficheiros de hardware e a documentação.
- ArduTester V1.13: a adaptação para Arduino Uno de plouc68000, no Arduino Project Hub.
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
| MCU | Existências da JLCPCB em 2026-11-03 | Alteração necessária na placa |
|---|---|---|
| CH32V006F8P6 (original) | 0 | Nenhuma, mas não estava disponível para compra |
| CH32V005F6P6 (C54824605) | 195 | Nenhuma, disposição de pinos idêntica em TSSOP-20 |
| CH32V007 | 0 | Novo encapsulamento |
| CH32V003F4P6 | 25,148 | Nenhuma, mas os 16 KB de memória flash não chegam para o firmware de 19,448 bytes |
| PY32F030F18P6 | 379 | Nova disposição de pinos e adaptação do firmware |
| ATmega328P-AU | 35,775 | Reformulaçã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ência | Referência do fabricante # | Referência JLCPCB # | Função |
|---|---|---|---|
| U2 | MCP1702-5002E/MB, SOT-89 | C18299 | LDO de 9 V para 5 V, corrente de repouso típica de 2 µA |
| D4 | SS14 Schottky, SMA | C2480 | Proteção contra inversão da polaridade da bateria |
| J4 | SHOU HAN USB-C de 6 pinos | C456012 | Entrada USB apenas para alimentação |
| F1 | SMD0603P025TF | C20786 | Fusível PTC de 250 mA na ligação USB |
| R1 a R6 | 680 Ω e 470 kΩ 1%, 0603 | C23228, C23178 | Resistências das pontas de prova |
| C3, C6 | 10 µF 25 V, 0603 | C96446 | Condensadores de reserva de energia |
| SW1, SW2 | HRO K2-1102DP-C4SW-04 | C110153 | Botõ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.

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 MCU | Rede | Função |
|---|---|---|
| PA2, PD3, PD2 | TP1, TP2, TP3 | Entradas ADC das pontas de prova; TP1 e TP2 também estão ligados ao comparador |
| PD0, PC7, PC5 | RL1 a RL3 | Excitação das pontas de prova através de 680 Ω |
| PC0, PC6, PC3 | RH1 a RH3 | Excitação das pontas de prova através de 470 kΩ |
| PA1 | VTH | Entrada do limiar do comparador |
| PD4 | CMP_OUT | Saída do comparador para a captura do TIM2 |
| PC4 | BTN_VBAT | Medição da alimentação e botão TEST |
| PC1, PC2 | SDA, SCL | Barramento I2C do OLED |
| PD5, PD6 | DBG_TX, DBG_RX | Depuração UART |
| PD1, PD7 | SWIO, NRST | Programaçã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.

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ão | Alteração | Componentes, redes |
|---|---|---|
| C2 | Interruptor 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 V | 48, 33 |
| C4 | Adicionada a ponte de configuração da bateria JP4 | 52, 34 |
| C5 | Removido o conversor de níveis I2C (Q1, Q2, R16, R17) | 48, 32 |
| C6 | Removidas R9 e R10, porque o módulo OLED tem as suas próprias resistências de elevação; três folhas reunidas em duas | 46, 32 |
| C8 | OLED 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 passantes | 40, 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.

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.

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
| Regra | Predefinição do Altium | Valor utilizado | Mínimo da JLCPCB para 2 camadas |
|---|---|---|---|
| Distância de isolamento | 10 mil | 0.20 mm | 0.10 mm |
| Diâmetro da via e do furo | 50 e 28 mil | 24 e 12 mil (0.61 e 0.30 mm) | 0.25 e 0.15 mm |
| Barreira de máscara de soldadura | 10 mil | 4 mil (0.10 mm) | Barreira de 0.10 mm, verde, 1 oz |
| Largura das pistas | 10 mil | 10 mil | 0.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.
| Resultado | Execução 1: regras predefinidas | Execução 2: regras ajustadas |
|---|---|---|
| Conclusão do traçado | 97.6% | 100% |
| Redes por traçar | 2 (RL2, RL3) | 0 |
| Pistas de 10 mil | 269 | 270 |
| Vias e vias em ilhas | 37, das quais 7 em ilhas | 48, das quais 0 em ilhas |
| Alertas de distância de isolamento | 18, todos entre pares de ilhas de U1 | 0 |
| Alertas de barreiras de máscara | 31 | 14 |
| Aplicado à placa | Não | Sim |
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 DRC | Violações |
|---|---|
| Distância de isolamento, curto-circuito, rede por traçar, largura, furo | 0 |
| Barreira mínima de máscara de soldadura, 4 mil | 0 |
| Serigrafia à máscara de soldadura, 10 mil | 0 |
| Serigrafia a serigrafia, 10 mil | 0 |

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.
| Ficheiro | Conteúdo |
|---|---|
| Projeto .PrjPcb e duas folhas SchDoc | O projeto e o esquema elétrico do Altium |
| .PcbDoc | A placa de 60 x 45 mm com as pistas traçadas |
| .SchLib e .PcbLib | 16 símbolos; 14 padrões de ilhas mais 2 conectores SMD da face inferior |
| build_spec.json | A 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ático | Verificação de regras e ambas as execuções do sistema de traçado |
| PDF do esquema elétrico | Uma 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.

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
| Problema | Correção |
|---|---|
| A criação de símbolos em lote colocou todos os pinos no último símbolo | Um 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ário | Detetado na compilação e no ERC; etiquetas repostas |
| O redesenho de uma folha voltou a atribuir quatro UniqueIds | Quatro componentes da placa novamente posicionados com os novos ID |
| U1 deslocou-se até 0.5 mm após edições por eliminação e reposicionamento | Reposto na posição; as posições são agora relidas após cada edição |
| Uma consulta à PCB leu outra placa aberta | A placa é agora ativada antes de cada consulta |
| obj_modify não consegue alterar um padrão de ilhas nem a rotação do texto | Componentes 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 tarefa | Resultado 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.
| Item | Sessão 1 | Sessão 2 | Total |
|---|---|---|---|
| Trabalho abrangido | Do esquema elétrico ao posicionamento manual | Padrões de ilhas, traçado de pistas, DRC | Projeto completo |
| Modelo | Claude Opus 5.5 | Claude Opus 5.5 (49 respostas), Claude Sonnet 5.5 (45) | Misto |
| Respostas do assistente | 365 | 96 | 461 |
| Total de chamadas de ferramentas | 536 | 109 | 645 |
| Chamadas de ferramentas MCP para Altium | 340 | 84 | 424 |
| Tokens de saída | 345,679 | 39,036 | 384,715 |
| Entrada sem cache | 800 | 202 | 1,002 |
| Entrada gravada na cache | 2,386,008 | 664,051 | 3,050,059 |
| Entrada lida da cache | 165,279,616 | 17,456,267 | 182,735,883 |
| Total processado | 168,012,103 | 18,159,556 | 186,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.

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.
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.
Artigos Populares
Saber mais
Altium MCP com Claude Code: Da Configuração ao Design de PCB
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......
Roteadores de PCB: Ferramentas Essenciais para o Design de Circuitos Modernos
Introdução Na produção moderna de PCBs, as máquinas de roteamento (comumente chamadas de roteadoras de PCB ou roteadoras CNC) desempenham um papel crítico. Elas são usadas para cortar o contorno da placa, criar sulcos em V para despainelização, fresar ranhuras e finalizar bordas com alta precisão. À medida que os dispositivos eletrônicos se tornam menores e mais complexos, as roteadoras de PCB garantem resultados limpos, precisos e repetíveis. Este artigo explica o que são roteadoras de PCB, seus tipo......
Guia de Design de Vias em PCB: Melhores Práticas, Dicas e Considerações Essenciais
O design de PCB de alta qualidade não requer apenas conceitos inovadores, mas também depende de um profundo entendimento dos processos de fabricação de PCB. O design de vias, sendo uma das etapas críticas no design de PCB, é crucial tanto para o desempenho do PCB quanto para a eficiência de fabricação. As vias podem ser projetadas em qualquer tamanho? Para responder a esta pergunta, vamos primeiro entender como os furos em um PCB são criados. 1. Corte do Material: Os fabricantes de PCB usam máquinas d......
Guia Passo a Passo para Criar Footprints de PCB Personalizados
Se você precisa de uma pegada de PCB, mas ela não existe na biblioteca de componentes do EasyEDA, você mesmo pode criá-la. E criar um dispositivo também requer uma biblioteca de pegadas para ser concluído. O método de uso da ferramenta de biblioteca de pegadas é o mesmo da ferramenta de PCB em PCB, mas há algumas funções desnecessárias na barra de ferramentas. A biblioteca de pegadas representa graficamente os vários parâmetros de componentes eletrônicos, chips, etc. (como o tamanho dos componentes, c......
Notas importantes sobre o design de vias em PCB
Um design de PCB de alta qualidade não requer apenas conceitos inovadores, mas também depende de um profundo entendimento dos processos de fabricação de PCB. O design de vias, como uma das etapas críticas no design de PCB, é crucial tanto para o desempenho do PCB quanto para a eficiência de fabricação. As vias podem ser projetadas em qualquer tamanho? Para responder a esta pergunta, vamos primeiro entender como os furos em um PCB são criados. 1. Corte do Material: Os fabricantes de PCB usam máquinas d......
Escolhendo o Conector USB Certo: As Diretrizes de Design
No mundo da eletrônica, os conectores USB são a espinha dorsal da conectividade, permitindo a transferência de dados e o fornecimento de energia em inúmeros dispositivos. Com vários tipos e padrões disponíveis, selecionar o conector USB certo para o seu projeto requer uma consideração cuidadosa. Este blog irá guiá-lo através das diretrizes essenciais de design para garantir que você escolha o conector USB mais adequado para sua aplicação. Veja o processo completo de fabricação de PCB em nossa postagem......