Für Entwickler
Nano Banana Pro MCP-Server
Lassen Sie Ihren KI-Assistenten Bilder und Videos in Ihrem Auftrag erstellen. Tragen Sie eine Serveradresse in einen Client ein, der das Model Context Protocol unterstützt, melden Sie sich im Browser bei Ihrem Konto an und beschreiben Sie in eigenen Worten, was Sie benötigen.
So funktioniert es
Serveradresse hinzufügen
Fügen Sie die folgende Adresse in Ihrem Client ein, über dessen Befehl, die Konfigurationsdatei oder das Feld für benutzerdefinierte Connectors.
Adresse des MCP-Servers
https://preview.bananapro.site/api/mcpAnmelden und Zugriff erlauben
Der Client öffnet ein Browserfenster. Melden Sie sich bei Ihrem Nano Banana Pro-Konto an und klicken Sie auf „Zulassen“. Ein API-Schlüssel muss nicht eingegeben werden.
Anliegen beschreiben
Bitten Sie im Gespräch um ein Bild oder ein Video. Der Assistent wählt ein Tool, startet die Aufgabe und liefert die Ergebnislinks.
Einrichtung je nach Client
Wählen Sie Ihren Client. Die Menübezeichnungen können je nach Version leicht abweichen.
Claude Code
- 1Fügen Sie den Server mit dem folgenden Befehl im Terminal hinzu.
- 2Öffnen Sie in Claude Code /mcp, wählen Sie nanobanana und schließen Sie die Anmeldung im Browser ab.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Führen Sie den ersten Befehl in einem Terminal aus, um den Server hinzuzufügen.
- 2Führen Sie den zweiten Befehl aus. Ein Browserfenster öffnet sich.
- 3Melden Sie sich bei Ihrem Konto an und klicken Sie auf „Zulassen“.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor und JSON-Clients
- 1Fügen Sie Folgendes in die MCP-Konfigurationsdatei des Clients ein, in Cursor beispielsweise mcp.json.
- 2Starten Sie den Client bei Bedarf neu. Bei der ersten Nutzung öffnet sich ein Browserfenster: Melden Sie sich an und klicken Sie auf „Zulassen“.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Benutzerdefinierter Connector
- 1Öffnen Sie die Einstellungen des Clients und suchen Sie das Feld für einen benutzerdefinierten Connector oder einen entfernten MCP-Server.
- 2Fügen Sie die unten angezeigte Serveradresse ein und speichern Sie.
- 3Wählen Sie „Verbinden“, melden Sie sich bei Ihrem Konto an und klicken Sie auf „Zulassen“.
https://preview.bananapro.site/api/mcpAPI-Schlüssel
- 1Verwenden Sie diese Methode nur für Clients, die keinen Browser öffnen können.
- 2Erstellen Sie auf der Seite „API-Schlüssel“ einen Schlüssel. Senden Sie ihn im Header des ersten Felds oder tragen Sie ihn in einer JSON-Konfiguration unter headers ein, wie im zweiten Feld.
- 3Speichern Sie den Schlüssel in den Anmeldedaten-Einstellungen des Clients und geben Sie ihn nie weiter.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Was der Assistent tun kann
Der Server stellt sechs Tools bereit. Vier lesen nur Informationen und sind kostenlos; zwei starten eine Generierung und verbrauchen Credits.
| Tool | Funktion | Verbraucht Credits |
|---|---|---|
| list_models | Listet die für Ihr Konto verfügbaren Bild- und Videomodelle sowie die jeweils unterstützten Anfragetypen auf. | Nein |
| get_balance | Zeigt an, wie viele Credits auf dem Konto verbleiben. | Nein |
| generate_image | Startet die Erzeugung oder Bearbeitung eines Bildes anhand eines Prompts und optionaler Referenzbilder. | Ja |
| generate_video | Startet die Erzeugung eines Videos anhand eines Prompts, von Bildern oder anderem Referenzmaterial. | Ja |
| get_task | Prüft den Stand einer Generierung und liefert nach Abschluss die Links zu den Ergebnissen. | Nein |
| list_tasks | Listet die letzten Generierungen auf, was hilfreich ist, wenn eine Aufgaben-ID verloren gegangen ist. | Nein |
Kommandozeilenwerkzeug
Der Befehl nanobanana erstellt Bilder und Videos im Terminal, in Skripten und in KI-Apps, die Befehle auf Ihrem Computer ausführen können.
Erfordert Node.js 22 oder neuer unter macOS oder Linux.
CLI installieren
Installieren Sie das Paket @nanobanana-pro/cli mit npm.
npm install -g @nanobanana-pro/cliAnmelden
Führen Sie den Befehl aus, melden Sie sich im Browserfenster bei Ihrem Konto an und klicken Sie auf „Zulassen“.
nanobanana auth loginKonto und Modelle prüfen
Dieser Befehl zeigt Ihr Credit-Guthaben an. Der Befehl nanobanana models listet die verfügbaren Modelle auf.
nanobanana accountErstellen
Speichern Sie eine Anfrage mit Modell und Prompt in request.json und führen Sie den Befehl aus. Die Option --wait hält ihn bis zum Abschluss der Aufgabe am Laufen.
nanobanana create --input request.json --waitErgebnis herunterladen
Ersetzen Sie TASK_ID durch die Aufgaben-ID, die der vorherige Befehl zurückgegeben hat.
nanobanana download TASK_ID --output result.png
So sieht es aus
Bitten Sie in einem Satz um ein Bild. Ihre KI-App verfasst die Anfrage, erstellt das Bild und speichert die Datei.
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
Modelle
Der Assistent kann die Bild- und Videomodelle nutzen, die Ihr Konto auf der Website und in der API verwenden kann.
- Lassen Sie den Assistenten list_models aufrufen, um die aktuelle Modellliste und die jeweils akzeptierten Anfragearten zu erhalten.
- Jedes Modell bietet dieselben Optionen wie die Website. Eine Einstellung, die ein Modell nicht unterstützt, wird mit einer Erklärung abgelehnt.
- Referenzbilder und -videos müssen öffentliche https-Links sein. Dateien lassen sich über MCP nicht hochladen.
Credits und Abrechnung
- Die Anmeldung und die kostenlosen Tools (list_models, get_balance, get_task, list_tasks) kosten nichts.
- generate_image und generate_video verbrauchen dieselben Credits wie die Website und die API und werden vom Guthaben Ihres Kontos abgezogen.
- Eine fehlgeschlagene Aufgabe wird automatisch erstattet.
- Das Abonnement des KI-Assistenten selbst ist davon getrennt und wird von diesem Assistenten abgerechnet.
Beispielanfragen
Senden Sie Ihrem Assistenten nach der Verbindung eine dieser Anfragen.
- Welche Bild- und Videomodelle kann ich nutzen? Zeige sie in einer kurzen Liste.
- Erstelle ein Produktfoto im Format 16:9: eine Keramiktasse auf einem Holztisch.
- Mache aus diesem Landschaftsfoto ein fünfsekündiges Video: https://example.com/photo.jpg
- Prüfe den Status meiner letzten Aufgabe und sende mir den Ergebnislink.
Häufig gestellte Fragen
Benötige ich einen API-Schlüssel?
Nicht bei Clients, die einen Browser öffnen können: Anmelden und „Zulassen“ genügen. Ein Schlüssel ist nur für Clients nötig, die das nicht können, wie unter „API-Schlüssel“ beschrieben.
Wo sehe oder entferne ich eine Verbindung?
Öffnen Sie die Seite „API-Schlüssel“. Jede Verbindung erscheint dort unter dem Namen ihres Clients; mit dem Entfernen endet der Zugriff dieses Clients.
Was kostet eine Generierung?
Dieselben Credits wie auf der Website und in der API. Eine fehlgeschlagene Aufgabe wird automatisch erstattet.
Kann ich eigene Bilder oder Videos als Referenz verwenden?
Ja, als öffentliche https-Links. Einen Datei-Upload gibt es nicht: Legen Sie die Datei an einem erreichbaren Ort ab und übergeben Sie deren Adresse.
Die Verbindung steht, aber die Tools erscheinen nicht. Was tun?
Prüfen Sie, ob die Anmeldung abgeschlossen ist und der Client den Server als verbunden anzeigt. Beginnen Sie dann ein neues Gespräch, da manche Clients Tools nur zu Beginn laden.
Wo finde ich die Ergebnisse?
Der Assistent liefert die Ergebnislinks im Gespräch. Frühere Aufgaben lassen sich mit list_tasks erneut auflisten.
Sie möchten die API lieber selbst aufrufen?
Der MCP-Server basiert auf der öffentlichen API. Die Dokumentation führt jeden Endpunkt, jeden Parameter und jedes Modell auf.