Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Zalo Official Account 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
Zalo Official Account (Vietnam): OA-Profil und Nachrichtenkontingent, Follower und Nutzer mit ihren Details und Labels, letzte Chats und Konversationen, Beratungsnachrichten mit Text oder einem Bild und die Artikel des OA. Nutzt ein eingefügtes OA-Access-Token, das etwa 25 Stunden gilt.
Frag einfach
Beispiel-Prompts für Zalo Official Account
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 → Zalo Official Account klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Zalo Official Account + Microsoft Copilot
Zalo Official Account (Vietnam): OA-Profil und Nachrichtenkontingent, Follower und Nutzer mit ihren Details und Labels, letzte Chats und Konversationen, Beratungsnachrichten mit Text oder einem Bild und die Artikel des OA. Nutzt ein eingefügtes OA-Access-Token, das etwa 25 Stunden gilt.
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:
ZALO_OA_ACCESS_TOKEN
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 5 Minuten, und das Token muss jeden Tag erneuert werden (siehe unten). Du brauchst einen Zalo Official Account und einen OA-Admin, der Berechtigungen genehmigt.
- Leg unter https://developers.zalo.me eine App an oder öffne deine, verknüpfe sie mit deinem Official Account und beantrage unter Official Account > OA permissions die Berechtigungsgruppen, die der Connector nutzt: Verwaltung der OA-Informationen, Verwaltung der Nutzerinformationen, Verwaltung der Nutzernachrichten, Senden von Nachrichten und Benachrichtigungen über den OA sowie Artikelverwaltung. Ein OA-Admin genehmigt sie.
- Öffne Tools > API Explorer (https://developers.zalo.me/tools/explorer), wähle deine App, als Access-Token-Typ OA Access Token und den OA, erlaube die beantragten Berechtigungen und kopiere das access token.
- Füge es in
ZALO_OA_ACCESS_TOKENein. Es wird im Headeraccess_tokengesendet, den Zalo verlangt. - Installiere den Connector und rufe
zalo_oa_get_oa_infoauf, um es zu prüfen.
Das Token gilt etwa 25 Stunden. Zalo erneuert OA-Access-Tokens nur über seinen eigenen OAuth-v4-Flow, den AnythingMCP für diesen Connector nicht ausführen kann, deshalb wird das Token eingefügt. Wenn Aufrufe mit Fehler -216 oder -220 antworten, erzeuge im API Explorer ein neues Token und speichere es in den Connector-Einstellungen. Wenn du Tokens in deinem eigenen System erneuerst, kannst du jedes neue Token über die AnythingMCP-API in ZALO_OA_ACCESS_TOKEN schreiben.
Was er liest: das OA-Profil (Name, ID, Verifizierung, Follower, Servicepaket) und sein Nachrichtenkontingent; die Nutzer, die dem OA folgen oder mit ihm geschrieben haben, 50 pro Seite, mit Filtern nach Label, letzter Interaktion oder Follower-Status; Name, Alias, Follower-Status, Datum der letzten Interaktion, Labels, Notizen und geteilte Informationen eines Nutzers; die Labels des OA; die neuesten Nachrichten über alle Chats und die Nachrichten mit einem Nutzer, 10 pro Aufruf; und die Artikel und Videos des OA mit ihrem Inhalt.
Was er schreibt: Nutzerdetails (Alias, deine eigene Kunden-ID und geteilte Informationen) und Labels: Die KI versieht einen Nutzer mit einem Label und legt es an, wenn es fehlt, oder entfernt es wieder. zalo_oa_send_text sendet einen Beratungstext, optional mit einem Zitat der Nachricht des Nutzers, und zalo_oa_send_image eine Beratungsnachricht mit einem Bild. Beide erreichen einen echten Menschen, deshalb zeigt die KI den Text und wartet auf dein Ja.
Wann eine Beratungsnachricht gesendet werden kann: nur an einen Nutzer, der in den letzten 7 Tagen mit dem OA interagiert hat. Ab dem 1. Januar 2026 sind Beratungsnachrichten innerhalb von 48 Stunden nach der letzten Interaktion des Nutzers kostenlos und unbegrenzt; spätere verbrauchen das Kontingent des OA-Pakets oder werden berechnet. zalo_oa_get_user_quota sagt der KI, was an einen Nutzer noch gesendet werden kann. Fehler -230 oder -232 bedeutet, dass der Nutzer nicht kürzlich genug interagiert hat, -213, dass der Nutzer dem OA nicht folgt.
Bei der Installation deaktiviert: zalo_oa_delete_tag, das ein Label aus dem OA und von jedem Nutzer entfernt, der es hat, und sich nicht rückgängig machen lässt.
Formate: Jede Antwort hat error (0 = Erfolg) und message, mit den Nutzdaten in data; Fehler kommen mit HTTP 200 und einem negativen error. Nutzer-, OA- und Nachrichten-IDs sind lange Ziffernfolgen. In einer Nachricht ist src 1, wenn der Nutzer sie gesendet hat, und 0, wenn der OA sie gesendet hat. Nachrichtenzeiten sind Unix-Millisekunden, und user_last_interaction_date ist dd/MM/yyyy.
Limits: 4.000 Anfragen pro Minute und App, dazu ein Limit pro OA, das vom OA-Paket abhängt; Fehler -32 heißt, auf die nächste Minute warten. Die Nutzerliste reicht bis zu den ersten 10.000 Nutzern.
Häufige Fehler: -216 oder -220 bedeutet ein ungültiges oder abgelaufenes Token (füge ein neues ein), -223 eine Berechtigung, die der OA der App nicht gewährt hat, -224 eine Funktion, die das OA-Paket nicht enthält, -201 einen ungültigen Parameter und -211 ein aufgebrauchtes Kontingent.
Der Connector sendet keine Transaktions-, Werbe- oder ZNS-Vorlagennachrichten, keine Dateien oder Sticker und deckt keine Gruppenchats, Anrufe, Artikelerstellung oder den OA-Shop ab. Webhooks werden in den Einstellungen der Zalo-App konfiguriert.
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 Microsoft Copilot 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.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Zalo Official Account-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | What it does |
|---|---|
zalo_oa_get_oa_info | Profile of the Official Account the token belongs to: OA id (oaid), name, description, alias, verification status, OA type, category… |
zalo_oa_get_quota | Message quota of the OA or the app: one row per quota asset with the product type (cs = consultation, transaction), the quota source… |
zalo_oa_get_user_quota | What the OA can still send to one user: the time of the user's last interaction with the OA (last_interaction, Unix milliseconds) and the… |
zalo_oa_list_users | Page through the users who interacted with the OA (followers and people who messaged it) |
zalo_oa_filter_users | Page through the OA's users with filters: by label (tag), by when they last interacted, or by whether they follow the OA |
zalo_oa_get_user | Details of one user: display name, alias, your own customer id (user_external_id), whether the user follows the OA, last interaction date… |
zalo_oa_update_user | Update what the OA stores about a user: the alias, your own customer id (user_external_id, unique per user) and the shared information… |
zalo_oa_list_tags | All labels (tags) defined in the OA, as a list of label names |
zalo_oa_tag_user | Put a label on a user |
zalo_oa_untag_user | Remove a label from one user |
zalo_oa_delete_tag | Delete a label from the OA, which also takes it off every user who has it |
zalo_oa_list_recent_chats | The latest messages across all of the OA's conversations, newest first: sender and recipient ids and names, direction (src 1 = from the… |
zalo_oa_get_conversation | Messages between the OA and one user, newest first, 10 at most per call: message_id (use it as quote_message_id to reply), direction… |
zalo_oa_send_text | Send a consultation (customer care) text message from the OA to a user, optionally as a reply quoting one of the user's messages |
zalo_oa_send_image | Send a consultation message with one image (JPG or PNG, at most 1 MB, best at 16:9) and an optional caption |
zalo_oa_list_articles | The OA's published content: articles (type normal) or videos (type video), with id, title, status, views, shares, creation and update… |
zalo_oa_get_article | One article with its title, author, cover, description, status, comment setting and body blocks (text, images, videos) |
Beispiel-Prompts
- „Welche Nutzer haben dem OA in den letzten 24 Stunden geschrieben, und was haben sie gefragt?“
- „Zeig meine Konversation mit diesem Nutzer und entwirf eine Antwort auf seine letzte Frage.“
- „Versieh alle, die diese Woche nach der Lieferung gefragt haben, mit dem Label delivery-question.“
- „Wie viel Kontingent für Beratungsnachrichten hat der OA noch?“
- „Liste die fünf meistgelesenen Artikel des OA.“
FAQ
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?