Oso Cloud MCP Server

oficial

Compreenda, desenvolva e depure políticas de autorização no Oso Cloud.

O que você pode fazer com Oso Cloud MCP?

  • Inspecione sua política — Peça ao assistente para recuperar sua política de autorização atual para que você possa revisar como ela está estruturada.
  • Revise os fatos armazenados — Peça ao assistente para listar todos os fatos nos seus dados do Oso Cloud para ver quais relacionamentos e atributos existem.
  • Execute verificações de autorização — Pergunte se um ator tem uma determinada permissão em um recurso e obtenha a decisão resultante.
  • Consulte fatos por padrão — Peça ao assistente para pesquisar seus fatos usando correspondência de padrões para encontrar relacionamentos específicos.
  • Depure decisões inesperadas — Pergunte por que um ator não tem permissão para uma ação em um recurso para rastrear a causa.
  • Execute testes de política — Peça ao assistente para executar seus testes de política para verificar o comportamento em relação às expectativas.
  • Edite política e dados em servidores de desenvolvimento — Atualize a política, adicione ou exclua fatos ou limpe os dados quando estiver conectado a um servidor de desenvolvimento local.

Documentação

Servidor MCP do Oso

Integre sua configuração local de LLM às APIs do Oso Cloud por meio do nosso servidor MCP.

Use o Servidor MCP para:

  • desenvolver uma melhor compreensão da sua política
  • usar linguagem natural para fazer perguntas relacionadas à autorização
  • depurar por que uma decisão de autorização não corresponde ao que você espera

[!WARNING]

Este guia pressupõe que você já instalou e configurou a CLI.

Conectar

Claude Desktop (DXT)

Não tem a CLI instalada ou não quer adicionar a configuração manualmente? Sem problemas - baixe o seguinte arquivo DXT e clique duas vezes para instalar automaticamente o Servidor MCP do Oso no Claude Desktop ou em outros clientes de IA que aceitam DXTs.

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

Verifique o checksum 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

Você também pode especificar a versão do DXT:

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

Nota: Não há versões de DXT <0.33.0

Os métodos de instalação a seguir pressupõem que você já instalou e configurou a CLI (versão >=0.33.0).

Cursor

Install MCP Server

Manual

No cliente de LLM de sua escolha, adicione o seguinte ao seu arquivo de configuração do MCP para executá-lo em um servidor de desenvolvimento local:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • Você pode, opcionalmente, omitir a variável de ambiente OSO_URL ou defini-la como https://cloud.osohq.com se quiser executá-lo em um servidor de produção ativo.
  • O token OSO_AUTH é para o servidor de desenvolvimento local. Você pode obter seu token OSO_AUTH do servidor ativo na interface do Oso Cloud.

Onde posso encontrar meu arquivo de configuração do MCP?

Aqui estão guias para alguns clientes comuns:

Uso

[!WARNING]

Este servidor destina-se principalmente ao uso com servidores de desenvolvimento para auxiliar no desenvolvimento. Tenha muito cuidado ao usá-lo em um ambiente ativo.

Depois que seu servidor MCP estiver em execução, você pode fazer ao seu LLM qualquer pergunta relacionada à autorização e observá-lo usar as ferramentas disponíveis. Atualmente, expomos ferramentas de leitura para:

  • Obter sua política
  • Obter todos os fatos
  • Executar uma consulta authorize
  • Consultar seus fatos com correspondência de padrões
  • Executar testes de política

Também expomos as seguintes ferramentas de escrita, restritas ao uso apenas com servidores de desenvolvimento locais:

  • Atualizar sua política
  • Adicionar fatos
  • Excluir fatos
  • Limpar todos os dados

Experimente enviar qualquer uma das seguintes mensagens:

  • Desenhe um diagrama mermaid da minha política de autorização
  • Quais permissões <actor> tem em <resource>?
    • por exemplo, "Quais permissões Alice tem no Projeto XYZ?"
  • Por que <actor> não tem permissão para <action> <resource>?

Feedback

Estamos iterando ativamente na experiência do desenvolvedor e agradeceríamos todo feedback sobre o Servidor MCP do Oso e a experiência de desenvolvimento mais ampla com o Oso Cloud. Não hesite em entrar em contato pelo Slack!

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.