MCP-Toolreferenz¶

Der Nuvoca-MCP-Server bietet die folgenden Tools für deinen verbundenen KI-Assistenten. Der Client erhält nur Tools für die Scopes seiner Freigabe. Bei jedem Aufruf gelten zusätzlich deine aktuellen Workspace-Rechte. Verbindung einrichten.

Tools und Scopes¶

Tool	Aufgabe	Scope
`verify_connection`	Workspace und freigegebene Rechte prüfen	`connection:verify`
`list_agents`	Agents auflisten	`agents:read`
`get_agent`	Vollständige Konfiguration und Revision lesen	`agents:configuration:read`
`create_agent`	Agent mit agent und options anlegen	`agents:write`
`update_agent`	Agent mit aktueller Revision ändern	`agents:write`
`get_agent_catalog`	Erlaubte Modelle, Sprachen, Provider und Prompt-Variablen lesen	`agents:configuration:read`
`list_voices`	Stimmen nach Anbieter, Sprache, Geschlecht oder Suchtext auflisten	`agents:configuration:read`
`get_flow_catalog`	Erlaubte Routing-Modi, Modelle und Variablen lesen	`flows:read`
`get_tool_catalog`	Tooltypen und Konfigurationsfelder lesen	`tools:read`
`list_tool_credentials`	Referenzen vorhandener Zugangsdaten lesen; zusätzliches Leserecht nötig	`tools:read`
`list_tool_oauth_configurations`	Referenzen vorhandener OAuth-Konfigurationen lesen; zusätzliches Leserecht nötig	`tools:read`
`list_available_mcp_tools`	Bereits freigegebene externe MCP-Tools lesen	`tools:read`
`get_pre_processing_variables`	Variablen für Anruferabfragen lesen	`pre-processing:read`
`get_post_processing_variables`	Variablen für die Verarbeitung nach dem Anruf lesen	`post-processing:read`
`list_flows`	Agentic Flows auflisten	`flows:read`
`get_flow`	Flow-Konfiguration und Revision lesen	`flows:read`
`create_flow`	Flow mit vorhandenen Agents und DEFAULT-Zuordnung anlegen	`flows:write`
`update_flow`	Vollständige Flow-Konfiguration mit aktueller Revision ersetzen	`flows:write`
`delete_flow`	Flow mit aktueller Revision löschen	`flows:write`
`list_agent_tools`	Tools eines Agents auflisten	`tools:read`
`get_agent_tool`	Toolkonfiguration ohne gespeicherte Secrets lesen	`tools:read`
`create_agent_tool`	Tool anhand des Katalogs anlegen	`tools:write`
`update_agent_tool`	Tool mit aktueller Revision ersetzen; Typ bleibt bestehen	`tools:write`
`delete_agent_tool`	Tool mit aktueller Revision entfernen	`tools:write`
`list_knowledge_bases`	Knowledge Bases auflisten	`knowledge-bases:read`
`get_knowledge_base`	Titel und Version lesen	`knowledge-bases:read`
`create_knowledge_base`	Leere Knowledge Base anlegen	`knowledge-bases:write`
`rename_knowledge_base`	Titel mit aktueller Version ändern	`knowledge-bases:write`
`check_knowledge_base_deletion`	Abhängigkeiten und frischen Löschprüf-Token abrufen	`knowledge-bases:write`
`delete_knowledge_base`	Knowledge Base und Dokumente mit Löschprüf-Token löschen	`knowledge-bases:write`
`list_knowledge_documents`	Dokumentmetadaten auflisten	`documents:read`
`get_knowledge_document`	Dokumentmetadaten ohne Dateiinhalt lesen	`documents:read`
`add_knowledge_document`	Markdown-Text hochladen; höchstens 65536 Zeichen, kein URL-Abruf	`documents:write`
`delete_knowledge_document`	Dokument mit aktueller Version löschen	`documents:write`
`list_pre_processing_profiles`	Pre-Processing-Profile auflisten	`pre-processing:read`
`get_pre_processing_profile`	Konfiguration und Profilversion ohne Secrets lesen	`pre-processing:read`
`create_pre_processing_profile`	Pre-Processing-Profil mit Zuordnungen anlegen	`pre-processing:write`
`update_pre_processing_profile`	Vollständiges Pre-Processing-Profil mit aktueller Version ersetzen	`pre-processing:write`
`delete_pre_processing_profile`	Pre-Processing-Profil mit aktueller Version löschen	`pre-processing:write`
`list_post_processing_profiles`	Post-Processing-Profile auflisten	`post-processing:read`
`get_post_processing_profile`	Konfiguration und Profilversion ohne Secrets lesen	`post-processing:read`
`create_post_processing_profile`	Post-Processing-Profil mit Zuordnungen anlegen	`post-processing:write`
`update_post_processing_profile`	Vollständiges Post-Processing-Profil mit aktueller Version ersetzen	`post-processing:write`
`delete_post_processing_profile`	Post-Processing-Profil mit aktueller Version löschen	`post-processing:write`
`list_phone_numbers`	Vorhandene Workspace-Rufnummern und Routing auflisten	`phone-numbers:read`
`get_phone_number`	Rufnummernzuweisung und Revision lesen	`phone-numbers:read`
`assign_phone_number`	Vorhandene Nummer einem Agent zuweisen; ändert Routing	`phone-numbers:write`
`clear_phone_number_assignment`	Standardzuweisung entfernen; kündigt die Nummer nicht	`phone-numbers:write`
`list_call_summaries`	Gespeicherte Zusammenfassungen und Anrufdaten im Zeitraum lesen	`call-summaries:read`

Eingaben und Ergebnisse verwenden¶

Katalog zuerst: Namen, Modellwerte, Stimmen-IDs und Toolfelder aus den jeweiligen Katalogen übernehmen. list_voices unterstützt provider, language, gender und search zusätzlich zu page und size.
Pagination: Listen mit page=0 beginnen; size liegt zwischen 1 und 100. Alle Ergebnisseiten berücksichtigen. Kleine Konfigurationskataloge und einzelne Ressourcen werden vollständig geliefert.
Agent anlegen: create_agent erhält configuration mit agent und options. Die REST-Beispiele erläutern diese Konfiguration.
Ändern: Zuerst Detail lesen, dann das bearbeitete vollständige Konfigurationsobjekt und die unveränderte revision senden. Bei Knowledge Bases, Dokumenten und Processing-Profilen ist die Revision die aktuelle numerische Version als String. Bei Knowledge-Base-Löschungen den frischen assessmentToken verwenden.
Secrets: Gespeicherte Secret-Werte werden nicht zurückgegeben. Die Regeln zum Beibehalten, Entfernen oder Ersetzen von Headern stehen in den API-Konfigurationsregeln.
Schemas: Der Client kann Eingabe- und Ausgabeschemas über den MCP-Katalog lesen. Erfolgreiche Aufrufe liefern strukturierte Daten; Toolfehler sind mit isError und code gekennzeichnet.

Grenzen beachten¶

add_knowledge_document lädt UTF-8-Markdown bis 65536 Zeichen hoch. Für PDF, Word und andere unterstützte Dateien nutze die Oberfläche oder den REST-Upload. Dokument-GETs liefern Metadaten, keine Quelldateien.

Die Rufnummern-Tools bearbeiten nur Standardzuweisungen vorhandener Nummern zu einzelnen Agents. Aktive Routing overrides, Flow-Standardrouten oder eine bereits anderweitig zugewiesene Agent-Nummer können die Änderung blockieren. Flow-Zuordnungen und Zeitregeln bearbeitest du in der Oberfläche.

Die Tools starten keine Anrufe und führen keine Tooltests, Webhooks oder Nachrichten-Testsendungen aus. Änderungen können spätere Anrufe beeinflussen. Eine Zuweisung ändert das Routing. Es gibt kein Tool zum Löschen eines einzelnen Agents; nutze dafür die Agent-Verwaltung.

list_call_summaries liefert gespeicherte Zusammenfassungen mit Anrufdaten, keine Transkripte. from ist einschließlich und to ausschließlich, bezogen auf den Beginn des Anrufs. Beide müssen ISO-Zeitstempel mit Zeitzone sein. Geschwärzte Einträge enthalten weder Zusammenfassung noch Rufnummern. Beispiel für eine Tagesauswertung.

Fehler behandeln¶

Code oder Status	Vorgehen
`INVALID_ARGUMENT`	Eingabeschema, Pflichtfelder und Katalogwerte prüfen.
`FORBIDDEN`	Scopes, Rolle und Workspace-Zugriff prüfen.
`NOT_FOUND`	Ressourcen-ID und verbundenen Workspace prüfen.
`CONFLICT`	Neu lesen; parallele Änderung oder Abhängigkeit auflösen.
`OUTPUT_TOO_LARGE`	Kleinere Seite oder einzelne Ressource abrufen.
`UNAVAILABLE`	Vor einem erneuten Schreibversuch prüfen, ob die Änderung bereits erfolgte.
HTTP `401`	Verbindung erneuern beziehungsweise erneut anmelden.
HTTP `429`	`Retry-After` abwarten; unklare Schreibvorgänge nicht blind wiederholen.

REST und MCP teilen sich das Workspace-Budget: anfangs 120 Anfragen pro Minute, davon höchstens 30 schreibende. Die tatsächlichen Limits können abweichen. Beim MCP zählt die Aktion des Tools für das Schreibbudget, nicht allein die HTTP-Methode.