# MCP-Server: Ihren Nodale-Workspace aus Claude Code verwalten

<https://nodale.ai/de/docs/mcp>

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](https://nodale.ai/de/docs).

## 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:

```bash
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](https://nodale.ai/de/docs) 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.

## Docs

- [Den Nodale-Agenten auf Ihrer Website installieren](https://nodale.ai/de/docs): Ein Script-Tag bringt den Nodale-Agenten auf Ihre Website. Wo Sie es einfügen, was Ihre Website erlauben muss und wie Sie prüfen, ob es läuft. (Markdown: https://nodale.ai/de/docs.md)
- [JavaScript API: den Nodale-Agenten aus Ihrem Code öffnen](https://nodale.ai/de/docs/api): Die nodale()-Befehle für Ihre Seite: den Agenten per eigenem Button oder Formular öffnen, E-Mail und Kontext übergeben, die Einwilligung des Besuchers melden. (Markdown: https://nodale.ai/de/docs/api.md)
