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. У розділі Профіль → 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 (Налаштування → 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 ротується під час кожного оновлення; зберігаються лише хеші, токен дійсний тільки для цього сервера. Відключення застосунку в профілі миттєво гасить його токени.
• Журнал використання для кожного ключа (інструмент, модель, вартість, прев'ю промпту) доступний у розділі Профіль → 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.