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
| Punkt | Wert |
|---|---|
| URL | https://docs.plantpulse.io/mcp |
| Transport | Streamable HTTP (zustandslos — keine Sitzungen) |
| Authentifizierung | Keine |
| Sprachen | en (Standard) · ko · ja · zh · de |
| Umfang | Alles, 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).
- Ö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. - Geben Sie einen Namen (z. B.
PlantPulse Docs) und eine Beschreibung ein, und tragen Sie als URLhttps://docs.plantpulse.io/mcpein. - Wählen Sie als Authentifizierung Keine (No authentication).
- Lesen Sie den Risikohinweis, stimmen Sie zu und erstellen Sie den Connector. Fertig ist es, wenn die vom Server gemeldete Werkzeugliste
search·fetchzeigt.
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.
| Werkzeug | Argumente | Rückgabe |
|---|---|---|
search_docs | query (Pflicht, bis 300 Zeichen) · product · locale · limit (1–20, Standard 8) | Die am besten passenden Abschnitte — Titel · Abschnittsüberschrift · Produkt · URL · Auszug |
get_page | path (Pflicht) · locale | Titel · URL · Abschnittsliste · vollständiger Text einer Seite (bis 60.000 Zeichen) |
list_pages | product · locale · cursor · limit (1–200, Standard 100) | Seitenliste — Pfad · Titel · Produkt. Den nächsten Teil mit cursor abrufen |
search | query (Pflicht) · locale · product · limit (1–20, Standard 8) | Für ChatGPT. {"results":[{id, title, url, text}]} — ein Ergebnis pro Seite |
fetch | id (Pflicht) — eine von search gelieferte id oder eine Docs-URL | Für ChatGPT. {id, title, text, url, metadata} — der vollständige Text einer Seite |
productist eines vonplatform·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
localewird auf Englisch (en) gesucht. Für Fragen auf Deutsch eignet sichde. - Der
pathvonget_pageakzeptiert einen Website-Pfad wie/platform/frontline/user-guide, einen Pfad mit Sprachpräfix wie/de/...oder eine vollständige URLhttps://docs.plantpulse.io/.... Bei unbekannten Pfaden werden ähnliche Seiten vorgeschlagen. search·fetchliefern denselben Index mit den Namen und in der Form, die ChatGPT erwartet. Ohnelocalewähltsearchdie Sprache anhand der Zeichen des Suchbegriffs (Hangul →ko, Kana →ja, andere CJK-Zeichen →zh, Deutsch →de, sonsten). 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.
| Punkt | Grenze | Bei Überschreitung |
|---|---|---|
| Anfragerate | Etwa 30 pro Minute und IP (kurzzeitig bis zu 20 erlaubt) | 429 — nach einer Minute erneut versuchen |
| Anfragegröße | 64 KB | 413 |
| Länge des Suchbegriffs | 300 Zeichen | Werkzeugfehler |
| Suchergebnisse | 20 pro Aufruf, Auszüge von etwa 700 Zeichen | Gekürzt |
| Seitentext | 60.000 Zeichen | Gekü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.
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
| Symptom | Ursache und Abhilfe |
|---|---|
Verbindung schlägt fehl · 406 | Der 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. |
405 | Die Anfrage verwendete GET. Dieser Server ist zustandslos und akzeptiert nur POST. |
429 | Zu viele Anfragen. Nach etwa einer Minute erneut versuchen. |
503 | Die Website wurde gerade neu bereitgestellt, und der Server lädt seinen Index. In einigen Sekunden erneut versuchen. |
| Ergebnisse nur auf Englisch | Es wurde kein locale angegeben. Bitten Sie das KI-Werkzeug, „in der deutschen Dokumentation zu suchen“, dann ruft es mit de auf. |