Oso Cloud MCP Server

Servidor MCP Oso

Integre sua configuração local de LLM com as 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 a autorização
• depurar por que uma decisão de autorização não corresponde ao que você espera

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 manualmente a configuração? Sem problemas - baixe o seguinte arquivo DXT e clique duas vezes para instalar automaticamente o Servidor MCP 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 a soma de verificação 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 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 seu cliente LLM de preferência, adicione o seguinte ao seu arquivo de configuração 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 fornecido é 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 MCP?

Aqui estão guias para alguns clientes comuns:

• Claude Desktop
• Cursor
• VS Code Copilot
• Kiro

Uso

Este servidor é destinado principalmente para uso com servidores de desenvolvimento para auxiliar no desenvolvimento. Tenha cuidado extra ao usar em um ambiente ativo.

Depois que seu servidor MCP estiver em execução, você pode fazer qualquer pergunta relacionada a autorização ao seu LLM e vê-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 gravação, restritas para uso apenas com servidores de desenvolvimento local:

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

Tente enviar qualquer uma das seguintes mensagens:

• Desenhe um diagrama mermaid da minha política de autorização
• Quais permissões <actor> tem em <resource>?
  • ex.: "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 agradecemos todo feedback sobre o Servidor MCP Oso e a experiência de desenvolvimento mais ampla com o Oso Cloud. Não hesite em entrar em contato pelo Slack!