Nano Banana MCP Server для Claude, Cursor и Gemini CLI

Удаленный сервер Model Context Protocol, который открывает вашим агентам доступ ко всему стеку генерации BananaBanana через встроенные инструменты: изображениям Google Nano Banana 2 Lite / 2 / 2.1 / Pro (от $0.03), видео Veo 3.1 / Fast / Lite и Gemini Omni Flash, Wan 3.0 со звуком ($0.09–1.00). Агент видит актуальные цены, подтверждает расходы перед дорогими задачами, а все генерации сохраняются в той же истории и оплачиваются с того же баланса, что и на сайте.

• Эндпоинт: https://bananabanana.pro/api/mcp (Streamable HTTP)
• Авторизация: вход по OAuth 2.1 (claude.ai и другие клиенты с коннекторами) либо Bearer API-ключ из профиля
• Лимит запросов: 20 вызовов инструментов в минуту на один ключ; можно настроить дневной лимит расходов для каждого ключа
• Нет MCP-клиента? Этот же эндпоинт работает как обычный JSON-RPC по HTTPS — вызывайте его через curl, Python или TypeScript без установки SDK
• Неудачные или отклоненные фильтрами генерации возвращаются на баланс автоматически
• Документация, файл server.json и готовые примеры настройки клиентов доступны в GitHub-репозитории bananabanana-mcp

1. Создайте аккаунт и пополните баланс. 2. В разделе Profile → MCP API Keys создайте ключ (он показывается один раз). 3. Добавьте сервер в свой клиент:

claude.ai, Claude Desktop, мобильные (OAuth — ничего копировать не нужно)

Settings → Connectors → Add custom connector, вставьте https://bananabanana.pro/api/mcp и нажмите Connect. Claude регистрируется сам, вы подтверждаете доступ на экране BananaBanana, а генерации списываются с того аккаунта, под которым вы вошли.

Settings → Connectors → Add custom connector
URL: https://bananabanana.pro/api/mcp
→ Add → Connect → approve access on bananabanana.pro

Тот же флоу работает в любом клиенте, поддерживающем MCP-авторизацию: MCP Inspector, веб-коннекторы ChatGPT и Grok, Claude Code. Подключённые приложения видны в профиле, там же их можно отключить.

Claude Code

# with an API key
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

# or with OAuth — no key, sign in in the browser
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp
# then run /mcp inside Claude Code and pick "Authenticate"

Claude Desktop

Добавьте в claude_desktop_config.json (Settings → Developer → Edit Config); для работы моста mcp-remote требуется Node.js:

{
  "mcpServers": {
    "bananabanana": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bananabanana.pro/api/mcp",
        "--header", "Authorization: Bearer bb_live_YOUR_KEY"
      ]
    }
  }
}

Cursor

Добавьте в глобальный файл ~/.cursor/mcp.json или локальный .cursor/mcp.json в корне проекта. Чтобы не хранить ключ в файле в открытом виде, используйте переменную окружения ${env:BB_API_KEY}:

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      }
    }
  }
}

Подробный разбор интеграции с Cursor с описанием нюансов и демо-ключом: Генерация изображений в Cursor.

VS Code / GitHub Copilot

Добавьте в файл .vscode/mcp.json в рабочей области (или в пользовательские настройки settings.json). VS Code запросит ключ один раз и сохранит его в зашифрованном виде:

{
  "servers": {
    "bananabanana": {
      "type": "http",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:bb-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "bb-api-key",
      "description": "BananaBanana API key (bb_live_…)",
      "password": true
    }
  ]
}

Подробный разбор интеграции с VS Code / Copilot с описанием нюансов и демо-ключом: Генерация изображений в VS Code: руководство по настройке Copilot MCP.

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bananabanana": {
      "serverUrl": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      }
    }
  }
}

Windsurf MCP Setup: Generate Images in Cascade

Cline

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

Cline MCP Server: Generate Images From Your Editor

Любой другой MCP-клиент (чистый JSON-RPC)

POST https://bananabanana.pro/api/mcp
Authorization: Bearer bb_live_YOUR_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Любой метод, кроме ping и списков discovery (tools/list, prompts/list, resources/list), требует учётных данных — включая initialize: неаутентифицированное рукопожатие отвечает 401 с челленджем WWW-Authenticate. Асимметрия намеренная, а не баг: именно по этому челленджу клиент-коннектор понимает, что сервер работает по OAuth. Читать каталог тулов без ключа по-прежнему можно.

Предпочитаете пошаговые инструкции? Руководство Генерация изображений в Claude Code подробно описывает весь процесс настройки Claude от начала до конца, включая четыре реальных сценария использования и расчет их стоимости.

MCP — открытый протокол. К нему может подключиться любой клиент, поддерживающий Streamable HTTP и умеющий передавать заголовок Authorization. Текущий статус интеграции проверен по официальной документации разработчиков (актуально на август 2026 года):

Пример для Codex — добавьте в ~/.codex/config.toml и экспортируйте BB_API_KEY=bb_live_…:

[mcp_servers.bananabanana]
url = "https://bananabanana.pro/api/mcp"
bearer_token_env_var = "BB_API_KEY"

Подробный разбор интеграции с Codex (CLI, расширение для IDE и десктопное приложение ChatGPT из единой конфигурации) с описанием нюансов и демо-ключом: Настройка Codex MCP: генерация изображений и видео из одного config.toml.

Не пользуетесь MCP-клиентами? Они и не нужны — как и специальные библиотеки (SDK). Сервер работает по обычному протоколу JSON-RPC 2.0 поверх HTTPS: один эндпоинт для POST-запросов, заголовок Bearer и простой JSON-ответ в один шаг. Состояние сессии не сохраняется (stateless), поэтому никакого предварительного рукопожатия не требуется: запрос к tools/call можно отправлять сразу через curl, Python, TypeScript или любой другой инструмент для работы с HTTP.

curl

# start an image generation (charges one image, $0.03 on the default Lite model)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"generate_image",
        "arguments":{"prompt":"studio photo of a ceramic mug on linen, soft daylight"}}}'

# → result.structuredContent.job_id = "cmxy…"

# fetch the result (long-polls server-side up to 30 s; free)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"get_result",
        "arguments":{"job_id":"cmxy…","wait_seconds":30}}}'

Python

Только библиотека requests — никаких сторонних MCP-библиотек:

import requests

MCP = "https://bananabanana.pro/api/mcp"
HEADERS = {"Authorization": "Bearer bb_live_YOUR_KEY"}

def call(tool, **args):
    r = requests.post(MCP, headers=HEADERS, json={
        "jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": {"name": tool, "arguments": args},
    })
    r.raise_for_status()
    return r.json()["result"]["structuredContent"]

job = call("generate_image", prompt="watercolor painting of a lighthouse at dawn")

result = call("get_result", job_id=job["job_id"], wait_seconds=30)
while result["status"] == "processing":
    result = call("get_result", job_id=job["job_id"], wait_seconds=30)

print(result["files"][0]["url"], "cost:", result["cost_charged_usd"])

TypeScript / Node.js

Ноль зависимостей — стандартный fetch (Node 18+, Deno, Bun, браузеры):

const MCP = "https://bananabanana.pro/api/mcp";

async function call(tool: string, args: Record<string, unknown>) {
  const res = await fetch(MCP, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BB_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0", id: 1, method: "tools/call",
      params: { name: tool, arguments: args },
    }),
  });
  const { result } = await res.json();
  return result.structuredContent;
}

const job = await call("generate_image", {
  prompt: "isometric 3D render of a tiny greenhouse at golden hour",
});

let out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
while (out.status === "processing") {
  out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
}
console.log(out.files[0].url, "cost:", out.cost_charged_usd);

Важные детали для написания скриптов:

• Каждый ответ инструмента дублирует данные: в машиночитаемом формате в result.structuredContent и в виде текста в result.content — разбирайте то, что удобнее.
• Создание видео (и пакетов из нескольких картинок) происходит в два шага: первый вызов generate_video возвращает предварительный расчет стоимости и ничего не списывает; повторите его с параметром confirm_cost, равным рассчитанной сумме, чтобы запустить генерацию.
• Передавайте уникальный idempotency_key при вызовах генерации — повторные попытки из-за сбоев сети никогда не приведут к двойному списанию.
• Метод tools/list работает без авторизации по ключу, поэтому вы можете изучить полные схемы параметров еще до регистрации. Лимит вызовов инструментов — 20 в минуту на один ключ.

• Цены подтягиваются в реальном времени через list_models — из того же источника, что и на сайте.
• Каждый вызов для генерации видео (или пакета картинок) сначала возвращает расчет стоимости без списания средств. Для запуска задачи агент повторяет вызов с параметром confirm_cost.
• Каждый результат содержит поля cost_charged_usd (фактическая стоимость) и balance_remaining_usd (остаток на балансе).
• Ошибки на стороне провайдеров моделей и отклонения по контент-фильтрам компенсируются автоматически — точно так же, как и в веб-интерфейсе.
• Необязательный параметр idempotency_key гарантирует, что повторные попытки запросов никогда не приведут к двойному списанию.

• Ссылки на результаты подписаны шифрованием и активны в течение 24 часов. Сами медиафайлы надежно хранятся в вашем аккаунте: вы можете получить новые ссылки повторным вызовом get_result или скачать файлы через сайт.
• API-ключи хранятся в виде хэшей и показываются только один раз при создании. Вы можете отозвать их в любой момент в своем профиле.
• У OAuth-подключений access-токен живёт час, refresh ротируется при каждом обновлении; хранятся только хэши, токен действителен лишь для этого сервера. Отключение приложения в профиле мгновенно гасит его токены.
• Детальный лог использования каждого ключа (инструмент, модель, стоимость, превью промпта) доступен в Profile → MCP API Keys.
• Все генерации через MCP отображаются в общей истории генераций и аналитике наряду с веб-версией.

x402 — открытый протокол, по которому агент оплачивает один запрос стейблкоином. Это отдельный от MCP-сервера эндпоинт: POST /api/x402. Аккаунт, API-ключ и пополнение баланса не нужны.

1. Отправьте имя инструмента и его аргументы. Сервер ответит 402 с точной ценой этого вызова.
2. Подпишите платёж в USDC в сети Base и повторите запрос с заголовком X-PAYMENT.
3. Изображения и речь приходят в том же ответе. Видео возвращает job_id; результат бесплатно опрашивается через GET /api/x402/result/{jobId}.

Доступные инструменты: generate_image, generate_speech, generate_video. Цены те же, что в веб-студии и через MCP; вызов стоит столько, сколько стоит генерация, минимального пополнения нет.

Если оплаченное видео не удалось, плательщик получает кредит-токен на ту же сумму, он действует 90 дней. Передайте его как refund_token в следующем вызове. Ончейн-возврата нет. Машиночитаемый каталог с актуальными ценами — GET /api/x402.