Oso Cloud MCP Server

Servidor MCP de Oso

Integra tu configuración local de LLM con las APIs 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

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

Conectar

Claude Desktop (DXT)

¿No tienes la CLI instalada o no quieres añadir manualmente la configuración? 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 DXTs.

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

Manual

En tu cliente LLM de preferencia, añade lo siguiente a tu archivo de configuración 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 deseas 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 usuario de Oso Cloud.

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

Aquí hay guías para algunos clientes comunes:

• Claude Desktop
• Cursor
• VS Code Copilot
• Kiro

Uso

Este servidor está destinado principalmente para usarse con servidores de desarrollo para ayudar en el desarrollo. Ten mucho cuidado al usarlo contra un entorno en vivo.

Una vez que tengas tu servidor MCP en funcionamiento, puedes hacerle a tu LLM cualquier pregunta relacionada con la autorización y observar cómo usa 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 usarse solo con servidores de desarrollo locales:

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

Intenta 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 el Proyecto 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 más amplia con Oso Cloud. ¡No dudes en contactarnos en Slack!