MCP

Verbinden Sie Claude, Cursor oder einen beliebigen MCP-Client mit dem Remote-Server von WASync. Sechs Tools, kein Code auf Ihrer Seite.

WASync betreibt einen Remote-MCP-Server über Streamable HTTP. Fügen Sie ihn einem MCP-Client hinzu, und der Agent erhält WhatsApp-Tools, ohne dass Sie Code schreiben müssen.

MCP server URL

https://cloudapi.wasync.app/api/mcp

Dieser Host ist Absicht. Die REST-Basis-URL und alle Links für Menschen nutzen developers.wasync.app, aber die MCP-Server-URL, die OAuth-Endpunkte und die /.well-known/…-Dokumente sind Protokollkennungen, die Clients bereits registriert haben. Sie bleiben auf cloudapi.wasync.app und müssen Byte für Byte übereinstimmen. „Normalisieren“ Sie sie nicht.

Client verbinden

Für Clients, die eine Konfigurationsdatei lesen (Claude Desktop, Cursor, …):

mcp config

{
  "mcpServers": {
    "wasync": {
      "url": "https://cloudapi.wasync.app/api/mcp"
    }
  }
}

Die Authentifizierung erfolgt über OAuth 2.0 mit PKCE und wird vom Client abgewickelt: Der erste Aufruf öffnet einen Browser, Sie bestätigen, und der Client speichert die Tokens. Es gibt keinen Schlüssel, den Sie einfügen müssten.

Ein Client ohne native Unterstützung für Remote-MCP kann über stdio eine Brücke schlagen:

npx mcp-remote https://cloudapi.wasync.app/api/mcp

Im Registry finden

WASync ist im offiziellen MCP Registry eingetragen als:

app.wasync/whatsapp

Clients und Verzeichnisse, die das Registry auslesen, finden den Server über den Namen, ohne dass Sie die URL einfügen müssen.

Die Tools

Tool	Funktion	Erfordert
`list_whatsapp_connections`	Listet die Verbindungen auf, die die Freigabe nutzen darf, mit Status und Lizenzzustand. Jedes andere Tool erwartet eine Verbindungs-ID von hier.	read
`get_whatsapp_connection`	Der aktuelle Zustand einer Verbindung: online oder nicht, Lizenzstatus und Ablaufdatum. Nur lesend.	read
`read_whatsapp_messages`	Gespeicherte Nachrichten, neueste zuerst, über alle freigegebenen Verbindungen oder über eine einzelne; seitenweise mit `nextCursor`. Es wird nichts gesendet und keine Lesebestätigung angezeigt.	read
`send_whatsapp_message`	Sendet eine Textnachricht von einer Verbindung an einen Empfänger. Die Beschreibung des Tools weist das Modell an, Empfänger und Wortlaut zuerst bestätigen zu lassen: Eine WhatsApp-Nachricht lässt sich nicht zurückrufen.	send
`send_whatsapp_file`	Sendet eine Datei (Dokument, Bild, Audio oder Video, bis 5 MB) mit optionaler Bildunterschrift. Geben Sie einen direkten `https`-Link in `url` an (bevorzugt) oder Base64 in `data`. Gleiche Regel: erst bestätigen lassen, denn die Nachricht lässt sich nicht zurückrufen.	send
`mark_whatsapp_messages_read`	Markiert die eingehenden Nachrichten eines Kunden als gelesen (blaue Haken), anhand der Telefonnummer oder einer Nachrichten-ID.	send

Sie entsprechen GET /connections, GET /connections/{id}, GET /messages, POST /messages (Text und Medien) und POST /messages/read und unterliegen denselben Scopes: Ein Agent kann nur tun, was die Freigabe erlaubt.

Datei senden

send_whatsapp_file erwartet genau eines von url oder data:

send_whatsapp_file arguments

{
  "connectionId": "conn_123",
  "to": "40700000000",
  "url": "https://files.example.com/offers/offer-2026.pdf",
  "filename": "offer-2026.pdf",
  "caption": "Here is the offer we discussed."
}

url muss ein direkter https://-Link auf eine Datei sein, die jeder im Internet ohne Anmeldung öffnen kann. WASync lädt sie herunter (bis 5 MB, 20 Sekunden) und übernimmt den mimetype aus der Antwort des Dateiservers, sofern Sie keinen angeben. Links auf private Netzwerke, auf WASync selbst oder auf eine Webseite statt auf eine Datei werden abgelehnt.
data ist die Datei als reines Base64 (ohne data:-Präfix), dekodiert höchstens 5 MB groß; dann ist mimetype Pflicht. Bevorzugen Sie url: Dateibytes durch die Unterhaltung eines Modells zu schleusen, ist langsam und teuer.
filename ist das, was der Empfänger sieht (ohne Schrägstriche); caption ist optional, bis zu 1024 Zeichen.

Fehler kommen als Tool-Fehler zurück, mit einem stabilen Code am Anfang der Meldung: invalid_url, url_not_allowed, download_failed, file_too_large, invalid_media oder send_failed: <reason>, wenn WASync den Versand abgelehnt hat.

MCP oder REST API?

Nutzen Sie MCP, wenn ein von Menschen beaufsichtigter Agent WhatsApp erreichen soll: aus einem Chat-Client antworten, Antworten entwerfen, Informationen nachschlagen. Nutzen Sie die REST API, wenn Ihre eigene Software das Verhalten steuert und webhooks, Idempotenzschlüssel, Dateien über 5 MB oder Provisionierung braucht. Nichts davon bietet MCP.

Eine OAuth-Freigabe wird immer nur für Verbindungen erteilt, die bereits existieren. MCP kann daher nicht die erste Verbindung eines Workspace anlegen. Legen Sie sie zuerst mit einem API key an: Quickstart.

War diese Seite hilfreich?

Client verbinden

Im Registry finden

Die Tools

Datei senden

MCP oder REST API?

On this page