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:

  1. Öffnen Sie Claude Code, geben Sie /mcp ein und wählen Sie den Server nodale.
  2. Melden Sie sich mit Ihrem Nodale-Konto an. Die Anmeldeseite wird für Nodale unter einer amazoncognito.com-Adresse gehostet.
  3. Fragen Sie den Assistenten, mit welchem Konto er angemeldet ist. Er ruft das Tool me auf.

Derselbe Befehl steht in der App, unter Settings, dann MCP.

  • Lassen Sie callbackPort auf 33418. Nach der Anmeldung kehrt der Browser zu http://localhost:33418/callback zurü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.json Ihres 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_configuration bearbeitet den Entwurf: Nur die übergebenen Felder ändern sich, und eine übergebene Liste tritt an die Stelle der gesamten Liste. publish_inbound_agent_configuration stellt den Entwurf für Besucher live. discard_inbound_agent_configuration_draft kehrt 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 von list_knowledge_quotes zurückgegebenen draftHash nimmt. Ein veralteter Hash wird abgelehnt. Ein Zitat zurückzuziehen oder es intern zu machen, gilt sofort.
  • Wissen aus einem Text. submit_knowledge_text liest einen Text von bis zu 100.000 Zeichen im Hintergrund und gibt eine dispatchId zurück. Fragen Sie get_knowledge_dispatch wiederholt ab, dann wenden Sie die Vorschläge an oder lehnen sie ab. Was Sie anwenden, landet im Entwurf und braucht noch publish_knowledge.
  • Demo-Assets. Eine Änderung an einem Asset bleibt im Entwurfskatalog bis publish_asset_catalog.
  • Uploads brauchen zwei Schritte. request_document_upload oder request_asset_upload gibt einen auszuführenden curl-Befehl zurück, 15 Minuten gültig. Dann registriert add_document oder add_asset die 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_asset und add_asset ohne steps verbrauchen KI-Credits. add_asset mit steps behält Ihre Erzählung wie gesendet und verbraucht keine.

Von null zum Agenten, der live ist

  1. me: das Konto und den Workspace prüfen.
  2. Wissen: add_knowledge_quote oder submit_knowledge_text, dann get_knowledge_dispatch und apply_knowledge_proposals. Dann list_knowledge_quotes und publish_knowledge.
  3. Optional: Wettbewerber, Dokumente und Demo-Assets, dann publish_asset_catalog.
  4. Einstellungen: update_inbound_agent_configuration, save_inbound_agent_outcome, dann publish_inbound_agent_configuration.
  5. add_inbound_agent_site: die Website deklarieren.
  6. deploy_inbound_agent: den Agenten online stellen.
  7. 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_asset und analyze_asset: 1 pro Sekunde, 6 pro Minute, 30 pro 15 Minuten. request_document_upload und add_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.

Für KI-Agenten: diese Seite in Markdown

Jeder Besuch zählt.