Voltar

Conecte o Claude Code ou o Codex ao seu projeto Velxio

O Velxio já tem um agente de IA dentro do aplicativo há algum tempo: peça um circuito e ele posiciona os componentes, faz as conexões, escreve o sketch e o executa. Hoje estamos invertendo isso. Com o Connect AI agent, o seu próprio agente — o Claude Code ou o OpenAI Codex que você já usa no seu terminal — pode acessar um projeto salvo no Velxio e construí-lo para você, ao vivo no canvas.

Funciona via MCP, o Model Context Protocol: o Velxio expõe suas ferramentas de circuito e código como um servidor MCP, e você aponta seu agente para ele com um token limitado a um único projeto.

O modal Connect AI agent no Velxio: abas Claude Code e Codex, o comando de configuração em uma linha e a conexão ativa com o botão Revoke

Por que conectar seu próprio agente?

O agente integrado é ótimo quando você já está no Velxio. Mas muita gente vive no terminal, no meio de um projeto maior — um repositório de firmware, a montagem de um hardware, um trabalho de faculdade — e quer que o circuito e o sketch sejam criados ali, na mesma sessão do resto do trabalho. Agora o agente com quem você já conversa pode cuidar da parte de hardware no Velxio, com a placa, as conexões e o simulador resolvidos para ele.

Como funciona, em três passos

  1. Salve um projeto no Velxio (o agente se conecta a um projeto salvo).

  2. Abra Arquivo → Connect AI agent (Claude/Codex), escolha seu CLI e clique em Generate connection token.

  3. Execute a linha que ele fornecer:

    claude mcp add --transport http velxio https://velxio.dev/api/pro/mcp \
      --header "Authorization: Bearer vlxmcp_your_token_here"

    (Usuários do Codex recebem um trecho de ~/.codex/config.toml em vez disso.)

Depois é só pedir, direto do seu terminal:

“Usando as ferramentas do velxio, conecte um HC-SR04 à placa e escreva o firmware que imprime a distância pela serial.”

Seu agente recebe o conjunto completo de ferramentas do Velxio — adicionar e conectar componentes, adicionar placas, encaixar peças em uma breadboard, escrever e editar o sketch, validar o circuito — além das skills por componente que o agente integrado usa, para que ele saiba os nomes exatos dos pinos de um SSD1306 ou de um DHT22 em vez de adivinhar. Cada alteração aparece no seu canvas aberto do Velxio em poucos segundos. Quando terminar, pressione Run.

Feito para ser seguro colar no CLI

Um token que você entrega a uma ferramenta de terceiros precisa ser algo restrito, e é exatamente isso que ele é:

Se um token acabar em algum lugar onde não deveria, um clique resolve.

Disponibilidade

O Connect AI agent faz parte do Velxio Pro (US$ 19/mês). Os planos Free e Maker continuam com os modos Agent e Tutor integrados.

Abra um projeto, aponte seu agente para ele e deixe que ele construa.


Compartilhar em:
David Montero

Escrito por

David Montero

Creator of Velxio, the open-source circuit and Arduino simulator.

GitHub velxio.dev

Artigos relacionados


Artigo anterior
Traga seu próprio WiFi — pontos de acesso personalizados, captura de pacotes e sua rede local
Próximo artigo
DFRobot e Velxio: o UNIHIKER, a HuskyLens e seis sensores Gravity que você pode testar antes de conectar qualquer fio