mastyf.ai — MCP-сервер для Claude Code: функции и установка
Перехватывает вызовы инструментов MCP и проверяет их по политикам безопасности. Нужен, чтобы ограничивать действия агента и вести аудит.
claude mcp add --env MASTYF_AI_DB_PATH=<MASTYF_AI_DB_PATH> --env ALERT_WEBHOOK_URL=<ALERT_WEBHOOK_URL> --env METRICS_ENABLED=<METRICS_ENABLED> --transport stdio mastyfai -- npx -y @mastyf_ai/serverЧто делает mastyf.ai
mastyf.ai работает как локальный шлюз между ИИ-агентом и MCP-инструментами: проверяет предлагаемые вызовы и блокирует те, что не разрешены политикой. В числе описанных угроз — инъекции в аргументах инструментов, доступ к секретам, опасные команды оболочки и чрезмерные расходы на токены.
При первом запуске шлюз обнаруживает локальные MCP-серверы и инструменты, затем предлагает задать разрешения обычным языком. Политику можно подготовить, посмотреть разницу с активной и включить; вызовы также попадают в журнал, целостность которого проверяет команда mastyf audit verify.
Для запуска Python-шлюза нужны Git и Python-пакет из репозитория. Отдельно доступен MCP-сервер через npx -y @mastyf_ai/server; команда установки для Claude Code требует ALERT_WEBHOOK_URL.
Какие задачи решает
- перехватить вызовы MCP-инструментов до их выполнения
- запретить агенту доступ к секретам и опасным командам
- задать разрешённые действия обычным языком
- проверить целостность журнала выполнений
Примеры запросов агенту
- Запрети агенту удалять файлы и выполнять HTTP-запросы.
- Проверь вызовы MCP-инструментов на попытки прочитать секреты.
- Покажи разницу между подготовленной и активной политикой.
Как установить mastyf.ai
Командой платформы
claude mcp add --env MASTYF_AI_DB_PATH=<MASTYF_AI_DB_PATH> --env ALERT_WEBHOOK_URL=<ALERT_WEBHOOK_URL> --env METRICS_ENABLED=<METRICS_ENABLED> --transport stdio mastyfai -- npx -y @mastyf_ai/serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add mastyfai --env MASTYF_AI_DB_PATH=<MASTYF_AI_DB_PATH> --env ALERT_WEBHOOK_URL=<ALERT_WEBHOOK_URL> --env METRICS_ENABLED=<METRICS_ENABLED> -- npx -y @mastyf_ai/serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mastyfai": {
"command": "npx",
"args": [
"-y",
"@mastyf_ai/server"
],
"env": {
"MASTYF_AI_DB_PATH": "<MASTYF_AI_DB_PATH>",
"ALERT_WEBHOOK_URL": "<ALERT_WEBHOOK_URL>",
"METRICS_ENABLED": "<METRICS_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mastyfai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mastyf_ai/server"
],
"env": {
"MASTYF_AI_DB_PATH": "<MASTYF_AI_DB_PATH>",
"ALERT_WEBHOOK_URL": "<ALERT_WEBHOOK_URL>",
"METRICS_ENABLED": "<METRICS_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MASTYF_AI_DB_PATH=<MASTYF_AI_DB_PATH> -e ALERT_WEBHOOK_URL=<ALERT_WEBHOOK_URL> -e METRICS_ENABLED=<METRICS_ENABLED> mastyfai npx -y @mastyf_ai/serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mastyf.ai
Как установить mastyf.ai в Claude Code?
Выполните claude mcp add mastyf-ai -e ALERT_WEBHOOK_URL=<ALERT_WEBHOOK_URL> -- npx -y @mastyf_ai/server. Замените плейсхолдер адресом вебхука оповещений.
Что делает mastyf.ai?
Сервер проверяет вызовы MCP-инструментов по политикам и блокирует запрещённые действия. Он также ведёт проверяемый журнал выполнений.
Как mastyf.ai настраивает разрешения при первом запуске?
Он обнаруживает локальные MCP-серверы и инструменты, предлагает описать разрешения обычным языком и показывает изменения политики перед её активацией.
