Oso Cloud MCP Server

offiziell

Verstehen, entwickeln und debuggen Sie Autorisierungsrichtlinien in Oso Cloud.

Was kann man mit Oso Cloud MCP machen?

  • Ihre Policy prüfen — Bitten Sie den Assistenten, Ihre aktuelle Autorisierungs-Policy abzurufen, damit Sie überprüfen können, wie sie strukturiert ist.
  • Gespeicherte Fakten überprüfen — Lassen Sie den Assistenten alle Fakten in Ihren Oso Cloud-Daten auflisten, um zu sehen, welche Beziehungen und Attribute existieren.
  • Autorisierungsprüfungen ausführen — Fragen Sie, ob ein Akteur eine bestimmte Berechtigung für eine Ressource hat, und erhalten Sie die resultierende Entscheidung.
  • Fakten per Muster abfragen — Bitten Sie den Assistenten, Ihre Fakten mithilfe von Musterabgleich zu durchsuchen, um bestimmte Beziehungen zu finden.
  • Unerwartete Entscheidungen debuggen — Fragen Sie, warum einem Akteur die Berechtigung für eine Aktion auf einer Ressource fehlt, um die Ursache nachzuvollziehen.
  • Policy-Tests ausführen — Lassen Sie den Assistenten Ihre Policy-Tests ausführen, um das Verhalten anhand der Erwartungen zu überprüfen.
  • Policy und Daten auf Dev-Servern bearbeiten — Aktualisieren Sie die Policy, fügen Sie Fakten hinzu oder löschen Sie sie, oder leeren Sie Daten, wenn eine Verbindung zu einem lokalen Dev-Server besteht.

Dokumentation

Oso MCP Server

Integriere dein lokales LLM-Setup über unseren MCP-Server mit den Oso Cloud APIs.

Verwende den MCP-Server, um:

  • ein besseres Verständnis deiner Policy zu entwickeln
  • autorisierungsbezogene Fragen in natürlicher Sprache zu stellen
  • zu debuggen, warum eine Autorisierungsentscheidung nicht deinen Erwartungen entspricht

[!WARNING]

Diese Anleitung setzt voraus, dass du die CLI bereits installiert und eingerichtet hast.

Verbinden

Claude Desktop (DXT)

Du hast die CLI nicht installiert oder möchtest die Konfiguration nicht manuell hinzufügen? Kein Problem – lade die folgende DXT-Datei herunter und doppelklicke darauf, um den Oso MCP Server automatisch in Claude Desktop oder andere KI-Clients zu installieren, die DXTs akzeptieren.

curl -O https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt

SHA256-Prüfsumme verifizieren:

MacOS:

curl -sL https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt.sha256 | shasum -a 256 -c

Linux:

curl -sL https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt.sha256 | sha256sum -c

Du kannst auch die DXT-Version angeben:

curl -O https://d2nl1ljmg8n1q8.cloudfront.net/0.33.2/oso-cloud-mcp.dxt

Hinweis: Es gibt keine DXT-Versionen <0.33.0

Die folgenden Installationsmethoden setzen voraus, dass du die CLI bereits installiert und eingerichtet hast (Version >=0.33.0).

Cursor

Install MCP Server

Manuell

Füge in deinem LLM-Client deiner Wahl Folgendes zu deiner MCP-Konfigurationsdatei hinzu, um ihn gegen einen lokalen Dev-Server auszuführen:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • Du kannst optional die Umgebungsvariable OSO_URL weglassen oder sie auf https://cloud.osohq.com setzen, wenn du ihn gegen einen Live-Produktionsserver ausführen möchtest.
  • Das bereitgestellte OSO_AUTH-Token ist für den lokalen Dev-Server. Dein OSO_AUTH-Token für den Live-Server erhältst du in der Oso Cloud UI.

Wo finde ich meine MCP-Konfigurationsdatei?

Hier sind Anleitungen für einige gängige Clients:

Verwendung

[!WARNING]

Dieser Server ist in erster Linie für die Verwendung mit Dev-Servern gedacht, um die Entwicklung zu unterstützen. Bitte sei besonders vorsichtig, wenn du ihn gegen eine Live-Umgebung verwendest.

Sobald dein MCP-Server läuft, kannst du deinem LLM beliebige autorisierungsbezogene Fragen stellen und beobachten, wie es die verfügbaren Tools nutzt. Derzeit stellen wir Lese-Tools bereit, um:

  • deine Policy abzurufen
  • alle Fakten abzurufen
  • eine authorize-Abfrage auszuführen
  • deine Fakten mit Pattern Matching abzufragen
  • Policy-Tests auszuführen

Wir stellen außerdem die folgenden Schreib-Tools bereit, die nur für die Verwendung mit lokalen Dev-Servern beschränkt sind:

  • deine Policy aktualisieren
  • Fakten hinzufügen
  • Fakten löschen
  • alle Daten löschen

Versuche, eine der folgenden Nachrichten zu senden:

  • Zeichne ein Mermaid-Diagramm meiner Autorisierungs-Policy
  • Welche Berechtigungen hat <actor> auf <resource>?
    • z. B. „Welche Berechtigungen hat Alice auf Projekt XYZ?"
  • Warum hat <actor> keine Berechtigung für <action> <resource>?

Feedback

Wir arbeiten aktiv an der Developer Experience und freuen uns über jedes Feedback zum Oso MCP Server und zur allgemeinen Entwicklungserfahrung mit Oso Cloud. Zögere bitte nicht, uns auf Slack zu kontaktieren!

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Plattform für Entwicklerdokumentation.