Connector-Anleitung4 Minuten Lesezeit11 MCP-Tools7 Sprachen

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.

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 Meta Muse verbinden

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

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

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 + Meta Muse

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

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

  1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
  2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
  3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
  4. Bitte Muse im Chat um etwas, wofür es die Z-API-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

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

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

War dieser Guide hilfreich?

Z-API in 2 Minuten mit Meta Muse verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Z-API in der geführten Einrichtung und trag deine MCP-URL in Meta Muse 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 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.

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