给 Claude Code 装上"画图和修图的手":接入 Ace Data Cloud NanoBanana MCP
写完代码,产品演示图、README 插图、404 页面配图却还没着落?如果你已经在用 Claude Code,不必为每张图切换到另一个网页:通过 Ace Data Cloud 的 NanoBanana 远程 MCP Server,可以在开发对话中提出文生图、改图和多图合成需求,让 Claude Code 调用相应工具。
这篇文章按 Ace Data Cloud 官方的 Claude Code + NanoBanana MCP 教程 梳理配置、验证与实际用法。它是接入指南,不是生成效果的实测报告。
为什么是 NanoBanana MCP?
NanoBanana 基于 Google Gemini 的图像理解能力,除了文本生成图片,也适合针对已有图片做编辑,或给出多张图片进行组合。例如把第一张图片的产品放入第二张图片的场景,同时要求角度与光线自然。这比只写"生成一张图片"更贴近产品视觉、页面配图、素材迭代等工作流。
Ace Data Cloud 的价值不只是提供一个图像接口:它把 NanoBanana 等能力封装成托管的远程 MCP Server 。Claude Code 负责理解项目上下文和你的要求,MCP 工具负责执行具体操作。按平台文档,同一个 Ace Data Cloud API Token 还能用于平台提供的其他 MCP Server,不需要给 NanoBanana 单独申请一套 Token。更多能力和选择见 Claude Code MCP 总览。
第一步:获取 Token
进入 Ace Data Cloud 应用列表,登录后获取你的 API Token。官方教程说明首个应用附带体验额度;实际可用额度以控制台显示为准。不要 把完整 Token 放进公开仓库、截图、Issue 或文章。下文的 YOUR_ACEDATACLOUD_API_KEY 只是占位符,需要在自己的环境中替换。
第二步:在 Claude Code 中添加 MCP
建议先用 local 作用域,在当前项目验证,避免一开始影响其他项目。注意 -H 是大写字母 H,用来传递认证 Header;小写 -h 是帮助选项。
claude mcp add nanobanana --transport http https://nanobanana.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s local
如果多个项目都需要,可将最后一行改成 -s user,作为用户级配置;如果团队希望在项目中共享 MCP 定义,可以使用 -s project。项目配置涉及凭据时尤其要谨慎:不要把含真实 Token 的 .mcp.json 提交到仓库,应使用环境变量占位或由成员分别在本地配置。首次读取项目级配置时,Claude Code 可能要求批准信任。
第三步:验证连接
claude mcp list
如果列表中 nanobanana 显示 ✓ Connected,表示握手成功;没有连上时,优先核对 Token、服务地址与配置作用域,而不是根据旧教程的工具数量判断是否可用。
接下来可以怎么用?
配置完成后,在 Claude Code 会话中直接描述目标,例如:
为项目的 404 页面生成一张插画:一只小恐龙蹲在地面裂缝旁向下看,画面简洁,适合作为网页空状态配图。
或者提供可访问的图片 URL,提出编辑/合成要求:
把第一张图中的手机放到第二张图的桌面场景中,调整透视与光线,让它看起来自然。
官方教程列出的工具是 nanobanana_generate_image(文生图)与 nanobanana_edit_image(图像编辑,支持多图输入)。输入素材请确认自己有使用与修改权限;尤其不应借"去文字"功能处理不属于自己的版权水印。
为什么值得一试
对开发者来说,接入后的关键收益是把"理解代码/页面需求"和"产出视觉素材"放进同一条工作流:不用反复在终端、浏览器与素材平台之间搬运提示词。对团队来说,Ace Data Cloud 的统一 Token 与远程 MCP 入口,也降低了尝试更多能力时的接入摩擦;但具体模型、额度和可用能力仍应以平台当前文档与控制台为准。
如果你已经在用 Claude Code,先从一个项目的 local 配置开始,跑通 claude mcp list,再试一张 404 页面插画或 README 配图,比一上来改造完整设计流程更稳妥。
相关入口: