# MCP-Server für KI

> KI-Agenten wie Claude oder Cursor per Model Context Protocol mit deiner Dokumentation verbinden.

Docsello hat einen eingebauten **MCP-Server** (Model Context Protocol). Darüber können KI-Agenten – Claude, Cursor
oder eigene Bots – deine Dokumentation lesen, durchsuchen, schreiben und veröffentlichen. Sie haben dabei genau die
Rechte ihres [API-Tokens](doc:api-tokens).

## Verbinden

:::steps
### Token erstellen

Unter **API & Tokens** einen Token anlegen. Für einen Agenten, der nur lesen und suchen soll, genügt **Nur lesen**;
soll er Seiten schreiben, **Bearbeiten & veröffentlichen**. Mit **Bereiche (leer = alle)** begrenzt du, worauf er
zugreifen darf.

### MCP-Adresse kopieren

Unter **KI & MCP** steht die **MCP URL** deiner Installation: `https://<deine-docsello-adresse>/api/mcp`.

### Im Agenten eintragen

Der Server spricht MCP über HTTP und erwartet den Token im Header `Authorization`. Zum Beispiel in Claude Code:

```bash
claude mcp add --transport http docsello https://docs.example.com/api/mcp \
  --header "Authorization: Bearer dsl_…"
```
:::

## Werkzeuge

| Werkzeug | Wofür |
|---|---|
| `markdown_syntax` | Docsellos Markdown-Bausteine – Agenten lesen das vor dem Schreiben |
| `list_spaces` | Alle lesbaren Bereiche |
| `list_pages` | Seitenbaum eines Bereichs |
| `read_page` | Markdown und Metadaten einer Seite (über ID oder Bereich + Pfad) |
| `search` | Volltextsuche über alle lesbaren Seiten |
| `write_page` | Seite über ihren Pfad anlegen oder ändern – als Entwurf, mit `publish: true` direkt live |
| `publish_page` | Den Entwurf einer Seite veröffentlichen |
| `delete_page` | Seite samt Unterseiten in den Papierkorb (in der Verwaltung wiederherstellbar) |
| `create_space` | Neuen Bereich anlegen |
| `upload_media` | Bild oder Datei hochladen (Base64), liefert die Referenz `media:<id>` |
| `list_screenshots` | Screenshot-Definitionen mit Status |
| `define_screenshot` | Automatischen Screenshot anlegen oder ändern |
| `capture_screenshots` | Screenshots neu aufnehmen (einzelne oder alle) |

Alles, was ein Agent ändert, landet wie jede andere Änderung im Verlauf der Seite (mit der Notiz „via MCP“, wenn er
keine eigene mitgibt) und im Protokoll des Workspaces.

:::tip[Entwürfe statt direkt live]
Lass Agenten Seiten als Entwurf schreiben (`publish` weglassen) und prüfe sie im Editor, bevor du veröffentlichst. In
Bereichen mit Review-Pflicht können Tokens mit *Bearbeiten & veröffentlichen* ohnehin nicht direkt veröffentlichen.
:::

## Nur lesen? Dann reicht llms.txt

Für Agenten, die deine öffentliche Dokumentation nur lesen sollen, brauchst du keinen Token: Jede öffentliche Seite
gibt es als Markdown, dazu `llms.txt` und `llms-full.txt`. Siehe [llms.txt & Markdown-Ansicht](doc:llms-txt).