How to Use NanoBanana MCP in Claude Code for Terminal-Based Image Editing

How to Use NanoBanana MCP in Claude Code for Terminal-Based Image Editing

If your image workflow still means jumping between a browser, a prompt box, a download folder, and your code editor, the context switching becomes the real bottleneck. The NanoBanana MCP setup for Claude Code gives you a cleaner path: call image generation and editing tools from the same terminal session where you are already building.

What you can do

The documented integration connects Claude Code to the NanoBanana MCP server at https://nanobanana.mcp.acedata.cloud/mcp. Once configured, Claude Code can invoke two tools exposed by the server:

  • nanobanana_generate_image for text-to-image generation.
  • nanobanana_edit_image for image editing, including workflows that use multiple image URLs as input.

The interesting part is not only that you can generate an image. It is that you can describe practical edits in natural language while Claude Code handles the MCP tool call. The source documentation highlights scenarios such as putting an object from one image into the scene of another image, removing unwanted text from an image, and creating an illustration for a page such as a 404 screen.

How it works

Claude Code supports adding an MCP server over HTTP. For NanoBanana, the configuration command registers a server named nanobanana, points it at the Ace Data Cloud MCP endpoint, and passes an authorization header. After that, Claude Code can list the MCP connection and make the server’s tools available inside your session.

The integration uses the standard pattern shown in the documentation: an HTTP transport, the MCP endpoint URL, and an Authorization header containing your API token. The docs also call out a small but important CLI detail: -H must be uppercase because lowercase -h is interpreted as help, not as a header parameter.

Configure the MCP server

Start in the terminal where you use Claude Code. Replace YOUR_API_TOKEN with the token from your Ace Data Cloud account. The command from the documentation is:

claude mcp add nanobanana --transport http https://nanobanana.mcp.acedata.cloud/mcp   -H "Authorization: Bearer YOUR_API_TOKEN"

By default, if you do not pass -s, the scope is local. That means the server is effective only in the project directory where you ran the command. The documentation lists three scopes:

  • local: the default behavior, stored in ~/.claude.json, effective only in the current project directory.
  • user: selected with -s user, stored in ~/.claude.json, available across projects.
  • project: selected with -s project, stored in .mcp.json in the project root, so the configuration can be shared with the team.

If you choose project scope, the docs recommend using an environment-variable placeholder such as ${ENV_VAR} rather than committing a real token. That keeps the shared configuration useful without exposing credentials in a repository.

Verify the connection

After adding the server, check whether Claude Code can see it:

claude mcp list

The expected result is that nanobanana appears as ✓ Connected. This quick check is worth doing before you start writing prompts, because it separates configuration problems from prompt or image-input problems.

Use it for real image tasks

Once connected, the workflow becomes conversational inside Claude Code. For a multi-image composition, you can ask Claude Code to use NanoBanana to place an object from one image into a scene from another image. The documented example is:

Put the phone from the first image onto the desk in the second image, adjusting angle and lighting to make it look natural

For cleanup work, the docs show a prompt for removing unwanted text:

Edit this image to remove the text watermark in the bottom right corner, filling the background

For product or web UI work, you can also generate page art directly from a brief:

Generate an illustration of a small dinosaur crouching next to a crack in the ground looking down, for use on a 404 page

These are small examples, but they map well to everyday builder tasks: replacing a hero image, cleaning up a screenshot before adding it to docs, producing a quick empty-state illustration, or combining reference assets while staying in the same terminal workflow.

A practical workflow pattern

  1. Add the MCP server with claude mcp add nanobanana.
  2. Verify it with claude mcp list.
  3. Keep image URLs close to the task description when using nanobanana_edit_image.
  4. Describe the edit in terms of objects, scene, lighting, and the desired final use.
  5. Save the final image into your project assets, docs, or blog pipeline.

The main advantage is continuity. Claude Code already knows what you are building, so the image task can be part of the same implementation conversation instead of a separate design detour.

If you want the exact setup details and related examples, read the Ace Data Cloud documentation for Claude Code integration with NanoBanana MCP.

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
Image
Nexior is an open-source project on GitHub that allows us to deploy our AI application site with one click, including AI Q&A, Midjourney drawing, knowledge base Q&A, artistic QR codes, and more. There is no need to develop AI systems, purchase AI accounts, worry about API support, or configure payment systems. It comes with zero startup costs and allows you to earn income through AI without risk. This article will introduce the deployment process of the Nexior project on Vercel. Without any programming skills, you can deploy your AI site in a few minutes and easily generate revenue. Preparation First, open the Nexior GitHub repository at: https://github.com/AceDataCloud/Nexior , then register or log in to your GitHub account. Click Fork to clone the code to your local repository, as shown below: After completing the Fork, we will get our personal repository, as shown below: In this example, the account is Germey, so we can see that we have Forked to the Germey user, wit...
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