Entwickler

Verbinden Sie WŬMÙ mit Ihren Systemen

WŬMÙ ist auf drei Wegen offen für Integrationen: Apps melden sich über OAuth 2.0 mit PKCE an und arbeiten über die REST API v2 mit OpenAPI-Beschreibung mit Daten, KI-Assistenten verbinden sich per URL mit dem MCP-Server.

Schlüssel gibt es in der Entwicklerkonsole: Melden Sie sich bei WŬMÙ an, erstellen Sie eine App und erhalten Sie Ihre client_id.

https://wumu.ai

Autorisierung
/api/oauth/authorize
Tokens
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP-Server
/mcp

Drei Wege zur Anbindung

Wählen Sie, wie Sie sich verbinden

Ihre eigene App oder Ihr Dienst verbindet sich über OAuth und die REST API. Ein KI-Assistent verbindet sich über den MCP-Server, ohne App-Registrierung.

  • OAuth 2.0 mit PKCE

    Für Websites, Dienste und mobile Apps, die mit Zustimmung eines WŬMÙ-Nutzers mit seinen Daten arbeiten.

    • Autorisierungscode mit PKCE (S256) und Rotation der Refresh-Tokens; für Server-zu-Server-Aufrufe client_credentials
    • Der Nutzer sieht einen Zustimmungsbildschirm und gewährt nur die nötigen Berechtigungen: Profil, Dokumente, Chats, Kontakte und mehr
    • Öffentliche Clients — mobile Apps und SPAs — erhalten kein Secret
    • Mit HMAC-SHA256 signierte Webhooks sowie ein Protokoll der Anfragen und Zustellungen in der Entwicklerkonsole
    • Eine neue App wird nach Prüfung durch einen WŬMÙ-Administrator freigeschaltet
  • REST API v2

    Eine JSON-API für Dokumente, Tabellen, KI-Chats, den Messenger, Kontakte, den Kalender und weitere Bereiche von WŬMÙ.

    • Maschinenlesbare OpenAPI-Beschreibung, die für jede Operation die nötigen Berechtigungen nennt
    • Das Zugriffstoken wird im Header Authorization: Bearer übergeben
    • Ein Anfragelimit pro Minute für jedes Paar aus App und Nutzer; bei Überschreitung folgt die Antwort 429
  • MCP-Server

    Ein KI-Assistent verbindet sich per URL mit einem WŬMÙ-Konto — ohne Schlüssel, ohne Entwickler-App und ohne Installation.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT im Entwicklermodus, Cursor und andere Clients, die entfernte MCP-Server mit OAuth-Anmeldung unterstützen
    • Sie melden sich mit Ihrem eigenen Konto an und wählen die Bereiche selbst; Lesen und Ändern sind getrennte Schalter
    • Bereiche mit Daten anderer Personen — Anfragen, Messenger, Kontakte — sind standardmäßig ausgeschaltet
    • Den Assistenten können Sie jederzeit in den Sicherheitseinstellungen Ihres Kontos trennen

    Verbindungs-URL

    • https://wumu.ai/mcpFür ein Konto auf wumu.ai
    • https://wumu.ru/mcpFür ein Konto auf wumu.ru (Russland)

Beispielanfrage

Ihre erste Anfrage

Holen Sie sich über OAuth ein Zugriffstoken und übergeben Sie es im Header: Die erste Anfrage liefert Ihre fünf neuesten Chats mit dem KI-Juristen und benötigt die Berechtigung read:chats. Der zweite Befehl fügt den WŬMÙ-MCP-Server zu Claude Code hinzu.

# Ihre fünf neuesten Chats mit dem KI-Juristen
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# den WŬMÙ-MCP-Server zu Claude Code hinzufügen
claude mcp add --transport http wumu https://wumu.ai/mcp
Alle Operationen stehen in der OpenAPI-Beschreibung

Fragen von Entwicklern

Brauche ich einen kostenpflichtigen Tarif für die WŬMÙ-API?

Für OAuth-Apps und die REST API v2 ist kein kostenpflichtiger Tarif nötig: Eine App lässt sich in jedem WŬMÙ-Tarif erstellen, auch im kostenlosen. Einen KI-Assistenten können Sie auch im kostenlosen Tarif mit dem WŬMÙ-MCP-Server verbinden – mit Zugriff auf Ihr Profil, Ihre Stadt-Entwürfe und das Hilfecenter; für die übrigen Bereiche brauchen Sie einen eigenen Pro-Tarif oder höher, eine Business-Testphase zählt ebenfalls.

Wie erhalte ich einen WŬMÙ-API-Schlüssel?

Melden Sie sich bei WŬMÙ an und öffnen Sie die Entwicklerkonsole. Erstellen Sie eine App mit Namen, Weiterleitungs-URLs und Berechtigungen. Sie erhalten eine client_id, eine serverseitige App zusätzlich ein client_secret — es wird nur einmal angezeigt, bewahren Sie es sicher auf. Die App stellt Tokens aus, sobald ein WŬMÙ-Administrator sie geprüft hat.

Wo finde ich die Beschreibung der WŬMÙ-REST-API?

Die OpenAPI-Beschreibung der REST API v2 ist ohne Anmeldung unter /api/v2/openapi.json abrufbar: Laden Sie sie in ein beliebiges Werkzeug, das OpenAPI versteht, oder erzeugen Sie daraus einen Client. Die Metadaten des WŬMÙ-Autorisierungsservers finden Sie unter /.well-known/openid-configuration.

OpenAPI-Beschreibung öffnen
Begrenzt die WŬMÙ-API die Zahl der Anfragen?

Ja. Die REST API v2 begrenzt jedes Paar aus App und Nutzer: standardmäßig 100 Anfragen pro Minute, einige Bereiche wie der Messenger haben ein eigenes Limit. Bei Überschreitung antwortet der Server mit Status 429 — wiederholen Sie die Anfrage später. Auch ein über MCP verbundener KI-Assistent hat ein Anfragelimit pro Minute.

Worin unterscheidet sich der WŬMÙ-MCP-Server von einer OAuth-App?

Der WŬMÙ-MCP-Server ist eine fertige Verbindung für KI-Assistenten: Es muss nichts registriert werden — URL einfügen und mit dem eigenen Konto anmelden. Eine OAuth-App brauchen Sie, wenn Sie eine eigene Integration bauen: eine Website, einen Dienst oder eine mobile App, die im Namen von Nutzern die REST API v2 aufruft.

Starten Sie Ihre Integration

Melden Sie sich bei WŬMÙ an, erstellen Sie eine App in der Entwicklerkonsole und erhalten Sie Ihren Schlüssel.