Z-API mit Gemini verbinden — über MCP

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Z-API klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein git clone, kein lokaler Server.

Z-API + Gemini

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ZAPI_INSTANCE_ID, ZAPI_INSTANCE_TOKEN, ZAPI_CLIENT_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne im Z-API-Panel (app.z-api.io) Instances, lege eine Instanz an oder wähle eine aus und klicke auf Bearbeiten. Kopiere die Instanz-ID in ZAPI_INSTANCE_ID und das Instanz-Token in ZAPI_INSTANCE_TOKEN.
2. Öffne den Tab Security, Modul Account Security Token, klicke auf Set Up Now und kopiere das Token in ZAPI_CLIENT_TOKEN. Klicke danach auf Activate Token, damit jede Anfrage es mitsenden muss.
3. Verknüpfe das Telefon: Scanne den QR-Code der Instanz mit WhatsApp (Linked devices). Solange die Nummer nicht verknüpft ist, schlägt jeder Versand fehl.
4. Beginne mit z_api_get_status: connected: false bedeutet, dass der QR-Code erneut gescannt werden muss, smartphoneConnected: false, dass das Telefon offline ist.

Z-API ist ein Gateway eines Drittanbieters, das eine WhatsApp-Web-Sitzung für deine Nummer betreibt. Es ist nicht die offizielle WhatsApp Business API von Meta, und WhatsApp kann Nummern einschränken, die Massennachrichten versenden. Telefonnummern bestehen nur aus Ziffern, mit Länder- und Ortsvorwahl und ohne +, Leerzeichen oder Bindestriche (5511999999999). Die Sende-Tools verschicken echte WhatsApp-Nachrichten: Bestätige vorher Empfänger und Text, und wiederhole nie einen Versand, der eine messageId zurückgegeben hat. Wenn du im Security-Tab von Z-API die IP-Beschränkung aktiviert hast, gib die ausgehende Adresse von AnythingMCP frei.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Z-API-Tools aufrufen.

Verfügbare Tools

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Verbinde mit Claude
• Verbinde mit ChatGPT