Wavix
offiziellWavix ist eine globale Kommunikationsplattform, die APIs für Sprache, SMS, 2FA und Telefonnummern anbietet. Unser MCP-Server bringt diese Funktionen in KI-Agenten und agentische Workflows.
Was kann man mit Wavix MCP machen?
- Transaktions-SMS senden — Fordern Sie das Senden einer SMS mit benutzerdefiniertem Text und Absendernummer über
sms_and_mms_messages_sendan. - 2FA-Verifizierung durchführen — Erstellen und prüfen Sie Verifizierungscodes für passwortlose Anmeldeabläufe mit
two_fa_verification_createundtwo_fa_verification_check. - Nummern finden und kaufen — Suchen Sie verfügbare Nummern nach Land/Funktionen, legen Sie sie in den Warenkorb und schließen Sie den Kauf mit Bestätigung über
buy_numbers_list,cart_addundcart_checkoutab. - Gesprächstranskripte durchsuchen — Finden Sie Anrufe nach Dauer und Schlüsselwörtern in Transkriptionen und reichern Sie diese dann mit vollständigen Metadaten über
cdrs_searchundcdrs_getan. - Anrufaufzeichnungen transkribieren — Rufen Sie eine Anrufaufzeichnung ab, fordern Sie eine Transkription an und fragen Sie Ergebnisse mit
call_recording_get_by_call,cdrs_retranscribeundcdrs_transcription_getab. - Abrechnung prüfen — Listen Sie Transaktionen und Rechnungen auf, gefiltert nach Typ und Datum, über
billing_transactions_listundbilling_invoices_list.
Dokumentation
Wavix MCP Server
Ein Model Context Protocol-Server, der LLMs und KI-Agenten direkten Zugriff auf die Wavix-Telekommunikationsplattform bietet — SMS/MMS, Sprachanrufe, 2FA, SIP-Trunking, Telefonnummernverwaltung, 10DLC-Registrierung, Anrufaufzeichnungen, Sprachanalysen und Abrechnung.
Wavix ist eine globale Kommunikationsplattform zum Senden von SMS, Tätigen von Sprachanrufen und Ausführen von 2FA-Abläufen über eine einzige API. Eine kostenlose Testversion ist verfügbar; die kostenpflichtige Nutzung folgt dem Preismodell von Wavix, das mit Ihrem Konto verknüpft ist.
Der schnellste Weg, diesen MCP-Server zu nutzen, ist der gehostete Endpunkt unter https://mcp.wavix.com/mcp — richten Sie einen beliebigen MCP-kompatiblen Client darauf aus und verbinden Sie sich, indem Sie sich mit Ihrem Wavix-Konto oder einem Wavix-API-Schlüssel anmelden. Wenn Sie selbst hosten müssen (benutzerdefinierte Wavix-Bereitstellung, hinter einer Firewall, dedizierte Instanz), lesen Sie Eigenen Server ausführen.
Inhaltsverzeichnis
- Endpunkt
- Installation — Mit einem Konto anmelden, API-Schlüssel, Ein-Klick, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
- Eigenen Server ausführen (Selbsthosting)
- Beispiele
- Tools → vollständiger Katalog in TOOLS.md
- Ressourcen
- Authentifizierung (Bewährte Verfahren, wenn ein Token kompromittiert ist)
- Fehlerbehebung
- Kompatibilität und Grenzen
- Support, Mitwirken, Sicherheit, Lizenz
Endpunkt
| Feld | Wert |
|---|---|
| URL | https://mcp.wavix.com/mcp |
| Transport | Streamable HTTP |
| Authentifizierung | Mit einem Wavix-Konto anmelden (OAuth 2.1), oder Authorization: Bearer <api_key> |
| Tools | siehe TOOLS.md |
| Ressourcen | Wavix-Dokumentation + OpenAPI-Spezifikation (automatisch erkannt) |
Einen Wavix-API-Schlüssel erhalten Sie in der Wavix-Konsole → Administration → API-Schlüssel → Neu erstellen.
Installation
Zwei Verbindungsmöglichkeiten — wählen Sie die, die Ihr Client unterstützt; keine ist der anderen vorzuziehen.
Mit einem Wavix-Konto anmelden
Wenn Ihr MCP-Client OAuth unterstützt (Claude Desktop / Web und andere OAuth-fähige Clients), verbinden Sie sich ohne API-Schlüssel: Fügen Sie den Connector für https://mcp.wavix.com/mcp hinzu und melden Sie sich, wenn der Client dazu auffordert, mit Ihrem Wavix-Konto an und genehmigen Sie den Zugriff. Der Client führt den OAuth-2.1-Ablauf aus und speichert das Token selbst — nichts muss eingefügt werden. Die Tools, die Sie erhalten, sind auf das beschränkt, was Sie genehmigen und was Ihre Kontorolle erlaubt (siehe Fehlerbehebung).
Mit einem API-Schlüssel verbinden
Bevor Sie beginnen: Besorgen Sie sich Ihren Wavix-API-Schlüssel.
- Melden Sie sich unter https://wavix.com an.
- Öffnen Sie Administration → API-Schlüssel.
- Klicken Sie auf Neu erstellen (oder kopieren Sie einen vorhandenen Schlüssel). Halten Sie ihn bereit — Sie fügen ihn unten anstelle von
YOUR_API_KEYein.
Ein-Klick-Installation
⚠️ Die Schaltflächen unten befüllen die MCP-Konfiguration Ihres Editors mit einem Platzhalter-Token
YOUR_API_KEY. Nachdem der Editor die Installation abgeschlossen hat, öffnen Sie die generierte Konfiguration und ersetzen Sie den Platzhalter durch Ihren echten API-Schlüssel, bevor Sie eine Anfrage senden — andernfalls gibt jeder Aufruf401 Unauthorizedzurück.
Zum späteren Entfernen: Öffnen Sie dieselbe Konfigurationsdatei (~/.cursor/mcp.json, .vscode/mcp.json oder das Äquivalent für Ihren Editor) und löschen Sie den wavix-Eintrag, oder entfernen Sie den Connector über die MCP-/Connectors-Oberfläche Ihres Editors.
Claude Code
claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Verwenden Sie claude mcp list zur Überprüfung und /mcp innerhalb einer Sitzung für den Status.
Claude Desktop / Claude Web
Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen:
- Name:
Wavix - URL:
https://mcp.wavix.com/mcp - Transport:
Streamable HTTP - Authentifizierungs-Header:
Authorization: Bearer <api_key>
Um sich stattdessen durch Anmelden zu verbinden, fügen Sie den Connector ohne Authentifizierungs-Header hinzu und melden Sie sich mit Ihrem Wavix-Konto an, wenn der Client dazu auffordert.
Cursor (manuell)
Fügen Sie zu ~/.cursor/mcp.json (oder projektbezogen .cursor/mcp.json) hinzu:
{
"mcpServers": {
"wavix": {
"url": "https://mcp.wavix.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
Cursor 2.4+ zeigt den vollständigen Katalog; frühere Versionen begrenzen auf 40.
VS Code (manuell, GitHub Copilot Chat)
Erstellen Sie .vscode/mcp.json in Ihrem Arbeitsbereich (oder fügen Sie dasselbe servers-Objekt unter dem "mcp"-Schlüssel in der Benutzer-settings.json hinzu):
{
"servers": {
"wavix": {
"type": "http",
"url": "https://mcp.wavix.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
Siehe den VS-Code-MCP-Server-Leitfaden für das aktuelle Schema.
Codex CLI
Codex CLI unterstützt MCP über stdio. Überbrücken Sie zum gehosteten Server über mcp-remote. Bearbeiten Sie ~/.codex/config.toml:
[mcp_servers.wavix]
command = "npx"
args = [
"-y",
"mcp-remote",
"https://mcp.wavix.com/mcp",
"--header",
"Authorization:Bearer ${WAVIX_API_KEY}"
]
[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"
Windsurf / andere Clients
Jeder MCP-Client, der Streamable-HTTP-Transport mit benutzerdefinierten Headern unterstützt, funktioniert. Verwenden Sie:
- URL:
https://mcp.wavix.com/mcp - Header:
Authorization: Bearer <api_key>
Einrichtung über einen KI-Agenten? Weisen Sie Ihren Agenten auf llms-install.md hin — es ist eine maschinenlesbare Installationsanleitung, die dem Modell URL, Header und client-spezifische Konfiguration in einem deterministischen Format liefert, sodass es keine Endpunktwerte improvisiert.
Eigenen Server ausführen
Der gehostete Server funktioniert für die meisten Benutzer sofort. Hosten Sie selbst, wenn Sie auf eine nicht öffentliche Wavix-Bereitstellung zeigen, hinter einer Firewall laufen oder in Ihrer eigenen Infrastruktur arbeiten müssen.
Docker
docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server
Der Server lauscht auf Port 8000 und stellt den MCP-Endpunkt unter /mcp bereit. Richten Sie Ihren Client auf http://<host>:8000/mcp aus.
Aus dem Quellcode
git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp
Erfordert Python 3.10+.
Konfiguration
| Umgebungsvariable | Standard | Zweck |
|---|---|---|
WAVIX_API_BASE_URL | https://api.wavix.com | Überschreibt den vorgelagerten Wavix-API-Endpunkt (für interne Bereitstellungen oder Staging) |
OAUTH_ISSUER | nicht gesetzt | Basis-URL des OAuth-2.1-Autorisierungsservers. Dessen JWKS wird von <issuer>/.well-known/jwks.json gelesen |
OAUTH_RESOURCE | nicht gesetzt | Öffentliche Basis-URL, unter der dieser Server erreichbar ist; wird als Ressourcenkennung verwendet |
OAUTH_API_KEY_PASSTHROUGH | true | Bei aktiviertem OAuth weiterhin ein Bearer-Token akzeptieren, das kein OAuth-JWT ist, und es vorgelagert weiterleiten (API-Schlüssel funktionieren weiterhin). Setzen Sie false, um ein JWT zu erzwingen |
MCP_PATH | /mcp | Pfad, unter dem der MCP-Endpunkt bereitgestellt wird |
Zum Ausführen des Servers sind keine Wavix-Anmeldeinformationen erforderlich — sie werden pro Anfrage aus dem Authorization: Bearer <api_key>-Header des MCP-Clients weitergeleitet. Selbsthoster sind dafür verantwortlich, TLS vor dem Server zu terminieren (nginx, Caddy, Cloud-Load-Balancer), bevor sie ihn öffentlich bereitstellen.
OAuth 2.1 (optional)
Setzen Sie OAUTH_ISSUER und OAUTH_RESOURCE gemeinsam, um den Server in eine
OAuth-2.1-geschützte Ressource zu verwandeln. Er veröffentlicht dann RFC 9728-Metadaten unter
/.well-known/oauth-protected-resource<MCP_PATH>, validiert eingehende Zugriffstokens
als JWTs gegen die JWKS des Ausstellers und beantwortet nicht authentifizierte Anfragen
mit einer WWW-Authenticate-Herausforderung, die auf diese Metadaten verweist. MCP-Clients, die
OAuth unterstützen, nutzen dies, um den Autorisierungsablauf selbst auszuführen, sodass Benutzer
keinen API-Schlüssel mehr in ihre Client-Konfiguration einfügen müssen.
Die Zielgruppe (Audience), die jedes Token tragen muss, ist OAUTH_RESOURCE + MCP_PATH, was auch
der resource-Wert ist, der in den Metadaten veröffentlicht wird. Autorisierungsserver,
die RFC 8707 implementieren, vergleichen den resource-Parameter des Clients
exakt mit dieser Zeichenfolge, daher müssen beide so konfiguriert sein, dass sie übereinstimmen — einschließlich
des Pfads.
Das Aktivieren von OAuth schneidet Clients, die sich mit einem Wavix-API-Schlüssel
authentifizieren, nicht ab. Ein Bearer-Token, das kein gültiges OAuth-JWT ist, wird vorgelagert
unverifiziert weitergeleitet, genau wie zuvor, sodass die Wavix-API die alleinige Autorität darüber bleibt —
eine bestehende Bereitstellung kann OAuth also für neue Clients aktivieren, ohne die bereits
verbundenen zu beeinträchtigen. Eine Anfrage ohne Token erhält weiterhin die
WWW-Authenticate-Herausforderung, wodurch ein OAuth-fähiger Client den
Autorisierungsserver entdecken kann. Nur OAuth-authentifizierte Verbindungen werden
bereichsgefiltert; eine API-Schlüssel-Verbindung sieht die vollständige Tool-Oberfläche.
Setzen Sie OAUTH_API_KEY_PASSTHROUGH=false, um diesen Fallback zu entfernen und ein gültiges
JWT zu erzwingen — den strikten Modus, auf den Sie umstellen sollten, sobald der API-Schlüsselzugriff ausgemustert ist.
Wenn Sie entweder OAUTH_ISSUER / OAUTH_RESOURCE nicht gesetzt lassen, bleibt das bisherige
Verhalten erhalten: Es werden keine Metadaten veröffentlicht und jedes vom Client gesendete Bearer-Token
wird vorgelagert unverifiziert weitergeleitet.
Beispiele
Konkrete Eingabeaufforderungen, die Sie in jeden verbundenen Client einfügen können.
Die Telefonnummern unten (
+1 310 555 0100,+44 7700 900123) liegen in reservierten Testbereichen (NANP555und Ofcom070 09xx) — sicher zum wörtlichen Kopieren, keine echten Teilnehmer sind darüber erreichbar.
Eine transaktionale SMS senden
Eingabeaufforderung: „Sende eine SMS von +13105550100 an +447700900123 mit dem Text ‚Ihr Verifizierungscode lautet 4821‘.“
Der Agent ruft sms_and_mms_messages_send mit from, to und text auf. Gibt die Nachrichten-ID und den Zustellstatus zurück.
Eine 2FA-Verifizierung durchführen
Eingabeaufforderung: „Sende einen 2FA-Verifizierungscode an +13105550100 per SMS. Wenn ich dir den Code gebe, den ich erhalte, prüfe, ob er korrekt ist.“
Der Agent ruft two_fa_verification_create auf, wartet darauf, dass Sie den per SMS eingehenden Code teilen, und ruft dann two_fa_verification_check auf. Nützlich zum Prototypisieren von passwortlosen Abläufen ohne Integrationscode.
Eine Telefonnummer finden und kaufen
Eingabeaufforderung: „Finde eine verfügbare US-gebührenfreie Nummer mit SMS-Fähigkeit, füge sie meinem Warenkorb hinzu und kassiere ab.“
Der Agent verknüpft buy_numbers_list (gefiltert nach Land und Funktion), cart_add und cart_checkout. cart_checkout gibt zunächst eine Vorschau mit den Nummern und ihren Gebühren zurück und belastet das Konto nur, wenn es erneut mit seiner confirmation_token aufgerufen wird.
Anruftranskripte durchsuchen
Eingabeaufforderung: „Zeig mir alle eingehenden Anrufe von gestern, die länger als zwei Minuten dauern und in denen der Anrufer ‚Rückerstattung‘ erwähnt hat.“
Der Agent verwendet cdrs_search gegen Transkriptionen und reichert dann jedes Ergebnis über cdrs_get mit vollständigen Anrufmetadaten an.
Eine Aufzeichnung abrufen und transkribieren
Eingabeaufforderung: „Hole die Aufzeichnung für Anruf abc-123, bitte Wavix, sie zu transkribieren, und gib die Transkription zurück.“
Der Agent ruft call_recording_get_by_call (gibt eine vorab signierte Download-URL zurück), cdrs_retranscribe auf und fragt dann cdrs_transcription_get ab.
Abrechnung prüfen
Eingabeaufforderung: „Wie viel haben wir letzten Monat für SMS ausgegeben, und welche Rechnungen wurden ausgestellt?“
Der Agent ruft billing_transactions_list auf, gefiltert nach Typ und Datum, und dann billing_invoices_list. Das Herunterladen der Rechnungs-PDF selbst ist über MCP nicht verfügbar — rufen Sie es über die Wavix-API oder das Dashboard ab.
Tools
Generiert aus der Wavix-OpenAPI-Spezifikation. Argumente spiegeln Anforderungsparameter und Body-Felder wider. Die angezeigten Tools hängen von den Berechtigungen ab, die Sie bei der Anmeldung genehmigen, und den Funktionen, die auf Ihrem Konto aktiviert sind.
| Gruppe | Abdeckung |
|---|---|
| SMS und MMS | Nachrichten senden, auflisten, abrufen; Absenderkennungen; Opt-outs |
| Geschäftskonten; Absender; Vorlagen; Nachrichten senden / auflisten / abrufen | |
| Anrufsteuerung | Anrufe starten / beantworten / beenden; Audio abspielen; DTMF erfassen |
| Anrufaufzeichnung | Auflisten, herunterladen (vorab signierte URL), löschen |
| Anruf-Streaming | Medienstream starten / stoppen |
| Anruf-Webhooks | Auflisten, erstellen, löschen |
| CDRs | Auflisten, abrufen; Transkriptionssuche und erneutes Transkribieren |
| Sprachanalytik | Transkribieren, Originaldatei abrufen |
| 2FA | Verifizierung erstellen / prüfen / abbrechen / erneut senden; Ereignisse |
| Meine Nummern | Auflisten, aktualisieren, freigeben; SMS / Sprach-Routing |
| Kaufen | Länder, Regionen, Städte; Suche nach verfügbaren Nummern |
| Warenkorb | Hinzufügen, entfernen, abrufen, zur Kasse gehen |
| Nummernvalidierung | Einzel- und Massenvalidierung |
| SIP-Trunks | Vollständiges CRUD |
| 10DLC | Marken, Kampagnen, Prüfung, Nachweise, Ereignisabonnements |
| Profil | Profil abrufen / aktualisieren; Kontokonfiguration |
| API-Schlüssel | Auflisten, erstellen, aktualisieren, löschen |
| Unterkonten | Auflisten, erstellen, abrufen, aktualisieren; Transaktionen |
| Abrechnung | Transaktionen; Rechnungen / Kontoauszüge auflisten |
| Sprachkampagnen | Auslösen und abrufen |
| Wavix Embeddable (WebRTC) | Widget-Token CRUD |
| Link-Shortener | Kurzlinks erstellen; Metriken |
Siehe TOOLS.md für die vollständige Werkzeugliste mit einzeiligen Beschreibungen. Die maßgebliche Quelle ist die Wavix OpenAPI-Spezifikation — Ihr Client sieht immer den aktuellen Live-Katalog.
Ressourcen
Zusätzlich zu den Werkzeugen stellt der Server die Wavix-Dokumentation als MCP-Ressourcen bereit, sodass das Modell bei Bedarf maßgeblichen Kontext abrufen kann, anstatt aus früherem Wissen zu raten.
| URI-Schema | Inhalt |
|---|---|
wavix://docs/<path> | Dokumentationsseiten von docs.wavix.com (automatisch erkannt über llms.txt). |
wavix://api/openapi.yaml | Die vollständige Wavix OpenAPI 3.0-Spezifikation. |
Beide Quellen — docs.wavix.com und die Wavix OpenAPI-Spezifikation — sind öffentlich verfügbar und können ohne Authentifizierung direkt durchsucht werden.
Ressourcen werden bei resources/read lazy abgerufen und serverseitig mit einer TTL von 1 Stunde zwischengespeichert. Das vorgelagerte Bearer-Token wird niemals an Dokumentations-Hosts weitergeleitet — nur an api.wavix.com.
Authentifizierung
Der gehostete Server akzeptiert zwei Verbindungsmethoden — keine wird bevorzugt:
- Mit einem Wavix-Konto anmelden (OAuth 2.1). Für OAuth-fähige Clients. Der Client führt den Autorisierungsablauf aus und der Benutzer meldet sich an; es wird kein API-Schlüssel gespeichert. Der Zugriff ist auf den Umfang beschränkt, den der Benutzer genehmigt und den seine Kontorolle erlaubt. Siehe Mit einem Wavix-Konto anmelden.
- Wavix-API-Schlüssel (Bearer). Für jeden Streamable-HTTP-Client. Jede Anfrage muss Folgendes enthalten:
Authorization: Bearer <api_key>
Der Server leitet diesen Header bei jeder Anfrage an api.wavix.com weiter. Das Token:
- wird niemals protokolliert,
- wird niemals bei Weiterleitungen zwischen Hosts weitergeleitet (z. B. vorab signierte S3-Download-URLs),
- wird niemals an Dokumentations-Hosts gesendet.
Wenn Ihr Client einer vorab signierten Download-URL folgt, die von call_recording_get_by_call, speech_analytics_file_get oder ten_dlc_brand_evidence_get zurückgegeben wird, rufen Sie sie direkt ohne den Authorization-Header ab.
Best Practices
-
Verwenden Sie einen dedizierten API-Schlüssel für MCP. Erstellen Sie einen separaten API-Schlüssel unter https://wavix.com → Administration → API-Schlüssel (oder über das
api_keys_create-Werkzeug selbst, aus einer anderen Sitzung). So können Sie den MCP-Zugriff widerrufen, ohne andere Integrationen zu stören. -
Regelmäßig rotieren. Behandeln Sie den API-Schlüssel wie jedes Produktionsgeheimnis: Rotieren Sie ihn planmäßig und bei jedem Verdacht auf Offenlegung.
-
API-Schlüssel nicht in Git aufbewahren. MCP-Client-Konfigurationen lassen sich leicht versehentlich committen und nehmen das Token mit in die Historie und CI-Logs. Die meisten Clients unterstützen die
${env:VAR}-Substitution im Header-Wert — speichern Sie den API-Schlüssel in einer Umgebungsvariablen oder im OS-Schlüsselbund und referenzieren Sie ihn aus der Konfiguration. Als Sicherheitsnetz fügen Sie die gängigen Client-Konfigurationspfade zu Ihrer Projekt-.gitignorehinzu:.cursor/mcp.json .vscode/mcp.json claude_desktop_config.json .claude/mcp.json .codex/config.toml
Wenn eine Anmeldeinformation kompromittiert ist
Wenn Sie sich mit einem API-Schlüssel verbunden haben:
- Deaktivieren oder löschen Sie diesen Schlüssel sofort in der Wavix-Konsole (oder rufen Sie
api_keys_deleteauf). - Erstellen Sie einen Ersatz über
api_keys_createoder die Konsole. - Aktualisieren Sie die Client-Konfiguration und verbinden Sie sich erneut.
Wenn Sie sich mit Ihrem Wavix-Konto angemeldet haben:
- Widerrufen Sie die Verbindung über die Berechtigungsverwaltungsseite des Wavix-Portals, die die von Ihnen autorisierten Verbindungen auflistet und die von Ihnen gewählte widerruft — dies macht die Tokens dieser Verbindung ungültig. Es ist kein API-Schlüssel beteiligt.
- Verbinden Sie sich erneut und melden Sie sich erneut an.
Überprüfen Sie in beiden Fällen billing_transactions_list und cdrs_list auf unerwartete Aktivitäten.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache / Lösung |
|---|---|
401 Unauthorized von jedem Werkzeug | Authentifizierung fehlgeschlagen. Mit einem API-Schlüssel: Der Authorization: Bearer …-Header fehlt, oder der Schlüssel ist ungültig oder inaktiv — überprüfen Sie ihn in der Wavix-Konsole. Mit Konto-Anmeldung: Ihre Sitzung/Ihr Token ist abgelaufen oder wurde widerrufen, oder die Anmeldung wurde nie abgeschlossen — verbinden Sie sich erneut und melden Sie sich erneut an. |
Werkzeug gibt ein download_url zurück, nicht die Datei selbst | Erwartet. Aufzeichnungs-, Sprachanalytik- und 10DLC-Nachweis-Endpunkte geben vorab signierte URLs zurück (siehe Authentifizierung). Rufen Sie die URL direkt ohne den Authorization-Header ab. |
| Client zeigt nur einen Teil des Katalogs | Ältere Clients erzwingen ein Werkzeuglimit pro Server. Aktualisieren Sie (Cursor 2.4+, neuestes VS Code, neuestes Claude). |
| Nach der Anmeldung mit einem Wavix-Konto sind weniger Werkzeuge verfügbar | Erwartet. Die Konto-Anmeldung ist umfangsgefiltert — Sie erhalten die Werkzeuge, die Ihre genehmigten Bereiche und Ihre Kontorolle erlauben, nicht den vollständigen Katalog. Eine API-Schlüssel-Verbindung sieht die vollständige Werkzeugoberfläche. Um den Satz zu erweitern, genehmigen Sie bei der Anmeldung mehr Bereiche (vorbehaltlich Ihrer Rolle) oder verbinden Sie sich mit einem API-Schlüssel, der diese trägt. |
Tool not found für ein in dieser README aufgeführtes Werkzeug | Der lokale Client könnte eine alte Werkzeugliste zwischenspeichern. Starten Sie den Client neu oder entfernen und fügen Sie den Server erneut hinzu. |
4xx mit einem errors-Array | Validierungsfehler von der Wavix-API. Überprüfen Sie errors; ziehen Sie die relevante wavix://docs/*-Seite oder die OpenAPI-Spezifikation zu Rate. |
| Server nicht erreichbar | Bestätigen Sie DNS und ausgehendes HTTPS zu mcp.wavix.com:443. |
| Agent ruft unerwartet ein destruktives Werkzeug auf | Die meisten Clients können vor Werkzeugaufrufen eine Bestätigung verlangen — aktivieren Sie diese Einstellung und rotieren Sie zu einem dedizierten MCP-API-Schlüssel (siehe Best Practices). |
Kompatibilität & Grenzen
- Kompatibel mit jedem MCP-Client, der Streamable-HTTP-Transport unterstützt (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, benutzerdefinierte MCP-SDKs) und jedem Agent-Framework mit einem MCP-Client-Adapter.
- Jedes mit
destructiveHintannotierte Werkzeug, pluscall_webhooks_create,sip_trunks_updateundsub_accounts_update, läuft in zwei Schritten: Der erste Aufruf gibt eine Vorschau und ein einmaligesconfirmation_token(5 Minuten gültig) zurück, und die Aktion wird nur ausgeführt, wenn das Werkzeug erneut mit denselben Argumenten und diesem Token aufgerufen wird. Jeder MCP-Client kann dies tun; keine clientseitige Bestätigungsunterstützung ist erforderlich. - Ältere Clients können ein Werkzeuglimit pro Server erzwingen; aktualisieren Sie auf eine aktuelle Version, um auf den vollständigen Katalog zuzugreifen.
- Ratengrenzen und Nutzungsgebühren folgen Ihrem Wavix-Kontoplan. Siehe Wavix-Preise.
Änderungsprotokoll
Der gehostete Server wird kontinuierlich aktualisiert, während sich die Wavix-OpenAPI-Spezifikation weiterentwickelt; neue Werkzeuge erscheinen automatisch und vorhandene Werkzeugargumente können optionale Felder erhalten. Dokumentationsänderungen für dieses Repository werden unter Releases verfolgt. Bei wesentlichen Verhaltensänderungen, die Werkzeugeingaben oder die Authentifizierung betreffen, veröffentlichen wir einen Hinweis sowohl dort als auch in den Wavix-Versionshinweisen.
Support
- Produktdokumentation: https://docs.wavix.com
- API-Referenz: https://docs.wavix.com/api-reference
- Fragen / Feedback: support@wavix.com
Mitwirken
Dieses Repository ist quelloffen verfügbar, aber nicht für externe Beiträge geöffnet. Pull-Requests werden automatisch geschlossen, und Issues / Diskussionen sind deaktiviert. Senden Sie Fehlerberichte, Feature-Anfragen und Feedback an support@wavix.com. Siehe CONTRIBUTING.md für Details.
Wenn Sie einen Fehler im zugrunde liegenden FastMCP-Framework finden, melden Sie ihn bitte dort upstream.
Sicherheit
Um eine Sicherheitslücke zu melden, senden Sie bitte eine E-Mail an support@wavix.com mit dem Betreff Security: <short summary>, anstatt ein öffentliches Issue zu eröffnen. Siehe SECURITY.md für Details.
Lizenz
MIT © Wavix