Oso Cloud MCP Server

oficial

Comprende, desarrolla y depura políticas de autorización en Oso Cloud.

¿Qué puedes hacer con Oso Cloud MCP?

  • Inspecciona tu política — Pide al asistente que recupere tu política de autorización actual para que puedas revisar cómo está estructurada.
  • Revisa los hechos almacenados — Haz que el asistente enumere todos los hechos en tus datos de Oso Cloud para ver qué relaciones y atributos existen.
  • Ejecuta comprobaciones de autorización — Pregunta si un actor tiene un permiso determinado sobre un recurso y obtén la decisión resultante.
  • Consulta hechos por patrón — Pide al asistente que busque en tus hechos mediante coincidencia de patrones para encontrar relaciones específicas.
  • Depura decisiones inesperadas — Pregunta por qué un actor carece de permiso para una acción sobre un recurso para rastrear la causa.
  • Ejecuta pruebas de política — Haz que el asistente ejecute tus pruebas de política para comprobar el comportamiento frente a las expectativas.
  • Edita la política y los datos en servidores de desarrollo — Actualiza la política, añade o elimina hechos, o borra datos cuando estés conectado a un servidor de desarrollo local.

Documentación

Servidor MCP de Oso

Integra tu configuración local de LLM con las API de Oso Cloud a través de nuestro servidor MCP.

Usa el Servidor MCP para:

  • desarrollar una mejor comprensión de tu política
  • usar lenguaje natural para hacer preguntas relacionadas con la autorización
  • depurar por qué una decisión de autorización no coincide con lo que esperas

[!WARNING]

Esta guía asume que ya has instalado y configurado la CLI.

Conexión

Claude Desktop (DXT)

¿No tienes la CLI instalada o no quieres añadir la configuración manualmente? No te preocupes: descarga el siguiente archivo DXT y haz doble clic para instalar automáticamente el Servidor MCP de Oso en Claude Desktop u otros clientes de IA que acepten DXT.

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

Verifica la suma de comprobación 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

También puedes especificar la versión del DXT:

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

Nota: No hay versiones de DXT <0.33.0

Los siguientes métodos de instalación asumen que ya has instalado y configurado la CLI (versión >=0.33.0).

Cursor

Install MCP Server

Manual

En tu cliente de LLM preferido, añade lo siguiente a tu archivo de configuración de MCP para ejecutarlo contra un servidor de desarrollo local:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • Opcionalmente, puedes omitir la variable de entorno OSO_URL o establecerla en https://cloud.osohq.com si quieres ejecutarlo contra un servidor de producción en vivo.
  • El token OSO_AUTH proporcionado es para el servidor de desarrollo local. Puedes obtener tu token OSO_AUTH del servidor en vivo desde la interfaz de Oso Cloud.

¿Dónde puedo encontrar mi archivo de configuración de MCP?

Aquí tienes guías para algunos clientes comunes:

Uso

[!WARNING]

Este servidor está pensado principalmente para usarse con servidores de desarrollo como ayuda al desarrollo. Ten especial cuidado al usarlo contra un entorno en vivo.

Una vez que tu servidor MCP esté en funcionamiento, puedes hacer a tu LLM cualquier pregunta relacionada con la autorización y ver cómo utiliza las herramientas disponibles. Actualmente, exponemos herramientas de lectura para:

  • Obtener tu política
  • Obtener todos los hechos
  • Ejecutar una consulta authorize
  • Consultar tus hechos con coincidencia de patrones
  • Ejecutar pruebas de política

También exponemos las siguientes herramientas de escritura, restringidas para su uso únicamente con servidores de desarrollo locales:

  • Actualizar tu política
  • Añadir hechos
  • Eliminar hechos
  • Borrar todos los datos

Prueba a enviar cualquiera de los siguientes mensajes:

  • Dibuja un diagrama de mermaid de mi política de autorización
  • ¿Qué permisos tiene <actor> sobre <resource>?
    • p. ej. "¿Qué permisos tiene Alice sobre Project XYZ?"
  • ¿Por qué <actor> no tiene permiso para <action> <resource>?

Comentarios

Estamos iterando activamente en la experiencia del desarrollador y agradeceríamos todos los comentarios sobre el Servidor MCP de Oso y la experiencia de desarrollo en general con Oso Cloud. ¡No dudes en contactarnos en Slack!

Esta documentación está creada y alojada en Mintlify, una plataforma de documentación para desarrolladores.