How to Add Flux MCP to Claude Code for Image Generation

How to Add Flux MCP to Claude Code for Image Generation

When you are working inside Claude Code, switching to a browser just to generate or edit an image breaks the flow. The Flux MCP setup lets Claude Code call a remote image-generation tool from the same terminal session, so you can keep the surrounding project context in place while producing visual assets.

What you can do

The Flux MCP guide describes a Claude Code integration for image generation and image editing through Ace Data Cloud. Once configured, Claude Code can call Flux from natural language prompts instead of making you leave the editor.

  • Use flux_generate_image for text-to-image generation.
  • Use flux_edit_image for editing an existing image.
  • Start with fast draft exploration using Flux Dev.
  • Move to Flux Pro when you want more detail and resolution.
  • Use Flux Kontext when you need to change an existing image without regenerating everything.

The key idea is not that MCP replaces Claude Code. It adds a callable tool surface to the coding session, so Claude Code can help with assets that sit next to your code: README illustrations, developer blog covers, release visuals, or small image edits.

How it works

Claude Code supports MCP servers. In this setup, you add a remote server named flux and point it to https://flux.mcp.acedata.cloud/mcp. Authentication is passed through an HTTP header:

Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY

The guide calls out one small but important detail: the -H option must be uppercase. Lowercase -h is interpreted as help. That is the kind of issue that can make an otherwise-correct setup look broken.

You also choose a configuration scope. Claude Code writes the setting differently depending on whether you use local, user, or project.

Choose the right configuration scope

For a quick test, use -s local. The configuration is bound to the current project directory and written into the local Claude configuration with the current path.

claude mcp add flux --transport http https://flux.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s local

If you expect to use Flux from many repositories, use -s user. That makes the server available across projects opened in Claude Code.

claude mcp add flux --transport http https://flux.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s user

For a team project, use -s project. The guide notes that this writes to .mcp.json in the project root. That can be useful for a private repository, but do not commit a real token to a public repository. Prefer a placeholder or have each teammate add their own local credential.

claude mcp add flux --transport http https://flux.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s project

When Claude Code first reads a project-level configuration, it may show Pending approval. That is a normal trust step for project configuration.

Verify the connection before prompting

After adding the server, verify the handshake from the terminal:

claude mcp list

If the Flux entry shows ✓ Connected, the connection is working. If not, check three things before changing anything else: the token, the service URL, and the scope you used. The source guide also warns against relying on fixed tool counts from older client versions; use the current connection status instead.

Use Flux from Claude Code

Once the server is connected, return to your Claude Code session and ask for the image task in plain language. For early exploration, start with a few visual directions:

Use flux-dev to quickly generate 3 different styles of developer blog cover images, trying flat, realistic, and abstract styles

When one direction looks right, ask for a more polished pass:

Use flux-pro to regenerate the second image, increasing details and resolution

For editing, the documented workflow uses flux_edit_image to modify an existing visual instead of starting over:

Edit this poster image, changing the date in the bottom right corner from 2024 to 2025

That pattern is especially useful when the image is already approved except for one detail: a date, label, small copy change, or localized asset.

A practical workflow for builders

A simple builder-friendly workflow looks like this:

  1. Add Flux MCP locally in a test repository with -s local.
  2. Run claude mcp list and confirm ✓ Connected.
  3. Generate several rough image directions with Flux Dev.
  4. Regenerate the chosen direction with Flux Pro.
  5. Use Kontext-style editing through flux_edit_image when you need a targeted change.
  6. If the workflow becomes part of your daily setup, re-add it with -s user; if it belongs to a private team repo, consider -s project with token hygiene.

The main thing is to keep secrets private. The documentation recommends showing only masked examples such as YOUR_ACEDATACLOUD_API_KEY and not posting the full token in repositories, issues, screenshots, or chat records.

Wrap-up

Flux MCP is a small setup step with a practical payoff: image generation and targeted image editing become part of the same Claude Code session where you are already writing and reviewing code. If you want the exact source commands and the current service URL, read the full Claude Code with Flux MCP guide.

Comments

Post a Comment

Popular posts from this blog

Artistic QR Code API Integration Guidance

Image
Artistic QR code is an innovative technological product that combines QR codes with beautiful background images, creating practical and visually appealing works. They not only possess the functionality of traditional QR codes, allowing quick scanning and recognition by smart devices, but also incorporate artistic elements to enhance visual appeal and brand recognition. Some artistic QR codes are even generated by artificial intelligence, fully leveraging modern technology to demonstrate unparalleled innovation and uniqueness. This makes artistic QR codes widely applicable in areas such as brand marketing and advertising. In simple terms, artistic QR codes are the perfect combination of QR code scanning and artistic aesthetics. They not only provide the function of information transmission, but also enhance the user's visual experience, making each scan a delightful artistic enjoyment. Overview of Artworks Let's take a look at a few QR code works: How are they? These are ar...
Read more

How to Configure Claude Code with CC Switch and Ace Data Cloud

Image
If you use Claude Code across a terminal, VS Code, or remote development setup, the awkward part is often not the model itself but the configuration: where should requests go, where should the token live, and how do you switch providers without editing files by hand? This guide walks through a practical setup using CC Switch as the graphical configuration manager and Ace Data Cloud as the Anthropic-compatible base URL. The goal is simple: configure Claude Code once, verify the active endpoint, and keep the setup easy to change later. What you can do With the setup described in the Ace Data Cloud documentation, you can: Manage Claude Code provider configuration through a desktop UI instead of manually editing settings.json . Store an Ace Data Cloud provider with ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN . Switch the active Claude Code provider from CC Switch without rewriting your configuration every time. Use the same provider configuration from the terminal an...
Read more

How to Build a Server-Side Image Editing Workflow with GPT-Image-2

Image
If your product needs image editing, the hard part is rarely the model call itself. The real challenge is building a reliable workflow around user images, reference assets, predictable output sizes, and slow-running jobs without forcing every file through a manual upload step. This guide walks through a practical server-side workflow using the OpenAI Images Edits API on Ace Data Cloud. The focus is gpt-image-2 , because the documented editing flow supports direct image URLs, base64 input, multiple reference images, high-resolution output through size , and asynchronous callbacks. What you can do The edits endpoint is designed for turning one or more input images plus an instruction into a modified output image. In practical terms, you can use it to: Convert an existing infographic or poster into a different visual theme while preserving its layout. Change a product, shelf, room, or object style while keeping the original arrangement stable. Pass image URLs directly f...
Read more