Oso Cloud MCP Server

официальный

Понимайте, разрабатывайте и отлаживайте политики авторизации в Oso Cloud.

Что можно делать с Oso Cloud MCP?

  • Проверьте свою политику — Попросите ассистента получить текущую политику авторизации, чтобы вы могли ознакомиться с её структурой.
  • Просмотрите сохранённые факты — Попросите ассистента перечислить все факты в ваших данных Oso Cloud, чтобы увидеть существующие связи и атрибуты.
  • Выполните проверки авторизации — Спросите, есть ли у субъекта определённое разрешение на ресурс, и получите результат проверки.
  • Найдите факты по шаблону — Попросите ассистента выполнить поиск по фактам с помощью сопоставления с шаблоном, чтобы найти конкретные связи.
  • Разберитесь в неожиданных решениях — Спросите, почему субъекту не разрешено выполнить действие над ресурсом, чтобы выяснить причину.
  • Запустите тесты политики — Попросите ассистента выполнить тесты политики, чтобы проверить её поведение на соответствие ожиданиям.
  • Редактируйте политику и данные на серверах разработки — Обновляйте политику, добавляйте или удаляйте факты либо очищайте данные при подключении к локальному серверу разработки.

Документация

Oso MCP Server

Интегрируйте локальную конфигурацию LLM с API Oso Cloud с помощью нашего MCP-сервера.

Используйте MCP Server, чтобы:

  • лучше разобраться в своей политике
  • задавать вопросы об авторизации на естественном языке
  • выяснять, почему решение об авторизации не соответствует вашим ожиданиям

[!WARNING]

В этом руководстве предполагается, что вы уже установили и настроили CLI.

Подключение

Claude Desktop (DXT)

У вас ещё не установлен CLI или вы не хотите добавлять конфигурацию вручную? Не проблема — скачайте следующий файл DXT и дважды щёлкните по нему, чтобы автоматически установить Oso MCP Server в Claude Desktop или другие AI-клиенты, поддерживающие DXT.

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

Проверьте контрольную сумму 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

Также можно указать версию DXT:

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

Примечание: версий DXT нет <0.33.0

Для следующих способов установки требуется, чтобы вы уже установили и настроили CLI (версия >=0.33.0).

Cursor

Install MCP Server

Вручную

В клиенте LLM по вашему выбору добавьте следующий фрагмент в файл конфигурации MCP, чтобы запустить сервер для локального сервера разработки:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • При желании можно не указывать переменную окружения OSO_URL или задать ей значение https://cloud.osohq.com, чтобы запустить сервер для рабочей среды.
  • Предоставленный токен OSO_AUTH предназначен для локального сервера разработки. Токен OSO_AUTH для рабочего сервера можно получить в интерфейсе Oso Cloud.

Где найти файл конфигурации MCP?

Вот руководства для некоторых популярных клиентов:

Использование

[!WARNING]

Этот сервер предназначен главным образом для использования с серверами разработки и помощи в разработке. Будьте особенно осторожны при работе с рабочей средой.

После запуска MCP-сервера вы можете задавать LLM любые вопросы, связанные с авторизацией, и наблюдать за использованием доступных инструментов. Сейчас доступны инструменты для чтения, позволяющие:

  • Получить политику
  • Получить все факты
  • Выполнить запрос authorize
  • Запрашивать факты с помощью сопоставления с шаблоном
  • Запускать тесты политик

Также доступны следующие инструменты для записи, использование которых ограничено локальными серверами разработки:

  • Обновить политику
  • Добавить факты
  • Удалить факты
  • Очистить все данные

Попробуйте отправить любое из следующих сообщений:

  • Нарисуй диаграмму моей политики авторизации в формате Mermaid
  • Какие разрешения есть у <actor> для <resource>?
    • Например: «Какие разрешения есть у Alice для Project XYZ?»
  • Почему у <actor> нет разрешения на <action> <resource>?

Отзывы

Мы постоянно совершенствуем опыт разработчиков и будем рады любым отзывам об Oso MCP Server и общем опыте разработки с Oso Cloud. Не стесняйтесь связаться с нами в Slack!

Эта документация создана и размещена на Mintlify, платформе документации для разработчиков.