Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Z-API mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
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.
Frag einfach
Beispiel-Prompts für Z-API
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 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 + ChatGPT
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
- Ö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_IDund das Instanz-Token inZAPI_INSTANCE_TOKEN. - Ö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. - 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.
- Beginne mit
z_api_get_status:connected: falsebedeutet, 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 ChatGPT 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 AnleitungYOUR_SERVER_IDzeigt.
ChatGPT verbindet MCP-Server als eigene Apps im Entwicklermodus (Developer mode). Den gibt es in den kostenpflichtigen Tarifen, nicht im kostenlosen. In Business- und Enterprise-Workspaces muss ihn eventuell erst ein Admin freigeben.
- Öffne in ChatGPT Settings → Security and login und aktiviere Developer mode.
- Geh zu chatgpt.com/plugins und klicke auf +.
- Gib einen Namen und eine kurze Beschreibung ein, z. B. Name:
Z-API. - Trag unter Connection die MCP-Server-URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein und erstelle die Verbindung. - Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an (OAuth) und erlaubst den Zugriff.
Verfügbare Tools
| Tool | What it does |
|---|---|
z_api_get_status | Check whether the Z-API instance is linked to a WhatsApp account and whether the phone is online |
z_api_get_instance | Get the Z-API instance name, connection flag, payment status and expiry date (Unix timestamp in due) |
z_api_get_device | Get the phone linked to the instance: its number, profile name, device model and whether it is a WhatsApp Business account |
z_api_check_phone_exists | Check whether a phone number has a WhatsApp account |
z_api_list_chats | List the WhatsApp chats of the linked number (people and groups) with phone or group ID, name, unread count and last message time |
z_api_get_chat | Get metadata of one chat: unread count, last message time, mute and spam flags, profile status and notes (WhatsApp Business only) |
z_api_list_contacts | List WhatsApp contacts known to the linked number, including people from shared groups, with phone, saved name and WhatsApp profile name |
z_api_list_queue | List messages still waiting in the instance's send queue, with phone, text and IDs |
z_api_send_text | Send a WhatsApp text message to a contact or group from the linked number |
z_api_send_image | Send an image by public HTTPS URL to a contact or group, with an optional caption |
z_api_send_document | Send a document (PDF, XLSX, DOCX...) by public HTTPS URL to a contact or group |
FAQ
Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Connectors? Nein. Eigene MCP-Verbindungen brauchen den Entwicklermodus, und den gibt es nur in kostenpflichtigen Tarifen.
Nächste Schritte
War dieser Guide hilfreich?
