Computer-Use Agents API — MCP-сервер для Claude Code: что делает
Подключает агентов H Company к любому MCP-клиенту: агент сам ходит по сайтам и возвращает готовый ответ. Пригодится, когда нужно вытащить данные со страниц без своего парсера.
claude mcp add --transport http computer-use-agents-api https://agp.hcompany.ai/mcpЧто делает Computer-Use Agents API
Сервер даёт доступ к Agents API от H Company. Запускаете агента вроде h/web-surfer-pro — у него свой браузер — и описываете задачу обычным текстом. Сессия проходит состояния pending, running, а затем одно из финальных: completed, idle, failed, timed_out или interrupted.
Работать можно двумя способами. run_session создаёт сессию и ждёт до конца, это для задач в один заход. start_session сразу отдаёт handle: пока агент работает, видно его шаги, можно отправить уточнение через send_message, поставить на паузу, заставить ответить тем, что уже собрано, или отменить. Если задать idle_timeout_s, сессия после ответа уходит в idle и ждёт следующего сообщения, сохраняя контекст и состояние браузера. Структурированный ответ задаётся pydantic-моделью в answer_schema; несовпадение с ней поднимает AnswerValidationError.
Для локального запуска есть Client.local() — агент работает на вашей машине через локальный рантайм, а десктопом в один момент управляет только один агент: второй процесс с мостом desktop или workstation сразу упадёт, а не начнёт делить мышь. Инференс всё равно остаётся хостед, если не передать inference=Inference.self_hosted(...). Для хостед-режима нужен ключ: переменная HAI_API_KEY или ключ, сохранённый через hai login.
Какие задачи решает
- вытащить данные с сайта, у которого нет API
- прогнать браузерную задачу и получить ответ в виде готовой структуры
- посмотреть, что агент делает по шагам, и вмешаться на ходу
- продолжить диалог с агентом, не теряя состояние браузера
- остановить зависшую сессию и забрать промежуточный результат
Примеры запросов агенту
- Найди три открытые вакансии ML-инженера в Париже и верни их списком
- Запусти агента
h/web-surfer-proи скажи, какие сейчас топовые истории на Hacker News - Приостанови сессию и покажи, сколько шагов агент уже сделал
Как установить Computer-Use Agents API
Командой платформы: удалённый сервер
claude mcp add --transport http computer-use-agents-api https://agp.hcompany.ai/mcpКомандой платформы: удалённый сервер
codex mcp add computer-use-agents-api --url https://agp.hcompany.ai/mcpФайл настроек
{
"mcpServers": {
"computer-use-agents-api": {
"url": "https://agp.hcompany.ai/mcp"
}
}
}Файл настроек
{
"servers": {
"computer-use-agents-api": {
"type": "http",
"url": "https://agp.hcompany.ai/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http computer-use-agents-api https://agp.hcompany.ai/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Computer-Use Agents API
Как установить Computer-Use Agents API в Claude Code?
Одной командой: claude mcp add --transport http computer-use-agents-api https://agp.hcompany.ai/mcp.
Что делает Computer-Use Agents API?
Даёт MCP-клиенту доступ к агентам H Company, которые сами работают в браузере. Вы ставите задачу текстом, а на выходе получаете ответ и историю событий сессии.
Что нужно для работы сервера?
Ключ API: положите его в HAI_API_KEY или сохраните через hai login. Локальный режим дополнительно требует рантайм агента на машине.
