Labsco
growthbook logo

Oso Cloud MCP Server

from growthbook

Understand, develop, and debug authorization policies in Oso Cloud.

πŸ”₯πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeQuick setup

Oso MCP Server

Integrate your local LLM setup with Oso Cloud APIs via our MCP server.

Use the MCP Server to:

  • develop a better understanding of your policy

  • use natural language to ask authorization-related questions

  • debug why an authorization decision does not match what you expect

This guide assumes you have already installed and set up the CLI .

Connect

Claude Desktop (DXT)

Don't have the CLI installed or don't want to manually add the configuration? No worries - download the following DXT file and double-click to automatically install the Oso MCP Server into Claude Desktop or other AI clients that accept DXTs.

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

Verify the SHA256 checksum:

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

You may also specify the DXT version:

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

Note: There are no DXT versions <0.33.0

The following installation methods assume you have already installed and set up the CLI (version >=0.33.0).

Cursor

Manual

In your LLM client of choice, add the following to your MCP config file to run it against a local dev server:

{
 "mcpServers": {
 "oso": {
 "command": "oso-cloud",
 "args": ["experimental", "mcp"],
 "env": {
 "OSO_URL": "http://localhost:8080",
 "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
 }
 }
 }
}
  • You may optionally omit the OSO_URL environment variable or set it to https://cloud.osohq.com if you want to run it against a live production server.

  • The provided OSO_AUTH token is for the local dev server. You can obtain your live server OSO_AUTH token from the Oso Cloud UI.

Where can I find my MCP config file?

Here are guides for some common clients:

Feedback

We are actively iterating on developer experience and would appreciate all feedback on the Oso MCP Server and the broader development experience with Oso Cloud. Please do not hesitate to reach out on Slack!