Zum Hauptinhalt springen

MCP-Werkzeugkarte

Die Werkzeuge, die die KI im Fragen-Modus (Chat) und die Automatisierung aufrufen können, stammen aus sieben MCP-Servern. Hier steht, welcher Server wofür zuständig ist und warum die KI ein vorhandenes Werkzeug trotzdem nicht benutzt.

묻기(코파일럿) 의 AI
│
┌────────────┬────────────┬─────────┼──┬────────────┬────────────┬────────────┐
▼ ▼ ▼ ▼ ▼ ▼ ▼
플랫폼 통합 시계열 인사이트 RAG 문서 이해 비전 디지털 스레드 공학 계산
/api/v5/mcp insight_ 39개 rag_ 2개 document_ 2개 vision_ 5개 thread_ 4~9개 eng_ 4개
22개
«공장의 실제 «파형을 보고 «문서에서 «PDF·표를 «사진을 «무엇이 언제 «공식으로
데이터» 판단» 찾는다» 읽는다» 본다» 일어났고 무엇과 계산한다»
이어졌나»

Der Copilot bindet diese Server nicht direkt an. Ab 2026.10 Re-Release (2026-10-20) bündelt ein MCP Gateway (plantpulse-mcp-gateway-api, intern 7160) die Werkzeuge der Plattform · der eingebauten Server · der vom Betreiber angebundenen externen Server, und der Copilot sieht nur diese eine Adresse. Die eingebauten Server registriert das Gateway bei der Installation selbst.


Anfangs eingeschaltete Werkzeuge — Gateway-Richtlinie​

Ob ein Werkzeug bei seiner ersten Erkennung ein- oder ausgeschaltet wird, legt die Richtlinie des MCP Gateway fest. Geändert wird Ein/Aus unter AI-Administrationskonsole › MCP Gateway › Tools → AI-Administrationskonsole — MCP Gateway

ServerBei der ersten Erkennung
Platform-Integrations-MCPalle ein
Zeitreihen-Insights insight_34 ein — von 39 sind ein schreibendes (trigger_feature_pipeline, nicht einschaltbar) sowie die vier forecast_order_completion · autonomy_status · get_oee_losses · get_spc_chart aus → Zeitreihen-Insight-Werkzeuge
Digital Thread thread_9 ein — alle lesenden Werkzeuge
Engineering-Berechnung eng_4 ein — alle vier
RAG rag_2 ein — rag_search (Dokumentensuche) · rag_list_documents
Dokumentverständnis document_2 ein — document_understand · document_profiles
Vision vision_5 ein — vision_read_meter · vision_inspect · vision_ocr · vision_analyze · vision_classify
Vom Betreiber angebundene externe Serveraus — Beschreibung je Werkzeug lesen und dann einschalten
  • Die Listen sind nach Namen festgelegt. Neue Werkzeuge eingebauter Server kommen ausgeschaltet herein.
  • Vom Administrator einmal geänderte Werte bleiben in der Gateway-DB erhalten; weder Start noch Versionswechsel überschreiben sie.
  • 🔴 Die Dokumentensuche des Chats hat nur einen Weg: rag_search. Ist dieses Werkzeug ausgeschaltet oder für das Konto nicht zugelassen, wird auf Fragen zu Handbüchern · Zeichnungen · Abläufen mit «Das Dokumentensuche-Tool ist ausgeschaltet oder für dieses Konto nicht zugelassen» geantwortet.
  • 🔴 So viel eingeschaltet zu lassen setzt voraus, dass die Werkzeugsuche eingeschaltet ist. Das Gateway wählt je Frage bis zu 20 passende Werkzeuge (Budget) für das Modell aus, und search_domains, das Name → ID auflöst, sowie die Dokumentensuche rag_search werden unabhängig vom Budget immer zusätzlich mitgegeben (sofern für das Konto zugelassen). Wird die Suche in Search Settings ausgeschaltet, erhält das Modell bei jeder Frage alle rund 70 eingeschalteten Werkzeuge.
  • Die Suche wählt neben Werkzeugname · Beschreibung auch anhand von Suchbegriffen aus. Da die Werkzeugbeschreibungen englisch sind, verbinden diese Wörter koreanische Fragen mit den Werkzeugen; sie dienen nur der Wortsuche und sind für das Modell unsichtbar. Als Quelle gewinnt in dieser Reihenfolge: Überschreibung dieser Installation › Serverdeklaration › Gateway-Standardwerte (Platform-Integrations-MCP). Externe MCP-Server können sie im _meta["io.plantpulse/search_terms"] eines Werkzeugs etwa als {"ko": ["알람 확인 처리"]} deklarieren. Je Werkzeug bis zu 4 Sprachen, über alle Sprachen zusammen bis zu 8 Begriffe · 64 Zeichen; wird das überschritten, wird alles verworfen → AI-Administrationskonsole — Tool-Suchbegriffe

In älteren Ständen (bis Re-Release 8) hielt der Copilot Ein/Aus selbst, und bei den Zeitreihen-Insights waren nur wenige wie get_attention_ranking eingeschaltet. Beim Wechsel auf Re-Release (2026-10-20) werden diese Werte nicht übernommen, es wird mit der obigen Richtlinie neu begonnen. Haben Sie in älteren Ständen bewusst Werkzeuge ausgeschaltet, schalten Sie sie nach dem Upgrade erneut aus.

Dafür gibt es zwei Gründe:

  1. Wirft man der KI Dutzende Werkzeuge hin, scheitert sie an der Auswahl.
  2. Die Beschreibungen ungenutzter Werkzeuge kosten bei jeder Anfrage Tokens.

Deshalb sind die einzuschaltenden Werkzeuge per Richtlinie festgelegt, und auch unter den eingeschalteten grenzt die Suche je Frage ein.

Neu angebundene externe Server starten ausgeschaltet und für niemanden freigegeben

Auch wenn Sie dem Gateway einen externen Server hinzufügen und dessen Werkzeuge einlesen, können weder KI noch Automatisierung irgendetwas nutzen. Schalten Sie den Server ein, schalten Sie jedes Werkzeug ein und geben Sie es unter Permissions dem Aufrufer (Copilot) frei. Die Beschreibungen externer Werkzeuge gehen unverändert in den Modell-Prompt — lesen Sie sie, bevor Sie einschalten.

Das ist der erste Prüfpunkt bei „Werkzeug ist da, die KI nutzt es nicht“ → AI-Administrationskonsole — MCP Gateway

Schreibende Werkzeuge lassen sich nicht einschalten

Werkzeuge, die den Zustand ändern, werden automatisch ausgeblendet und sind per Richtlinie gesperrt. Die einzige Ausnahme ist die Alarmquittierung (ack_alarm), und auch diese geht erst durch, nachdem der Anlagenbereich geprüft wurde. Mittel, um Anlagen zu steuern oder Einstellungen zu ändern, gibt es überhaupt nicht.


Platform-Integrations-MCP — 22 Werkzeuge​

Hier liegen die realen Werksdaten. Platform (server-web) stellt sie über /api/v5/mcp bereit, die Authentifizierung erfolgt über api_key.

AchseWerkzeugFunktion
Zeitget_current_timeAktuelle Serverzeit
Struktursearch_domainsÜber den Namen suchen und die ID auflösen (meist der Startpunkt)
Strukturget_asset_treeAsset-Hierarchiebaum
Strukturget_ontologyÜbersicht der Standort-Ontologie
Strukturquery_ontologyAsset-Beziehungsgraph durchsuchen
Strukturquery_sparqlSPARQL-Abfrage auf die Ontologie
Strukturget_asset_documentsListe der an eine Anlage angehängten Dokumente
Verbindungget_edge_statusStatus des Edge-Gateway
Verbindungget_edge_health_historyVerlauf des Edge-Zustands (Abschnitte je Tag)
Verbindunglist_connectionsListe der OPC-Erfassungsverbindungen
Tagget_tag_valuesAktueller Tag-Wert
Tagget_tag_historyTag-Verlauf über einen Zeitraum
Alarmlist_alarmsAlarmliste
Alarmget_alarm_contextDiagnosepaket zur Alarmursache
Alarmack_alarmAlarmquittierung — 🔴 einziges schreibendes Werkzeug
Anlageget_asset_snapshotSnapshot aller Tags einer Anlage
Anlageget_asset_timelineEreignis-Zeitleiste der Anlage
Anlageget_asset_statsBetriebswirtschaftliche Kennzahlen der Anlage im Zeitraum
Produktionlist_ordersListe der Werkaufträge
Produktionget_order_metricsWerkauftragsdetails · KPI
Produktionget_asset_kpiKPI je Anlage und Auftrag (OEE/EMS/RAM)
Rollupget_healthZustands-Rollup über die Asset-Hierarchie
Der Name-zu-ID-Schritt steht fast immer am Anfang

Menschen sagen „Kompressor Linie 3“, die Werkzeuge erwarten eine ID. search_domains schlägt die Brücke — greift die KI die falsche Anlage, hat sich das meist an dieser Stelle entschieden.

Zur Bedienung siehe MCP-Serververwaltung, zur detaillierten Nutzung der Ontologie-Werkzeuge Ontologie.


Zeitreihen-Insights — 39 insight_-Werkzeuge​

Diese Seite beurteilt anhand des Signalverlaufs: Anomalieerkennung · Prognose · Vergleich mit der Vergangenheit · Anlagenübersicht · Alarmstatistik · Profile, und ab 2026.10 KI-Funde · auffällige Anlagen · Produktionsanalyse (Prognose des Auftragsabschlusses · OEE-Verluste · Regelkarten).

→ Vollständige Liste der Zeitreihen-Insight-Werkzeuge


RAG — 2 rag_-Werkzeuge​

WerkzeugFunktion
rag_searchSucht relevante Dokumente im Hybridmodus und liefert Antwort samt Quellen. Je Quelle bildet reference_id ein Paar mit [n] im Antworttext
rag_list_documentsListe der indizierten Dokumente
Ohne Treffer kommt «Fehler» zurück

Findet die Suche nichts, liefert rag_search success: false · retrieved: false sowie code (NO_CONTEXT · EMPTY_ANSWER) · reason zurück und führt answer nicht mit. So wird verhindert, dass die KI ein leeres Ergebnis als «Suchergebnis» auffasst und sich eine Antwort aus eigenem Wissen zusammenreimt — wenn die KI antwortet „in den Dokumenten nicht gefunden“, ist das normales Verhalten.

→ Dokumentensuche (RAG)


Dokumentverständnis — 2 document_-Werkzeuge​

WerkzeugFunktion
document_understandWandelt ein Dokument unter einer URL in strukturiertes Markdown um — erkennt Tabellen, Layout und Formeln. PDF · DOCX · PPTX · XLSX · Bilder
document_profilesListe der wählbaren Parsing-Profile
ProfilVerwendung
defaultGleiche Optionen wie die RAG-Indizierung — wenn Sie sehen wollen, „wie RAG dieses Dokument gelesen hat“
fastSchnell — OCR aus, Tabellen grob
ocrNur Text — liest Text aus Bildern (Tabellenstrukturerkennung aus)
scanScans — ignoriert die Textebene und führt alles per OCR aus
Warum es eigene Profile gibt

Wählt jede aufrufende Seite die Parsing-Optionen selbst, wird dasselbe Dokument an jeder Stelle anders gelesen. Deshalb sind die Vorgaben in Profilen gebündelt — bei Problemen der Art „Tabellen zerfallen“ ist ein Profilwechsel der erste Schritt.

Kommt kein einziges Zeichen heraus, gilt das als «Fehler»

Selbst wenn der Parser Erfolg meldet, kommt bei leerem Textkörper ok: false zurück (die REST-Antwort lautet status: "empty"). Meist wurde ein Scan ohne Textebene ohne OCR gelesen; rufen Sie ihn dann mit dem Profil scan oder ocr erneut auf.

Die Obergrenze je Dokument beträgt standardmäßig 200 MiB (MAX_DOCUMENT_BYTES); darüber wird abgelehnt (REST: 413). Der Agentenpfad wartet auf das Ergebnis, meldet aber Fehler, sobald MCP_WAIT_TIMEOUT (Standard 300 Sekunden) überschritten wird.


Vision — 5 vision_-Werkzeuge​

Betrachtet Fotos. Zustandslos — Bilder werden nicht gespeichert, sondern nach der Verarbeitung verworfen.

WerkzeugFunktion
vision_read_meterLiest den Anzeigewert von Messgeräten (Manometer · Digitalanzeigen)
vision_inspectFindet Defekte auf Anlagenfotos — Leckagen, Korrosion, Risse, Bruch, Fremdkörper, Überhitzung
vision_ocrLiest Text im Foto — Typenschilder, Etiketten, Schilder, Bildschirme. Koreanisch wird unverändert als Koreanisch übernommen
vision_classifyKlassifiziert in eine der vorgegebenen Klassen (mindestens 2 Labels erforderlich)
vision_analyzeFreie Fragen zum Foto
Bei uneinheitlichem Befund wird abgelehnt

Vision rät bei Unklarheiten nicht. Wird dasselbe Foto mehrfach beurteilt und kommt kein Konsens zustande, wird abgelehnt statt eine Antwort zu erfinden — denn bei Beurteilungen Vor-Ort ist eine „plausible Falschaussage“ weit teurer als ein „weiß nicht“.

WerkzeugKonsensregel
vision_read_meter4 von 5 — Wert und Einheit müssen exakt übereinstimmen (strengste Regel)
vision_inspect · vision_classify2 von 3 — die Beurteilung (das Label) muss übereinstimmen
vision_analyzeKein Konsens — freie Beschreibung, daher nicht für Ablesewerte oder Gut-Entscheide verwenden
vision_ocr2 von 3 — die Zeichenfolge ohne Leerzeichen muss übereinstimmen. Ab 2026.10 Re-Release liest das betriebene LLM (davor die docling-OCR des Dokumentverständnisses — die kein Koreanisch lesen konnte). Die Engine lässt sich über VISION_OCR_ENGINE zurückstellen → Umgebungsvariablen konfigurieren

Digital Thread — 4 bis 9 thread_-Werkzeuge​

Zeigt, was im Werk in welcher Reihenfolge geschehen ist und was womit zusammenhängt. Zurück kommen keine Werte, sondern Referenzen auf Ereignisse und Verknüpfungen — Messwerte und KPI liefern das Platform-Integrations-MCP bzw. die Zeitreihen-Insights.

WerkzeugFunktionStandard
thread_get_timelineChronologie der Ereignisse zu einer Anlage · einem Auftrag · einem Tag — Zustandswechsel · Alarm kommt/geht · Auftragsstart/-ende · geplante Stillstände, dazu Incidents · Vorschläge · Funde des Copilot. Fenster maximal 31 Tageein
thread_trace_linksWie Objekte verknüpft sind — Anlagenhierarchie · Tags · Versorgungs-/Abhängigkeitsbeziehungen zwischen Anlagen · an Anlagen gebundene Arbeitsanweisungen · Prozesse · Teile · auf der Anlage gelaufene Aufträge · an der Anlage hängende Incidents · Vorschläge. Bei zwei Objekten der kürzeste Pfadein
thread_today_workHeutige Arbeitsliste des Schichtführers (ohne date der heutige Tag) — je Prozess, der an dem Tag geplant ist oder in Platform läuft: Bereitschaft · Anlagenstatus · Puffertage und Risiko des zu erfüllenden Kundenauftrags · ausstehende Material-POs · zu verwendende Zeichnungen und Revisionsstände. Sortiert nach knappsten Kundenpuffertagenein
thread_impact_rangeWie weit eine verspätete PO · ein Lieferant · eine Anlage · ein fehlerhaftes Los reicht — Arbeitsanweisungen · Kundenaufträge · Kunden. Vorwärts (wohin sich der Verzug auswirkt: ab PO-Zeile · Lieferant · Teil · Anlage · Konstruktionsänderung · Instandhaltungs-Arbeitsanweisung) oder rückwärts (Qualitätsrückverfolgung: ab Los · Seriennummer · Abweichung · Werkzeug · Probe). Mit as_of die Verknüpfungen zu einem früheren Zeitpunkt; Kundenauftragszeilen enthalten ERP-Liefertermin und Resttage (D-n). Nicht angebundene Familien gelten nicht als «keine», sondern als «unbekannt»ein
thread_interval_productionWas während eines Anomalie- · Alarm- · Stillstandsintervalls auf der Anlage gefertigt wurde — Arbeitsanweisungen · Lose · Seriennummern dieses Intervalls (MES-Ausführungszeiten) und die Kundenaufträge · Kunden, die diese Lose erreichen. Intervall maximal 31 Tage. Ohne MES heißt es nicht «nichts lief», sondern «unbekannt»; Kunden, die nur über nach dem Intervall entstandene Verknüpfungen erreicht werden, werden getrennt von der bestätigten Auswirkung aufgeführtein
thread_explain_recoveryUm wie viel sich Meilensteine bei verspäteten Teilen verschieben, samt Wiederherstellungsplan (What-if) — die Zahlen liefert der Optimierungslöser des Servers, die KI gibt sie lediglich wieder. Sind PLM- · QM-Konnektoren aktiv, kommen Verzögerungen aus Konstruktionsänderungen · Abweichungen hinzu; liefert SCM die Lieferfähigkeit der Zulieferer, wird auch beantwortet, ob verspätete Teile vorgezogen werden können. Enthalten sind außerdem die betroffenen Kundenauftragszeilen (customer_orders[]) und PO-Werte, bei denen ERP und SCM auseinanderlaufen (purchase_order_conflicts[])ein
thread_work_readinessArbeitsbereitschaft für den Schichtführer — je Prozess GO · AT_RISK · NO_GO · UNKNOWN mit Begründung je Positionein
thread_part_revision_statusOb Teilenummer · Revision aktuell verwendet werden dürfen — current · outdated · change_open · unknownein
thread_check_toolingAus dem Werkzeugverwaltungs-Konnektor — Messungen mit überfällig kalibrierten oder gefallenen Messmitteln, in Arbeitsanweisungen eingesetzte Werkzeuge, Ursachenkandidaten für Abweichungenein
  • Alle sind schreibgeschützt (Aufruf ohne Freigabe). Ergebnisse werden auf 16.000 Zeichen gekürzt zurückgegeben.
  • Die Bedingungen für das Erscheinen in der Serverliste unterscheiden sich. die vier get_timeline · trace_links · impact_range · interval_production sind immer vorhanden, explain_recovery nur, wenn eine Quelle für die Eingaben (z. B. ein Konnektorregister) konfiguriert ist; die vier today_work · work_readiness · part_revision_status · check_tooling nur, wenn das Konnektorregister (DT_PG_* · PI_DT_SECRET_KEY) konfiguriert ist. Daher die Spanne von 4 bis 9 Werkzeugen.
  • Ab Re-Release (2026-10-20) sind alle neun von Anfang an eingeschaltet (Gateway-Richtlinie). Ausgeschaltet wird unter AI-Administrationskonsole › MCP Gateway › Tools → MCP Gateway
  • Objekte in den Ergebnissen von trace_links · get_timeline · impact_range · interval_production (bei der Timeline Ziel und Kopf des Ereignisses) erhalten nur dann die Bildschirmadresse des Ursprungssystems open_url und den Schaltflächentext open_label, wenn der Konnektor dieses Systems eine Link-Vorlage hat. Andernfalls fehlen beide Felder → Digital Thread — Externe Links
  • Das Anbinden von Konnektoren und das Füllen der Spiegel geschieht in der Administrationskonsole → Digital Thread

Engineering-Berechnung — 4 eng_-Werkzeuge​

Berechnet Engineering-Größen nach Formeln, etwa Lagerschadensfrequenzen oder NPSH. Dieser Server verhindert, dass das Modell im Kopf schätzt. Der Server ist plantpulse-engcalc-api (im Stack :7150, nicht nach außen geöffnet) und läuft ohne DB · Volume · LLM. Einen eigenen Schalter gibt es nicht — er startet stets mit dem Stack.

WerkzeugAnzeigenameFunktionStandard
eng_list_formulasListe der Engineering-FormelnListe der berechenbaren Formelnein
eng_formulaEngineering-Formel berechnen29 benannte Formeln — liefert zur Antwort Einheiten · Einsetzschritte · Quelleein
eng_unit_convertEinheitenumrechnungEinheiten umrechnenein
eng_calc_evalAusdrucksberechnungBerechnung von Ausdrücken wie Grundrechenarten und Potenzen. Nur zugelassene Operationen, mit Obergrenzen für Exponent · Länge · Zeit (es werden keine Programme ausgeführt)ein
  • Alle sind schreibgeschützt und werden ohne Freigabe aufgerufen.
  • Der Schlüssel ist derselbe PI_INBOUND_API_KEY wie bei den übrigen Backends. Ist er leer, verweigert der Server den Start.

Konnektoren zu Fremdsystemen werden nicht hier angebunden​

MCP-Konnektoren zu Fremdsystemen wie MES · SCM · ERP · PLM · QM werden unter AI-Administrationskonsole → Digital Thread → Integrationskarte registriert. Dort müssen sie den Konformitätstest bestehen, um eingeschaltet zu werden; der Copilot nutzt sie über den Digital-Thread-Server.

  • Bindet man sie als externen Server an das MCP Gateway an, lassen sich die Konnektorwerkzeuge (die mit mes_ · scm_ · sched_ · erp_ · plm_ · qm_ · cmms_ · tool_ · wms_ · lims_ · ehs_ beginnen) nicht einschalten — diese Werkzeuge vermittelt nur der Digital Thread.
  • Hatten Sie in älteren Ständen Fremdkonnektoren am Copilot registriert, werden diese Einträge mit Re-Release (2026-10-20) gelöscht. Registrieren Sie sie in der Integrationskarte neu und tragen Sie die Zugangsdaten erneut ein → Digital Thread

Werkzeuge mit URL-Eingabe — interne Adressen werden abgelehnt​

Dokumentverständnis- und Vision-Werkzeuge nehmen keine Dateien, sondern URLs entgegen. Diese URL ist eine von der KI erzeugte Zeichenkette; nimmt man sie ungeprüft an, könnte die KI sich Inhalte vorlesen lassen, die nur innerhalb des Containers erreichbar sind. Deshalb wird bereits am Eingang blockiert.

  • Angenommen werden nur http · https.
  • Löst die Adresse auf Loopback · private Netze (10/8 · 172.16/12 · 192.168/16) · Link-Local (einschließlich Cloud-Metadaten) auf, wird abgelehnt. Auch Weiterleitungen werden bei jedem Sprung erneut geprüft.
  • Größenobergrenzen — Dokumente 200 MiB, Fotos 32 MiB.

Bei Ablehnung liefert das Werkzeug ok: false und den Grund refused to fetch … zurück.

URLs interner Dateiserver werden nur gelesen, wenn sie «auf der Positivliste stehen»

Dokumente und Fotos auf internen Adressen wie http://192.168.x.x/… werden standardmäßig abgelehnt. Tragen Sie die freizugebenden Hosts in FETCH_ALLOWED_HOSTS in /etc/kopens/plantpulse-ai.env ein (mehrere per Komma, standardmäßig leer); compose reicht die Liste an Dokumentverständnis und Vision gleichermaßen weiter (ab 2026.10 Re-Release).

  • Der Eintrag muss exakt dem Hostnamen der URL entsprechen (Groß-/Kleinschreibung wird ignoriert). Mit Port wie files.example.local:8080 wird nur dieser Port freigegeben. Über IP angesprochene Server tragen Sie mit der IP ein. Wildcards · Bereiche gibt es nicht.
  • Auch für freigegebene Hosts gelten http · https und die Größenobergrenzen unverändert; führt eine Weiterleitung auf eine andere interne Adresse, wird dort abgelehnt.
  • Nach dem Eintrag beide Dienste mit bin/restart.sh plantpulse-document-understanding-api plantpulse-vision-api neu erstellen.

→ Umgebungsvariablen konfigurieren


Namenskonventionen​

Die Werkzeugnamen im Backend sind snake_case (vision_read_meter). Das Präfix setzt das MCP Gateway, deshalb können der in der Serverdokumentation gezeigte Name (read_meter) und der im Chat aufgerufene Name (vision_read_meter) voneinander abweichen.

  • Liefern zwei Server denselben Anzeigenamen, gewinnt der zuerst registrierte, der spätere wird nicht angezeigt (im Bildschirm Tools als Konflikt markiert). Lösen Sie das, indem Sie das Präfix des späteren Servers ändern.

🔴 Schreiben Sie Werkzeuglisten nicht von Hand ab. Maßgeblich für den Installationsstand (was eingeschaltet ist) ist die Gateway-DB; der Bildschirm ist AI-Administrationskonsole › MCP Gateway › Tools, die vollständige Liste liefert die Gateway-REST GET /api/v1/tools. Das Gateway liest die Werkzeuglisten aller Server beim Start und alle 5 Minuten neu ein; mit Discover im Bildschirm Servers lässt es sich auch sofort neu einlesen.


Umgekehrte Richtung — der Copilot ist selbst ein MCP-Server​

Bisher ging es darum, dass der Copilot Werkzeuge «benutzt». Umgekehrt können andere KI-Agenten den Copilot als Werkzeug nutzen, denn er stellt seine Fähigkeiten über MCP bereit.

EintragWert
EndpunktPOST /mcp (auch mit abschließendem Slash /mcp/)
ProtokollJSON-RPC 2.0
Authentifizierungidentisch zu /api/v1 — nur X-API-Key (ab 2026.10 Re-Release 6 liefert eine Login-Session 403)
WerkzeugFunktion
ask_plantFrage in natürlicher Sprache → Antwort. Die nötigen Abfragewerkzeuge wählt der Copilot selbst, die Belege werden mitgeliefert. Gefragt wird mit den Rechten des Subjekts des aufrufenden API-Schlüssels (der Person, für die der Schlüssel ausgestellt wurde); bleibt sessionId leer, wird eine neue Konversation im Besitz dieses Subjekts eröffnet
list_plant_toolsListe der Abfragewerkzeuge, die der Copilot «jetzt» erreichen kann
daily_tasksMorgenkarte (bezogen auf KST)
Warum nur drei — es wird nur Lesendes herausgegeben

An ändernde Werkzeuge ist ein Freigabeverfahren durch Menschen geknüpft, und die über MCP aufrufende Seite kennt dieses Verfahren nicht. Deshalb wird nur Abfragendes bereitgestellt.

Die drei sind funktionsgleich mit /api/v1 und delegieren an dieselbe Implementierung — dieselbe Fähigkeit über zwei Protokolle, aber nur eine Codebasis. Bei zweien würde nur eine gepflegt.

Beide Varianten mit und ohne abschließenden Slash werden akzeptiert

Sowohl /mcp als auch /mcp/ funktionieren. Je nach Client wird die eine oder andere Variante aufgerufen, und es kam tatsächlich vor, dass wegen dieses einen Zeichens jeder Aufruf mit 307 abprallte. Wer uns aufruft, tappt nicht in diese Falle.


Verwandte Dokumente​