Use Flux in your AI tools

Use Flux from the AI tools that you already work in. Your coding agent or chat assistant reads the live design and hands hardware design work to Flux.


The Flux MCP server connects external AI clients to your Flux projects. A connected client can read live project information, start a design thread, and ask Flux to make changes.

What you can do

Use a connected client to:

  • Read project names, components, pins, nets, and PCB information.

  • Start a thread with Flux and describe a design change.

  • Read the updated project after Flux completes the work.

  • Use project design information to keep firmware and hardware aligned.

Supported clients

Flux provides setup steps for Claude Code, Claude.ai, Cursor, VS Code, Codex, ChatGPT, and Notion AI.

Connect a client

Use a client that supports remote MCP connections. The production server address is https://app.flux.ai/mcp. Open the setup steps in Flux:

  1. Open a project and select AI Integrations in the chat composer.

  2. Select Manage integrations.

  3. Select Flux MCP.

  4. Select your client and follow its setup steps.

Flux uses OAuth when a client connects. Sign in with your Flux account in the browser window that opens.

Use an API key

Create an API key in Settings → API Keys. Configure the client to send the key as a bearer token:

Authorization: Bearer <your-api-key>

API key permissions control which projects and actions the client can access. Grant project read access to read project data, write access to make design changes, and agent access to ask Flux to complete design work.

Claude Code

  1. Add the Flux server from a terminal:

    claude mcp add -t http flux https://app.flux.ai/mcp

  2. Run /mcp in Claude Code.

  3. Complete the Flux sign-in in your browser.

Claude.ai

  1. Open Settings → Connectors.

  2. Select Add custom connector.

  3. Enter a name, such as Flux, and the server address https://app.flux.ai/mcp.

  4. Select Add and complete the Flux sign-in.

Cursor

  1. Open Settings → Tools & MCP → New MCP Server.

  2. Add the Flux server URL:

    {
    "mcpServers": {
    "flux": {
    "url": "https://app.flux.ai/mcp"
    }
    }
    }

  3. Save the configuration and complete the Flux sign-in.

VS Code

  1. Open the Command Palette and run MCP: Add Server.

  2. Select HTTP and enter https://app.flux.ai/mcp.

  3. Name the server flux.

  4. Complete the Flux sign-in.

Codex

  1. Add the Flux server:

    codex mcp add flux --url https://app.flux.ai/mcp

  2. Start a Codex session and run /mcp.

  3. Complete the Flux sign-in.

ChatGPT

  1. Open Settings → Connectors.

  2. In Advanced settings, enable developer mode.

  3. Select Create and add a remote MCP server at https://app.flux.ai/mcp.

  4. Complete the Flux sign-in.

Notion AI

  1. Ask a workspace owner to enable custom MCP connections under Settings → Notion AI → AI connectors.

  2. In the agent's Tools & Access settings, select Add connection → Custom MCP server.

  3. Enter https://app.flux.ai/mcp.

  4. Complete the Flux sign-in.

Verify the connection

Ask the connected client to list your Flux projects. Then ask it to open a project and summarize its components and nets. The project list and design summary confirm that the connection works.

Example workflow

Use a coding client to review the board, ask Flux to update the schematic, and read the revised design:

Open my Flux project for the air-quality monitor. Review the components and nets, then ask Flux to add a low-battery indicator to the schematic.
Read the updated project. List the pins and nets for the microcontroller so I can update the firmware pin map.

For a mechanical design workflow, ask Flux to add a part that fits the board:

Ask Flux to design an enclosure for this board. Include the mounting holes, connector openings, and space for the battery.
Read the project and report the enclosure's mounting-hole positions and connector clearances.

Restrict access to an organization

For OAuth, select the organization on the consent page. For an API key, select the organization when you create the key. The client can then access projects owned by that organization.

FAQs

Can I use Flux from another AI client?

Yes. Connect a client that supports remote MCP. Flux provides setup steps for the clients listed above.

Can a connected client read and edit a project?

Yes. The client can read project information and ask Flux to make design changes in the project.

How do I reconnect a client?

Open the client's MCP settings, select the Flux connection, and complete the Flux sign-in again.

How do I use Flux with another client?

Open AI Integrations → Manage integrations → Flux MCP and follow the setup steps for that client.

Next steps


On This Page
Use Flux in your AI toolsWhat you can doSupported clientsConnect a clientVerify the connectionExample workflowRestrict access to an organizationFAQsNext stepsUse an API keyClaude CodeClaude.aiCursorVS CodeCodexChatGPTNotion AICan I use Flux from another AI client?Can a connected client read and edit a project?How do I reconnect a client?How do I use Flux with another client?