Oso Cloud MCP Server
oficialCompreenda, 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
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_URLou defini-la comohttps://cloud.osohq.comse quiser executá-lo em um servidor de produção ativo. - O token
OSO_AUTHé para o servidor de desenvolvimento local. Você pode obter seu tokenOSO_AUTHdo 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.