Oso Cloud MCP Server

officiel

Comprendre, développer et déboguer les politiques d'autorisation dans Oso Cloud.

Que pouvez-vous faire avec Oso Cloud MCP ?

  • Inspectez votre politique — Demandez à l'assistant de récupérer votre politique d'autorisation actuelle afin que vous puissiez examiner sa structure.
  • Examinez les faits stockés — Demandez à l'assistant de lister tous les faits de vos données Oso Cloud pour voir quelles relations et quels attributs existent.
  • Exécutez des vérifications d'autorisation — Demandez si un acteur possède une permission donnée sur une ressource, et obtenez la décision résultante.
  • Interrogez les faits par motif — Demandez à l'assistant de rechercher dans vos faits en utilisant la correspondance de motifs pour trouver des relations spécifiques.
  • Déboguez les décisions inattendues — Demandez pourquoi un acteur n'a pas la permission d'effectuer une action sur une ressource afin de retracer la cause.
  • Exécutez les tests de politique — Demandez à l'assistant d'exécuter vos tests de politique pour vérifier le comportement par rapport aux attentes.
  • Modifiez la politique et les données sur les serveurs de développement — Mettez à jour la politique, ajoutez ou supprimez des faits, ou effacez des données lorsque vous êtes connecté à un serveur de développement local.

Documentation

Serveur MCP Oso

Intégrez votre configuration LLM locale aux API Oso Cloud via notre serveur MCP.

Utilisez le serveur MCP pour :

  • mieux comprendre votre politique
  • utiliser le langage naturel pour poser des questions liées à l'autorisation
  • déboguer pourquoi une décision d'autorisation ne correspond pas à ce que vous attendez

[!WARNING]

Ce guide suppose que vous avez déjà installé et configuré la CLI.

Connexion

Claude Desktop (DXT)

Vous n'avez pas la CLI installée ou vous ne souhaitez pas ajouter manuellement la configuration ? Pas d'inquiétude - téléchargez le fichier DXT suivant et double-cliquez pour installer automatiquement le serveur MCP Oso dans Claude Desktop ou d'autres clients IA qui acceptent les DXT.

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

Vérifiez la somme de contrôle SHA256 :

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

Vous pouvez également spécifier la version DXT :

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

Remarque : Il n'existe aucune version DXT <0.33.0

Les méthodes d'installation suivantes supposent que vous avez déjà installé et configuré la CLI (version >=0.33.0).

Cursor

Install MCP Server

Manuellement

Dans votre client LLM de choix, ajoutez ce qui suit à votre fichier de configuration MCP pour l'exécuter contre un serveur de développement local :

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • Vous pouvez éventuellement omettre la variable d'environnement OSO_URL ou la définir sur https://cloud.osohq.com si vous souhaitez l'exécuter contre un serveur de production en direct.
  • Le jeton OSO_AUTH fourni est destiné au serveur de développement local. Vous pouvez obtenir votre jeton OSO_AUTH du serveur en direct depuis l'interface utilisateur Oso Cloud.

Où puis-je trouver mon fichier de configuration MCP ?

Voici des guides pour certains clients courants :

Utilisation

[!WARNING]

Ce serveur est principalement destiné à être utilisé avec des serveurs de développement pour faciliter le développement. Veuillez faire preuve d'une prudence accrue lors de son utilisation contre un environnement en direct.

Une fois votre serveur MCP opérationnel, vous pouvez poser à votre LLM toutes les questions liées à l'autorisation et le regarder utiliser les outils disponibles. Actuellement, nous exposons des outils de lecture pour :

  • Obtenir votre politique
  • Obtenir tous les faits
  • Exécuter une requête authorize
  • Interroger vos faits par correspondance de motifs
  • Exécuter des tests de politique

Nous exposons également les outils d'écriture suivants, réservés à une utilisation uniquement avec des serveurs de développement locaux :

  • Mettre à jour votre politique
  • Ajouter des faits
  • Supprimer des faits
  • Effacer toutes les données

Essayez d'envoyer l'un des messages suivants :

  • Dessine un diagramme mermaid de ma politique d'autorisation
  • Quelles permissions <actor> possède-t-il sur <resource> ?
    • par ex. « Quelles permissions Alice possède-t-elle sur le projet XYZ ? »
  • Pourquoi <actor> n'a-t-il pas la permission de <action> <resource> ?

Retour d'expérience

Nous itérons activement sur l'expérience développeur et apprécierions tous les retours sur le serveur MCP Oso et l'expérience de développement plus large avec Oso Cloud. N'hésitez pas à nous contacter sur Slack !

Cette documentation est construite et hébergée sur Mintlify, une plateforme de documentation pour développeurs.