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
Вручную
В клиенте 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, платформе документации для разработчиков.