OPA MCP — MCP-сервер для Claude Code: Rego и установка
MCP-сервер подключает OPA и Rego к ИИ-клиенту: помогает писать политики, запускать проверки и разбирать причины отказов.
claude mcp add --env OPA_URL=<OPA_URL> --env OPA_TOKEN=<OPA_TOKEN> --env OPA_BINARY=<OPA_BINARY> --env REGAL_BINARY=<REGAL_BINARY> --env CONFTEST_BINARY=<CONFTEST_BINARY> --transport stdio opa-mcp -- npx -y @orygn/opa-mcpЧто делает OPA MCP
OPA MCP даёт агенту структурированные инструменты для работы с Rego. Он форматирует и разбирает политики через opa, запускает запросы с трассировкой, профилированием и покрытием, объясняет решения и показывает правила, повлиявшие на отказ.
Сервер также умеет проверять код через regal, управлять политиками работающего OPA через REST API, собирать .tar.gz-бандлы и создавать заготовки тестов. Для подключения используется npx и пакет @orygn/opa-mcp; при работе со встроенным OPA требуется Node.js 22 или новее.
Какие задачи решает
- написать и отформатировать политику Rego
- проверить запрос на данных и входном документе
- разобрать причину отказа по сработавшим правилам
- проверить каталог политик через
regal - собрать подписанный
.tar.gz-бандл
Примеры запросов агенту
- Проверь эту политику Rego и объясни, почему запрос получает отказ.
- Запусти проверку политики с трассировкой и покрытием строк.
- Собери политики из этой директории в
.tar.gz-бандл.
Как установить OPA MCP
Командой платформы
claude mcp add --env OPA_URL=<OPA_URL> --env OPA_TOKEN=<OPA_TOKEN> --env OPA_BINARY=<OPA_BINARY> --env REGAL_BINARY=<REGAL_BINARY> --env CONFTEST_BINARY=<CONFTEST_BINARY> --transport stdio opa-mcp -- npx -y @orygn/opa-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add opa-mcp --env OPA_URL=<OPA_URL> --env OPA_TOKEN=<OPA_TOKEN> --env OPA_BINARY=<OPA_BINARY> --env REGAL_BINARY=<REGAL_BINARY> --env CONFTEST_BINARY=<CONFTEST_BINARY> -- npx -y @orygn/opa-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"opa-mcp": {
"command": "npx",
"args": [
"-y",
"@orygn/opa-mcp"
],
"env": {
"OPA_URL": "<OPA_URL>",
"OPA_TOKEN": "<OPA_TOKEN>",
"OPA_BINARY": "<OPA_BINARY>",
"REGAL_BINARY": "<REGAL_BINARY>",
"CONFTEST_BINARY": "<CONFTEST_BINARY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"opa-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@orygn/opa-mcp"
],
"env": {
"OPA_URL": "<OPA_URL>",
"OPA_TOKEN": "<OPA_TOKEN>",
"OPA_BINARY": "<OPA_BINARY>",
"REGAL_BINARY": "<REGAL_BINARY>",
"CONFTEST_BINARY": "<CONFTEST_BINARY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e OPA_URL=<OPA_URL> -e OPA_TOKEN=<OPA_TOKEN> -e OPA_BINARY=<OPA_BINARY> -e REGAL_BINARY=<REGAL_BINARY> -e CONFTEST_BINARY=<CONFTEST_BINARY> opa-mcp npx -y @orygn/opa-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о OPA MCP
Как установить OPA MCP в Claude Code?
Выполните claude mcp add opa-mcp -e OPA_TOKEN=<OPA_TOKEN> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @orygn/opa-mcp.
Что делает OPA MCP?
Он подключает инструменты OPA и Rego к MCP-клиенту: позволяет писать, проверять и объяснять политики, а также управлять политиками на работающем OPA.
Что требуется для работы OPA MCP?
Для встроенного OPA нужен Node.js 22 или новее. Для удалённого OPA можно задать OPA_URL и OPA_TOKEN.
