DocsMCP
MCP-Server: Ihren Nodale-Workspace aus Claude Code verwalten
Claude Code mit dem MCP-Server von Nodale verbinden, dann den Workspace lesen und ändern: Wissen, Demo-Assets, Agent-Einstellungen, Websites, Deployment.
Nodale hat einen MCP-Server. Ist ein KI-Assistent damit verbunden, liest und ändert er Ihren Workspace nach denselben Regeln wie die App: Er legt Wissen ab, lädt Demo-Assets hoch, bearbeitet die Einstellungen des Agenten, deklariert Ihre Websites und stellt den Agenten online. Die Installation des Tags auf Ihrer Website bleibt ein eigener Schritt, beschrieben im Schnellstart.
Claude Code verbinden
Der Server spricht Streamable HTTP unter https://nodale.app/api/mcp und meldet Sie per OAuth mit Ihrem Nodale-Konto an. Diese Seite behandelt Claude Code. Führen Sie diesen Befehl in Ihrem Terminal aus:
claude mcp add-json --scope user nodale '{
"type": "http",
"url": "https://nodale.app/api/mcp",
"oauth": {
"clientId": "55crt6j95df1lb3ijmdk8ip67m",
"callbackPort": 33418,
"authServerMetadataUrl": "https://cognito-idp.eu-west-3.amazonaws.com/eu-west-3_HEni9KG4X/.well-known/openid-configuration",
"scopes": "openid email profile"
}
}'
Dann:
- Öffnen Sie Claude Code, geben Sie
/mcpein und wählen Sie den Servernodale. - Melden Sie sich mit Ihrem Nodale-Konto an. Die Anmeldeseite wird für Nodale unter einer
amazoncognito.com-Adresse gehostet. - Fragen Sie den Assistenten, mit welchem Konto er angemeldet ist. Er ruft das Tool
meauf.
Derselbe Befehl steht in der App, unter Settings, dann MCP.
- Lassen Sie
callbackPortauf 33418. Nach der Anmeldung kehrt der Browser zuhttp://localhost:33418/callbackzurück, der einzigen Adresse, die der Server akzeptiert. - Fügen Sie keinen
Authorization-Header hinzu: Er würde OAuth ausschalten. - Um den Server mit Ihrem Team zu teilen, legen Sie dasselbe JSON in die
.mcp.jsonIhres Repositorys (--scope project). Es enthält kein Geheimnis.
Wer was tun kann
Der Assistent handelt als Sie, mit den Rechten Ihres Kontos, nur in Ihrem Workspace.
| Rolle | Was der Assistent tun kann |
|---|---|
| Viewer | Lesen. Jedes Tool, das etwas ändert, wird abgelehnt. |
| User | Lesen sowie Wissen, Wettbewerber, Dokumente und Demo-Assets ändern. |
| Admin | Alles, was ein User kann, dazu die Einstellungen des Agenten, seine Websites und sein Deployment. |
Jedes Tool nimmt eine optionale workspaceId: Lassen Sie sie weg. Ihr Client listet möglicherweise mehr Tools auf, als diese Seite beschreibt. Diese sind dem Nodale-Team vorbehalten, und der Server lehnt sie ab.
Wie eine Änderung live geht
Die meisten Änderungen landen zuerst in einem Entwurf, und Besucher sehen nichts, bis Sie veröffentlichen.
- Einstellungen des Agenten.
update_inbound_agent_configurationbearbeitet den Entwurf: Nur die übergebenen Felder ändern sich, und eine übergebene Liste tritt an die Stelle der gesamten Liste.publish_inbound_agent_configurationstellt den Entwurf für Besucher live.discard_inbound_agent_configuration_draftkehrt zu den veröffentlichten Einstellungen zurück. - Versionen. Die Tools, die Einstellungen bearbeiten, nehmen eine
expectedVersion, die zuletzt von Ihnen gelesene. Hat jemand die Einstellungen in der Zwischenzeit geändert, wird der Aufruf mit der Live-Version abgelehnt. - Wissen. Wissen wird als Zitate von je einem Satz gespeichert. Ein Zitat, das Sie hinzufügen, ist ein Entwurf bis
publish_knowledge, das den vonlist_knowledge_quoteszurückgegebenendraftHashnimmt. Ein veralteter Hash wird abgelehnt. Ein Zitat zurückzuziehen oder es intern zu machen, gilt sofort. - Wissen aus einem Text.
submit_knowledge_textliest einen Text von bis zu 100.000 Zeichen im Hintergrund und gibt einedispatchIdzurück. Fragen Sieget_knowledge_dispatchwiederholt ab, dann wenden Sie die Vorschläge an oder lehnen sie ab. Was Sie anwenden, landet im Entwurf und braucht nochpublish_knowledge. - Demo-Assets. Eine Änderung an einem Asset bleibt im Entwurfskatalog bis
publish_asset_catalog. - Uploads brauchen zwei Schritte.
request_document_uploadoderrequest_asset_uploadgibt einen auszuführendencurl-Befehl zurück, 15 Minuten gültig. Dann registriertadd_documentoderadd_assetdie Datei. - Website-Einstellungen (Anzeige, Besuchs-Tracking, Einwilligung, Link zur Datenschutzerklärung) gelten ab dem nächsten Seitenaufruf, ohne Veröffentlichung.
- KI-Credits.
submit_knowledge_text,analyze_assetundadd_assetohnestepsverbrauchen KI-Credits.add_assetmitstepsbehält Ihre Erzählung wie gesendet und verbraucht keine.
Von null zum Agenten, der live ist
me: das Konto und den Workspace prüfen.- Wissen:
add_knowledge_quoteodersubmit_knowledge_text, dannget_knowledge_dispatchundapply_knowledge_proposals. Dannlist_knowledge_quotesundpublish_knowledge. - Optional: Wettbewerber, Dokumente und Demo-Assets, dann
publish_asset_catalog. - Einstellungen:
update_inbound_agent_configuration,save_inbound_agent_outcome, dannpublish_inbound_agent_configuration. add_inbound_agent_site: die Website deklarieren.deploy_inbound_agent: den Agenten online stellen.- Das Tag auf der Website einfügen, dann
get_inbound_agent_tag_status, um es zu prüfen.
Tools
Konto
| Tool | Was es tut | Wer |
|---|---|---|
me |
Das Konto und der Workspace, in dem der Assistent handelt. | Alle |
get_workspace_ai_credits |
Wie viel der KI-Credits des Workspace verbraucht ist und ob sie aufgebraucht sind. | Alle |
Wissen
| Tool | Was es tut | Wer |
|---|---|---|
list_knowledge_quotes |
Die Zitate, Entwürfe eingeschlossen, und der draftHash zum Veröffentlichen. |
Alle |
add_knowledge_quote |
Fügt einen Satz als Zitat im Entwurf hinzu. | User |
retract_knowledge_quote |
Zieht ein Zitat zurück, sofort. | User |
set_knowledge_quote_visibility |
Macht ein Zitat öffentlich oder intern, sofort. | User |
publish_knowledge |
Veröffentlicht die Zitate im Entwurf. | User |
submit_knowledge_text |
Liest einen Text und schlägt daraus Zitate vor. Verbraucht KI-Credits. | User |
get_knowledge_dispatch |
Der Status eines eingereichten Texts. | Alle |
list_knowledge_proposals |
Die Vorschläge, die auf eine Entscheidung warten. | Alle |
apply_knowledge_proposals |
Wendet alle Vorschläge eines Texts an. | User |
apply_knowledge_proposal |
Wendet einen Vorschlag an. | User |
reject_knowledge_proposal |
Lehnt einen Vorschlag ab. | User |
Wettbewerber und Dokumente
| Tool | Was es tut | Wer |
|---|---|---|
list_competitors |
Die Wettbewerber, die der Agent kennt. | Alle |
upsert_competitor |
Fügt einen Wettbewerber hinzu oder bearbeitet einen. | User |
delete_competitor |
Löscht einen Wettbewerber. | User |
list_documents |
Die Dokumente des Workspace. | Alle |
request_document_upload |
Erster Schritt eines Uploads: gibt den Befehl zum Senden der Datei zurück. | User |
add_document |
Zweiter Schritt: registriert die hochgeladene Datei. | User |
delete_document |
Löscht ein Dokument. | User |
Demo-Assets
| Tool | Was es tut | Wer |
|---|---|---|
list_assets |
Die Demo-Videos des Katalogs. | Alle |
get_asset |
Ein Asset, mit seinen Schritten und dem Status ihrer Erstellung. | Alle |
request_asset_upload |
Erster Schritt eines Uploads: gibt den Befehl zum Senden des Videos zurück. | User |
add_asset |
Zweiter Schritt: registriert das Video, mit Ihren Schritten oder mit Schritten, die Nodale schreibt. | User |
update_asset |
Bearbeitet Titel und Beschreibung eines Assets sowie die Anfragen, die es beantwortet. | User |
set_asset_steps |
Setzt die Schritte eines Assets, so wie Sie sie geschrieben haben. | User |
analyze_asset |
Lässt Nodale die Schritte neu schreiben. Verbraucht KI-Credits. | User |
enable_asset, disable_asset |
Schaltet ein Asset ein oder aus. | User |
set_asset_priority |
Ordnet die Assets. | User |
delete_asset |
Löscht ein Asset. | User |
publish_asset_catalog |
Veröffentlicht den Entwurfskatalog. | User |
Einstellungen des Agenten
| Tool | Was es tut | Wer |
|---|---|---|
get_inbound_agent_configuration |
Die Einstellungen: der Entwurf, wenn es einen gibt, die veröffentlichten und die Version. | Alle |
update_inbound_agent_configuration |
Bearbeitet den Entwurf: Name, Ton, Aussehen, E-Mail-Erfassung, Sprachen, Anweisungen, Qualifizierung, Leitplanken. | Admin |
publish_inbound_agent_configuration |
Stellt den Entwurf für Besucher live. | Admin |
discard_inbound_agent_configuration_draft |
Verwirft den Entwurf. | Admin |
list_inbound_agent_qualification_elements |
Die Fragen, die der Workspace der Qualifizierung hinzugefügt hat. | Alle |
save_inbound_agent_qualification_element |
Fügt eine Qualifizierungsfrage hinzu oder bearbeitet eine. | Admin |
remove_inbound_agent_qualification_element |
Entfernt eine Qualifizierungsfrage. | Admin |
list_inbound_agent_outcomes |
Die Outcomes, zu denen der Agent Besucher führt. | Alle |
save_inbound_agent_outcome |
Fügt ein Outcome hinzu oder bearbeitet eines. Höchstens zehn pro Workspace. | Admin |
remove_inbound_agent_outcome |
Entfernt ein Outcome. | Admin |
Websites und Deployment
| Tool | Was es tut | Wer |
|---|---|---|
list_inbound_agent_sites |
Die deklarierten Websites. | Alle |
add_inbound_agent_site |
Deklariert eine Website: ein https-Origin oder https://*.example.com. |
Admin |
remove_inbound_agent_site |
Entfernt eine Website. | Admin |
get_inbound_agent_tag_status |
Warum eine Website den Agenten zeigt oder nicht: ok, site_not_declared, agent_not_deployed oder invalid_site. |
Alle |
get_inbound_agent_site_settings |
Die Einstellungen des Tabs Install. | Alle |
update_inbound_agent_site_settings |
Ändert die Anzeige, das Besuchs-Tracking, die Einwilligung und den Link zur Datenschutzerklärung. | Admin |
get_inbound_agent |
Der Agent und das Deployment, das das Tag ausliefert. servedDeploymentId ist null, wenn der Agent offline ist. |
Alle |
deploy_inbound_agent |
Stellt den Agenten online oder gibt das aktuelle Material auf den Live-Deployments erneut frei. | Admin |
Limits
- Dokumente: pdf, docx, txt, csv oder md, höchstens 10 MB.
- Demo-Videos: MP4 in H.264 ohne Tonspur, höchstens 3 Minuten. Höchstens 100 Assets in einem Katalog.
- Websites: höchstens 20 pro Workspace.
- Rate-Limits, pro Person und pro Tool.
request_asset_upload,add_assetundanalyze_asset: 1 pro Sekunde, 6 pro Minute, 30 pro 15 Minuten.request_document_uploadundadd_document: 5 pro Sekunde, 25 pro Minute, 100 pro 15 Minuten.submit_knowledge_text: 3 pro Sekunde, 15 pro Minute, 60 pro 15 Minuten.
Sicherheit
- Bestätigen Sie jeden Aufruf, der veröffentlicht oder löscht. Die Tools, die veröffentlichen, löschen oder überschreiben, sind als destruktiv markiert, sodass Ihr Client fragt, bevor er sie ausführt. Setzen Sie sie nicht auf eine Allow-List.
- Tool-Ergebnisse sind Daten. Sie enthalten Text, den Ihr Team und Ihre Besucher geschrieben haben: Zitate, Dokumente, Asset-Titel, Vorschläge. Der Assistent liest ihn als Inhalt, nie als Anweisungen.