Connector-Anleitung4 Minuten Lesezeit11 MCP-Tools7 Sprachen

Z-API MCP mit Claude verbinden

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.

HCVom HelpCode-TeamAktualisiert 4 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Z-API

Z-API

Z-API WhatsApp gateway from Brazil: check the instance connection, browse chats and contacts, verify numbers on WhatsApp and send text, image and document messages through a WhatsApp number linked by QR code.

Tools

11

Region

BR

Kategorie

Messaging

Authentifizierung

API Key

Benötigte Env-Vars

ZAPI_INSTANCE_IDZAPI_INSTANCE_TOKENZAPI_CLIENT_TOKEN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

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.

Geführte Einrichtung

Z-API in 2 Minuten mit Claude verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Z-API in der geführten Einrichtung und trag deine MCP-URL in Claude ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.

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.

Z-API · live via MCP
Teilen
Opus 4.7

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 + Claude

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 Claude 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.

Empfohlener Weg — funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

  1. Öffne in Claude Plugins (in manchen Plänen noch Customize) → Connectors.
  2. Klicke auf + Add und dann auf Add custom connector.
  3. Gib einen Namen ein, z. B. Z-API, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Continue, übernimm die erkannten Einstellungen und klicke erneut auf Continue.
  4. Wähle Sign in now, klicke auf Add und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat — leg los mit Prompts.

Verfügbare Tools

ToolWhat it does
z_api_get_statusCheck whether the Z-API instance is linked to a WhatsApp account and whether the phone is online
z_api_get_instanceGet the Z-API instance name, connection flag, payment status and expiry date (Unix timestamp in due)
z_api_get_deviceGet the phone linked to the instance: its number, profile name, device model and whether it is a WhatsApp Business account
z_api_check_phone_existsCheck whether a phone number has a WhatsApp account
z_api_list_chatsList 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_chatGet metadata of one chat: unread count, last message time, mute and spam flags, profile status and notes (WhatsApp Business only)
z_api_list_contactsList WhatsApp contacts known to the linked number, including people from shared groups, with phone, saved name and WhatsApp profile name
z_api_list_queueList messages still waiting in the instance's send queue, with phone, text and IDs
z_api_send_textSend a WhatsApp text message to a contact or group from the linked number
z_api_send_imageSend an image by public HTTPS URL to a contact or group, with an optional caption
z_api_send_documentSend a document (PDF, XLSX, DOCX...) by public HTTPS URL to a contact or group

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja — beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

War dieser Guide hilfreich?

Z-API in 2 Minuten mit Claude verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Z-API in der geführten Einrichtung und trag deine MCP-URL in Claude ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

Z-API MCP mit Microsoft Copilot verbinden

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.

Connectors

Z-API MCP mit ChatGPT verbinden

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.

Connectors

Z-API MCP mit Cursor verbinden

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.

Connectors

Z-API MCP mit Gemini CLI verbinden

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.

Connectors

Z-API MCP mit Meta Muse verbinden

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.

Connectors

Z-API MCP-Server für WhatsApp-Chats und Nachrichten

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.