HAL — MCP-сервер для Claude Code: API-запросы и установка
HAL даёт ИИ-клиенту доступ к HTTP API и умеет создавать инструменты по спецификации OpenAPI. Пригодится, когда агенту нужно обращаться к вашему API из проекта.
claude mcp add hal -- npx -y hal-mcpЧто делает HAL
HAL — MCP-сервер для HTTP-запросов к API: он поддерживает GET, POST, PUT, PATCH, DELETE, OPTIONS и HEAD. По спецификации OpenAPI или Swagger сервер может создавать инструменты для работы с API. Спецификацию можно передать файлом или URL.
Секреты задаются переменными окружения с префиксом HAL_SECRET_, а в запросах используются шаблоны вроде {secrets.api_key}. HAL подставляет значения при выполнении запроса и скрывает их в ответах, заголовках и сообщениях об ошибках. Это требует заранее настроить секреты в окружении.
Для фильтрации запросов предусмотрены списки разрешённых и заблокированных URL. Для интеграции с API по OpenAPI задайте HAL_SWAGGER_FILE; базовый адрес можно указать через HAL_API_BASE_URL. Сервер запускается командой npx -y hal-mcp.
Какие задачи решает
- выполнить HTTP-запрос к API из чата с агентом
- создать инструменты по спецификации OpenAPI
- передать API-ключ в запросе без показа его значения модели
- ограничить доступ к API разрешёнными URL
Примеры запросов агенту
- Получи список задач через HTTP API проекта.
- Создай инструменты по спецификации OpenAPI и вызови метод для получения профиля.
- Отправь запрос к API с ключом из переменной
HAL_SECRET_API_KEY, не показывая его значение.
Как установить HAL
Командой платформы
claude mcp add hal -- npx -y hal-mcpКомандой платформы
codex mcp add hal -- npx -y hal-mcpФайл настроек
{
"mcpServers": {
"hal": {
"command": "npx",
"args": [
"-y",
"hal-mcp"
]
}
}
}Файл настроек
{
"servers": {
"hal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hal-mcp"
]
}
}
}Командой платформы
gemini mcp add hal npx -y hal-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о HAL
Как установить HAL в Claude Code?
Выполните claude mcp add hal -- npx -y hal-mcp. Эта команда добавит MCP-сервер HAL.
Что делает HAL?
HAL позволяет агенту отправлять HTTP-запросы к API. По спецификации OpenAPI или Swagger он также создаёт инструменты для вызова методов API.
Как HAL использует секреты API?
Задайте секреты в переменных окружения с префиксом HAL_SECRET_ и ссылайтесь на них в запросах через шаблоны {secrets.key}. Значения подставляются при запросе и скрываются в ответах, которые получает агент.
