Zum Hauptinhalt springen

MCP (Model Context Protocol) Services

Die OctoMesh MCP (Model Context Protocol) Services sind der Model-Context-Protocol-Server für OctoMesh. Er stellt die vollständige administrative Oberfläche der Plattform – Tenants, Identity, Blueprints, Communication Adapter, Zeitreihenarchive, generisches Construction-Kit-Entity-CRUD und Aggregationsabfragen – als rund 208 typisierte Tools bereit, die KI-Assistenten (Claude Code, Claude Desktop und jeder andere MCP-fähige Client) über den MCP-Transport Streamable HTTP aufrufen.

Konzeptionell gibt es einem KI-Agenten dieselbe Reichweite, die ein Operator mit octo-cli hat, plus direkten Zugriff auf die Runtime-Engine für Entity-Abfragen und Aggregationen, die andernfalls GraphQL erfordern würden.

Wann Sie es verwenden​

Sie möchten…Verwenden Sie
OctoMesh von einem KI-Assistenten aus steuern (Claude Code / Claude Desktop)MCP Services
OctoMesh von einem menschlichen Terminal oder einer CI-Pipeline aus steuernocto-cli
OctoMesh aus Ihrem eigenen Anwendungscode heraus steuernOcto SDK
Daten interaktiv über eine UI abfragenRefinery Studio oder Power BI

Die MCP Services, die CLI, das SDK und das Studio sprechen alle dieselben Backend-Dienste an. Alles, was Sie über eines davon tun können, können Sie auch über die anderen tun – die MCP Services sind das für den KI-Einsatz optimierte.

Wie es zusammenpasst​

Im Server leben drei Familien von Tools:

  1. Platform-Admin-Tools (~140) kapseln dieselben Backend-SDK-Clients, die auch octo-cli verwendet. Der Aufruf von create_tenant aus den MCP Services ist Byte für Byte äquivalent zum Ausführen des entsprechenden octo-cli-Befehls.
  2. Generische CK-CRUD- + Schema-Tools (~16) geben einem KI-Agenten universelles Entity-Query/-Create/-Update/-Delete für jeden Construction-Kit-Typ, ohne GraphQL zusammensetzen zu müssen.
  3. Aggregations- + Stream-Data-Query-Tools (~10) spiegeln die GraphQL-Transient-Query-Oberfläche des Asset Repository – skalare und gruppierte Aggregationen, Time-Bucket-Downsampling, Persisted-Query-Replay.

Binäre Payloads (Tenant-Dumps, CK-Modell-Importe, Runtime-Modell-Exporte) fließen über einen separaten /file-transfer/{upload,download}/{id}-Kanal, damit Multi-GB-Dateien nicht durch JSON-RPC laufen.

Was in diesem Abschnitt steht​

  • Getting started – Registrieren Sie den Server bei Claude Code oder Claude Desktop, melden Sie sich über die eingebaute OAuth-Discovery an (oder ersatzweise über den Device Flow), tätigen Sie Ihren ersten Tool-Aufruf.
  • Tool reference – Die ~208 Tools nach Familie gruppiert, mit einer einzeiligen Beschreibung pro Tool.
  • Deployments – Gehostete Endpunkte (prod-1, prod-2) und wie man sie jeweils registriert.
  • Troubleshooting – Authentifizierung, Token-Refresh, häufige Fehlermeldungen.

Für die lokale Entwicklung der MCP Services selbst – Bauen aus dem Quellcode, Konfigurieren der Backend-Dienst-URLs, Ausführen gegen Start-Octo – siehe MCP Services development im Developer Guide.

Wichtige Eigenschaften​

  • Streamable-HTTP-Transport. Registrierung mit claude mcp add --transport http …. Kein stdio-Shim erforderlich.
  • Zustandslos und mandantenfähig. Der Tenant stammt aus dem Tool-Parameter tenantId (bevorzugt) oder dem URL-Pfad /{tenantId}/mcp. In der Sitzung wird kein Tenant gespeichert.
  • Standard-MCP-Autorisierung. Clients finden den Identity Service über die Protected-Resource-Metadaten des Servers, registrieren sich selbst (Dynamic Client Registration) und melden sich mit Authorization Code + PKCE an; das Token braucht den Scope octo_api. Der Device Flow (authenticate, check_auth_status) bleibt als Ausweichweg. Tokens werden automatisch aktualisiert.
  • Tutorial. Eine Schritt-für-Schritt-Anleitung vom Verbinden des Clients bis zur generierten Auswertung bietet Lösungen mit KI über den MCP-Server bauen.
  • Destruktive Operationen abgesichert. Jedes Delete-/Destroy-/Rollback-Tool erfordert einen expliziten Parameter confirm: true. Es gibt keine interaktive Abfrage.
  • Risiko-Metadaten für Sicherheits-Gates. Tools tragen eine [McpRisk(Low|Medium|High)]-Klassifizierung (gelesen über get_tool_risk_metadata), sodass umschließende Clients wie der OctoMesh AI Adapter Aufrufe mit hohem Risiko über eine Benutzerfreigabe leiten können.
  • Tenant-Routing pro Aufruf. Ein registrierter Server, viele Tenants – keine Notwendigkeit für eine MCP-Services-Registrierung pro Tenant.