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
| Server | Bei der ersten Erkennung |
|---|---|
| Platform-Integrations-MCP | alle 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 Server | aus — 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 Dokumentensucherag_searchwerden 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:
- Wirft man der KI Dutzende Werkzeuge hin, scheitert sie an der Auswahl.
- 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.
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
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.
| Achse | Werkzeug | Funktion |
|---|---|---|
| Zeit | get_current_time | Aktuelle Serverzeit |
| Struktur | search_domains | Über den Namen suchen und die ID auflösen (meist der Startpunkt) |
| Struktur | get_asset_tree | Asset-Hierarchiebaum |
| Struktur | get_ontology | Übersicht der Standort-Ontologie |
| Struktur | query_ontology | Asset-Beziehungsgraph durchsuchen |
| Struktur | query_sparql | SPARQL-Abfrage auf die Ontologie |
| Struktur | get_asset_documents | Liste der an eine Anlage angehängten Dokumente |
| Verbindung | get_edge_status | Status des Edge-Gateway |
| Verbindung | get_edge_health_history | Verlauf des Edge-Zustands (Abschnitte je Tag) |
| Verbindung | list_connections | Liste der OPC-Erfassungsverbindungen |
| Tag | get_tag_values | Aktueller Tag-Wert |
| Tag | get_tag_history | Tag-Verlauf über einen Zeitraum |
| Alarm | list_alarms | Alarmliste |
| Alarm | get_alarm_context | Diagnosepaket zur Alarmursache |
| Alarm | ack_alarm | Alarmquittierung — 🔴 einziges schreibendes Werkzeug |
| Anlage | get_asset_snapshot | Snapshot aller Tags einer Anlage |
| Anlage | get_asset_timeline | Ereignis-Zeitleiste der Anlage |
| Anlage | get_asset_stats | Betriebswirtschaftliche Kennzahlen der Anlage im Zeitraum |
| Produktion | list_orders | Liste der Werkaufträge |
| Produktion | get_order_metrics | Werkauftragsdetails · KPI |
| Produktion | get_asset_kpi | KPI je Anlage und Auftrag (OEE/EMS/RAM) |
| Rollup | get_health | Zustands-Rollup über die Asset-Hierarchie |
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
| Werkzeug | Funktion |
|---|---|
rag_search | Sucht relevante Dokumente im Hybridmodus und liefert Antwort samt Quellen. Je Quelle bildet reference_id ein Paar mit [n] im Antworttext |
rag_list_documents | Liste der indizierten Dokumente |
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.
Dokumentverständnis — 2 document_-Werkzeuge
| Werkzeug | Funktion |
|---|---|
document_understand | Wandelt ein Dokument unter einer URL in strukturiertes Markdown um — erkennt Tabellen, Layout und Formeln. PDF · DOCX · PPTX · XLSX · Bilder |
document_profiles | Liste der wählbaren Parsing-Profile |
| Profil | Verwendung |
|---|---|
default | Gleiche Optionen wie die RAG-Indizierung — wenn Sie sehen wollen, „wie RAG dieses Dokument gelesen hat“ |
fast | Schnell — OCR aus, Tabellen grob |
ocr | Nur Text — liest Text aus Bildern (Tabellenstrukturerkennung aus) |
scan | Scans — ignoriert die Textebene und führt alles per OCR aus |
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.
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.
| Werkzeug | Funktion |
|---|---|
vision_read_meter | Liest den Anzeigewert von Messgeräten (Manometer · Digitalanzeigen) |
vision_inspect | Findet Defekte auf Anlagenfotos — Leckagen, Korrosion, Risse, Bruch, Fremdkörper, Überhitzung |
vision_ocr | Liest Text im Foto — Typenschilder, Etiketten, Schilder, Bildschirme. Koreanisch wird unverändert als Koreanisch übernommen |
vision_classify | Klassifiziert in eine der vorgegebenen Klassen (mindestens 2 Labels erforderlich) |
vision_analyze | Freie Fragen zum Foto |
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“.
| Werkzeug | Konsensregel |
|---|---|
vision_read_meter | 4 von 5 — Wert und Einheit müssen exakt übereinstimmen (strengste Regel) |
vision_inspect · vision_classify | 2 von 3 — die Beurteilung (das Label) muss übereinstimmen |
vision_analyze | Kein Konsens — freie Beschreibung, daher nicht für Ablesewerte oder Gut-Entscheide verwenden |
vision_ocr | 2 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.
| Werkzeug | Funktion | Standard |
|---|---|---|
thread_get_timeline | Chronologie 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 Tage | ein |
thread_trace_links | Wie 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 Pfad | ein |
thread_today_work | Heutige 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 Kundenpuffertagen | ein |
thread_impact_range | Wie 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_production | Was 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ührt | ein |
thread_explain_recovery | Um 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_readiness | Arbeitsbereitschaft für den Schichtführer — je Prozess GO · AT_RISK · NO_GO · UNKNOWN mit Begründung je Position | ein |
thread_part_revision_status | Ob Teilenummer · Revision aktuell verwendet werden dürfen — current · outdated · change_open · unknown | ein |
thread_check_tooling | Aus dem Werkzeugverwaltungs-Konnektor — Messungen mit überfällig kalibrierten oder gefallenen Messmitteln, in Arbeitsanweisungen eingesetzte Werkzeuge, Ursachenkandidaten für Abweichungen | ein |
- 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_productionsind immer vorhanden,explain_recoverynur, wenn eine Quelle für die Eingaben (z. B. ein Konnektorregister) konfiguriert ist; die viertoday_work·work_readiness·part_revision_status·check_toolingnur, 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 Ursprungssystemsopen_urlund den Schaltflächentextopen_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.
| Werkzeug | Anzeigename | Funktion | Standard |
|---|---|---|---|
eng_list_formulas | Liste der Engineering-Formeln | Liste der berechenbaren Formeln | ein |
eng_formula | Engineering-Formel berechnen | 29 benannte Formeln — liefert zur Antwort Einheiten · Einsetzschritte · Quelle | ein |
eng_unit_convert | Einheitenumrechnung | Einheiten umrechnen | ein |
eng_calc_eval | Ausdrucksberechnung | Berechnung 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_KEYwie 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.
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:8080wird 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·httpsund 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-apineu erstellen.
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.
| Eintrag | Wert |
|---|---|
| Endpunkt | POST /mcp (auch mit abschließendem Slash /mcp/) |
| Protokoll | JSON-RPC 2.0 |
| Authentifizierung | identisch zu /api/v1 — nur X-API-Key (ab 2026.10 Re-Release 6 liefert eine Login-Session 403) |
| Werkzeug | Funktion |
|---|---|
ask_plant | Frage 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_tools | Liste der Abfragewerkzeuge, die der Copilot «jetzt» erreichen kann |
daily_tasks | Morgenkarte (bezogen auf KST) |
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.
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
- MCP-Serververwaltung — Ein- und Ausschalten, Verbindungstest
- Zeitreihen-Insight-Werkzeuge — alle 39
- Digital Thread — Konnektoren · Graph-Spiegel ·
thread_-Werkzeuge - Automatisierung — wählbar sind für die Automatisierung die hiervon eingeschalteten lesenden Werkzeuge
- Architektur — wo diese Server liegen