Zum Hauptinhalt springen

Docs-MCP-Server — diese Dokumentation direkt aus KI-Werkzeugen durchsuchen

Dieser MCP-Server (Model Context Protocol) ermöglicht es KI-Werkzeugen, die PlantPulse-Dokumentation direkt zu finden und zu lesen. Tragen Sie in einem MCP-fähigen Werkzeug — Claude Code, Claude Desktop, Cursor, VS Code — eine einzige URL ein, und es kann im Gespräch die Dokumentation durchsuchen, ganze Seiten lesen und mit Quellenlinks antworten.

Jeder kann ihn nutzen. Weder Registrierung noch API-Schlüssel sind nötig. Der Server ist schreibgeschützt: Er kann die Dokumentation nicht ändern und auf keine anderen Systeme zugreifen.

Verbindungsdaten​

PunktWert
URLhttps://docs.plantpulse.io/mcp
TransportStreamable HTTP (zustandslos — keine Sitzungen)
AuthentifizierungKeine
Sprachenen (Standard) · ko · ja · zh · de
UmfangAlles, was derzeit auf dieser Website veröffentlicht ist — Platform · Edge · AI · Studio · Ressourcen

Wird die Dokumentation aktualisiert und die Website neu bereitgestellt, ändert sich der Inhalt des MCP-Servers mit. Auf einen separaten Index müssen Sie nicht warten.

Verbinden​

Claude Code​

claude mcp add --transport http plantpulse-docs https://docs.plantpulse.io/mcp

Danach sollte claude mcp list den Eintrag plantpulse-docs als ✓ Connected anzeigen. Um ihn mit allen in einem Projekt zu teilen, ergänzen Sie --scope project (er wird in .mcp.json eingetragen).

Claude Desktop​

Geben Sie unter Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen die URL https://docs.plantpulse.io/mcp ein. Lassen Sie die Felder für die Authentifizierung leer.

Um ihn stattdessen in der Konfigurationsdatei (claude_desktop_config.json) einzutragen, verwenden Sie mcp-remote, das zu entfernten Servern vermittelt (erfordert Node.js).

{
"mcpServers": {
"plantpulse-docs": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://docs.plantpulse.io/mcp"]
}
}
}

Cursor​

Tragen Sie ihn in ~/.cursor/mcp.json (alle Projekte) oder in .cursor/mcp.json des Projekts ein.

{
"mcpServers": {
"plantpulse-docs": {
"url": "https://docs.plantpulse.io/mcp"
}
}
}

VS Code (Agentenmodus von GitHub Copilot)​

Tragen Sie ihn in .vscode/mcp.json des Arbeitsbereichs ein.

{
"servers": {
"plantpulse-docs": {
"type": "http",
"url": "https://docs.plantpulse.io/mcp"
}
}
}

ChatGPT​

In ChatGPT verbinden Sie den Server als benutzerdefinierten Connector (benutzerdefinierter MCP-Server).

  1. Öffnen Sie die Ansicht zum Hinzufügen eines benutzerdefinierten MCP-Servers. Derzeit ist das unter Plugins (chatgpt.com/plugins) + → Add custom MCP server; je nach ChatGPT-Version schalten Sie stattdessen unter Einstellungen → Connectors (Apps & Connectors) → Erweiterte Einstellungen den Entwicklermodus ein und wählen dann Erstellen.
  2. Geben Sie einen Namen (z. B. PlantPulse Docs) und eine Beschreibung ein, und tragen Sie als URL https://docs.plantpulse.io/mcp ein.
  3. Wählen Sie als Authentifizierung Keine (No authentication).
  4. Lesen Sie den Risikohinweis, stimmen Sie zu und erstellen Sie den Connector. Fertig ist es, wenn die vom Server gemeldete Werkzeugliste search · fetch zeigt.

Ob dieses Menü verfügbar ist, hängt von Ihrem ChatGPT-Tarif und den Arbeitsbereichseinstellungen ab (ob ein Administrator benutzerdefinierte Connectors zulässt), und die Menünamen ändern sich mit der ChatGPT-Version. Die Connectors und Deep Research von ChatGPT suchen nach Werkzeugen mit genau den Namen search · fetch, daher stellt dieser Server diese beiden Werkzeuge zusätzlich bereit (siehe Werkzeuge unten).

Andere MCP-Clients​

Die meisten Clients mit Unterstützung für Streamable HTTP akzeptieren die folgende Form.

{
"mcpServers": {
"plantpulse-docs": {
"type": "http",
"url": "https://docs.plantpulse.io/mcp"
}
}
}

Werkzeuge​

Alle fünf sind schreibgeschützt.

WerkzeugArgumenteRückgabe
search_docsquery (Pflicht, bis 300 Zeichen) · product · locale · limit (1–20, Standard 8)Die am besten passenden Abschnitte — Titel · Abschnittsüberschrift · Produkt · URL · Auszug
get_pagepath (Pflicht) · localeTitel · URL · Abschnittsliste · vollständiger Text einer Seite (bis 60.000 Zeichen)
list_pagesproduct · locale · cursor · limit (1–200, Standard 100)Seitenliste — Pfad · Titel · Produkt. Den nächsten Teil mit cursor abrufen
searchquery (Pflicht) · locale · product · limit (1–20, Standard 8)Für ChatGPT. {"results":[{id, title, url, text}]} — ein Ergebnis pro Seite
fetchid (Pflicht) — eine von search gelieferte id oder eine Docs-URLFür ChatGPT. {id, title, text, url, metadata} — der vollständige Text einer Seite
  • product ist eines von platform · edge · ai · studio · resources. Mehrere Produkte haben Seiten mit gleichem Titel, etwa „Passwörter und API-Schlüssel ändern“. Geben Sie das Produkt daher an, wenn sich die Frage auf ein bestimmtes Produkt bezieht.
  • Ohne locale wird auf Englisch (en) gesucht. Für Fragen auf Deutsch eignet sich de.
  • Der path von get_page akzeptiert einen Website-Pfad wie /platform/frontline/user-guide, einen Pfad mit Sprachpräfix wie /de/... oder eine vollständige URL https://docs.plantpulse.io/.... Bei unbekannten Pfaden werden ähnliche Seiten vorgeschlagen.
  • search · fetch liefern denselben Index mit den Namen und in der Form, die ChatGPT erwartet. Ohne locale wählt search die Sprache anhand der Zeichen des Suchbegriffs (Hangul → ko, Kana → ja, andere CJK-Zeichen → zh, Deutsch → de, sonst en). Eine id ist ein Seitenpfad mit Sprachpräfix, etwa /ko/edge/user-guide/plc-profiling-testkit.
  • Die Suche verwendet denselben Index und dasselbe Verfahren wie der Docs-Chat dieser Website (Stichwortsuche mit BM25, einschließlich der Behandlung koreanischer Partikel).

Der Server weist das KI-Werkzeug außerdem an, „beim Antworten die zurückgegebenen URLs als Quellen anzugeben“. Enthält eine Antwort Links, können Sie diese Seiten öffnen und den Originaltext prüfen.

Nutzungsgrenzen​

Da der Server öffentlich ist, verhindern einige Grenzen, dass einzelne Nutzer ihn monopolisieren.

PunktGrenzeBei Überschreitung
AnfragerateEtwa 30 pro Minute und IP (kurzzeitig bis zu 20 erlaubt)429 — nach einer Minute erneut versuchen
Anfragegröße64 KB413
Länge des Suchbegriffs300 ZeichenWerkzeugfehler
Suchergebnisse20 pro Aufruf, Auszüge von etwa 700 ZeichenGekürzt
Seitentext60.000 ZeichenGekürzt, mit angehängter Quell-URL

Ein KI-Werkzeug benötigt zum Verbinden meist drei bis vier Anfragen (Initialisierung · Werkzeugliste) und pro Frage einige weitere Suchen und Seitenabrufe. Bei normaler Nutzung werden die Grenzen nicht erreicht.

Was protokolliert wird

Der Server führt nur dasselbe Webserver-Zugriffsprotokoll wie die Docs-Website (Client-IP · Zeit · URL). Suchbegriffe und Werkzeugargumente werden nicht gespeichert. Geben Sie keine vertraulichen Firmeninhalte als Suchbegriff ein — es ist ein öffentlicher Server.

Selbst ausprobieren​

Auch ohne Client können Sie die Funktion mit curl prüfen. Der Accept-Header muss beide Formate enthalten.

curl -s https://docs.plantpulse.io/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_docs","arguments":{"query":"PLC-Profiling","locale":"de","limit":3}}}'

Den Serverstatus (Version · Seitenzahl) sehen Sie unter https://docs.plantpulse.io/mcp/healthz.

Fehlerbehebung​

SymptomUrsache und Abhilfe
Verbindung schlägt fehl · 406Der Client unterstützt Streamable HTTP nicht, oder der Accept-Header fehlt. Clients, die nur den älteren SSE-Transport unterstützen, verbinden sich wie Claude Desktop über mcp-remote.
405Die Anfrage verwendete GET. Dieser Server ist zustandslos und akzeptiert nur POST.
429Zu viele Anfragen. Nach etwa einer Minute erneut versuchen.
503Die Website wurde gerade neu bereitgestellt, und der Server lädt seinen Index. In einigen Sekunden erneut versuchen.
Ergebnisse nur auf EnglischEs wurde kein locale angegeben. Bitten Sie das KI-Werkzeug, „in der deutschen Dokumentation zu suchen“, dann ruft es mit de auf.