Go back

Connect Claude Code or Codex to your Velxio project

Velxio has had an AI agent inside the app for a while: ask it for a circuit and it places the parts, wires them, writes the sketch and runs it. Today we are turning that around. With Connect AI agent, your own agent — the Claude Code or OpenAI Codex you already run in your terminal — can reach into a saved Velxio project and build it for you, live on the canvas.

It works over MCP, the Model Context Protocol: Velxio exposes its circuit and code tools as an MCP server, and you point your agent at it with a token scoped to one project.

The Connect AI agent modal in Velxio: Claude Code and Codex tabs, the one-line setup command, and the active connection with a Revoke button

Why connect your own agent?

The in-app agent is great when you are already in Velxio. But a lot of people live in their terminal, in the middle of a bigger project — a firmware repo, a hardware bring-up, a class assignment — and want the circuit and the sketch to come together there, in the same session as the rest of their work. Now the agent you are already talking to can do the hardware half in Velxio, with the board, the wiring and the simulator handled for it.

How it works, in three steps

  1. Save a project in Velxio (the agent connects to a saved project).

  2. Open File → Connect AI agent (Claude/Codex), pick your CLI, and click Generate connection token.

  3. Run the one line it gives you:

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

    (Codex users get a ~/.codex/config.toml snippet instead.)

Then just ask, from your terminal:

“Using the velxio tools, wire an HC-SR04 to the board and write the firmware that prints the distance over serial.”

Your agent gets Velxio’s full toolset — add and wire components, add boards, seat parts on a breadboard, write and edit the sketch, validate the circuit — plus the per-component skills the in-app agent uses, so it knows the exact pin names for an SSD1306 or a DHT22 instead of guessing. Every change lands on your open Velxio canvas within a few seconds. When it is done, press Run.

Built to be safe to paste into a CLI

A token you hand to a third-party tool has to be a narrow thing, so it is:

If a token ever ends up somewhere it shouldn’t, one click kills it.

Availability

Connect AI agent is part of Velxio Pro ($19/mo). Free and Maker plans keep the in-app Agent and Tutor modes.

Open a project, point your agent at it, and let it build.


Share this post on:
David Montero

Written by

David Montero

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

GitHub velxio.dev

Related posts


Next Post
DFRobot and Velxio: the UNIHIKER, HuskyLens and six Gravity sensors you can try before you wire anything