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

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

When you are already working inside Claude Code, switching to a separate image tool just to create a page illustration, clean up a screenshot, or combine two reference images breaks the flow. The NanoBanana MCP setup described here lets you keep that image workflow inside the terminal, where Claude Code can call the image tools directly from a natural-language request.

What you can do

The source documentation describes NanoBanana as an MCP server for image generation and image editing, backed by Google Gemini image understanding. In practical terms, that means you can ask Claude Code to do work such as:

  • Generate a new illustration from text, for example a small dinosaur illustration for a 404 page.
  • Edit an existing image, such as removing unwanted text from a screenshot and filling the background.
  • Compose multiple images, such as taking an object from one image and placing it naturally into the scene of another image.

The documented tool list is intentionally small: nanobanana_generate_image for text-to-image generation, and nanobanana_edit_image for image editing with multi-image input support. That limited surface area is useful: most day-to-day image tasks become either “make a new image” or “change these image inputs.”

How it works

Claude Code connects to NanoBanana through an MCP server endpoint. Once the server is registered, Claude Code can route natural-language requests to the relevant NanoBanana tool. The documented endpoint is:

https://nanobanana.mcp.acedata.cloud/mcp

The MCP server is added with claude mcp add, using HTTP transport and an authorization header. The important detail in the documentation is that -H must be uppercase. Lowercase -h is interpreted as --help, not as a header flag.

Configure NanoBanana in Claude Code

Run the documented command in your terminal, replacing the token placeholder with your Ace Data Cloud API token:

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

If you omit a scope flag, Claude Code uses the default local scope, which only applies in the directory where you run the command. The documentation also describes two explicit scopes that are worth choosing deliberately:

  • local: no -s flag, or -s local. The config is stored in ~/.claude.json and applies to the current project directory.
  • user: use -s user. The config is stored in ~/.claude.json and is available across all projects.
  • project: use -s project. The config is written to .mcp.json in the project root, so it can be shared with a team.

For a personal setup, -s user is convenient. For a team repository, -s project makes the integration visible to collaborators. The documentation warns not to commit real tokens to public repositories; use environment-variable placeholders instead.

Verify the connection before asking for images

After adding the server, verify that Claude Code can see it:

claude mcp list

The expected result is that nanobanana appears as connected. This small check saves time: if the MCP server is not connected, your image request will fail before it reaches the actual generation or editing step.

Use case 1: generate a page illustration

For UI and web projects, the fastest win is usually a simple illustration that matches the state of the page. In a Claude Code session, you can ask for something like:

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

Claude Code can route this to nanobanana_generate_image. The value is not just the generated image; it is that the prompt can be written while you are already editing the page that will use it.

Use case 2: edit a screenshot without leaving the terminal

The documentation gives a common editing case: removing unwanted text from an image and filling the background. A request can be phrased naturally:

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

This maps to nanobanana_edit_image. For builders, this is useful for documentation screenshots, landing-page mockups, and quick internal assets where opening a full design tool would be slower than describing the edit.

Use case 3: compose multiple reference images

The more interesting workflow is multi-image composition. The documentation notes that nanobanana_edit_image supports multiple image URLs as input, and that Gemini can understand relationships between images. A practical request might be:

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

This is the kind of task where image understanding matters. You are not only applying a filter; you are asking the model to identify an object, understand a target scene, and blend the result with plausible angle and lighting.

A simple builder workflow

  1. Add the NanoBanana MCP server with claude mcp add nanobanana.
  2. Choose the right scope: user for your own machine, project for a shared repo.
  3. Run claude mcp list and confirm that nanobanana is connected.
  4. Ask Claude Code for either a new image or an edit to one or more image URLs.
  5. Use the output directly in your documentation, UI prototype, or content workflow.

That is the main reason this integration is useful: it turns image generation and editing into part of the same terminal loop where you already plan, code, and revise.

If you want the exact setup reference, read the original 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