API ВЕГА
English

Server4Agent

Серверы для проектов, которые создаёт ваш AI-ассистент. Он пишет и запускает код, а затем публикует каждое приложение по общедоступному URL.

Server4Agent — это удалённый MCP-сервер. Подключите его к своему AI-ассистенту и попросите создать веб-страницу, сайт, приложение, API, бота или задачу по расписанию. Ассистент получает сервер для работы, пишет и запускает на нём код, а затем публикует каждый проект по отдельному URL. Процессы продолжают работать и после завершения диалога, поэтому бэкенды и боты остаются доступными.

Ничего не нужно устанавливать или запускать на своём устройстве. Сервер размещён по адресу https://mcp.server4agent.com, а в этом репозитории находится его запись в MCP Registry.

Подключение

  • Адрес: https://mcp.server4agent.com

  • Транспорт: streamable HTTP

  • Вход: OAuth 2.1 с динамической регистрацией клиента или API key, передаваемый как bearer-токен

Для работы потребуется аккаунт Server4Agent: https://www.server4agent.com

VS Code и GitHub Copilot

Установите Server4Agent из галереи MCP-серверов в разделе Extensions (найдите @mcp Server4Agent) или добавьте его в .vscode/mcp.json:

{
  "servers": {
    "server4agent": {
      "type": "http",
      "url": "https://mcp.server4agent.com"
    }
  }
}

Запустите сервер — VS Code откроет браузер для входа. Ключ копировать не нужно, а доступ можно отозвать в панели управления. После этого инструменты станут доступны в Copilot Chat в режиме агента.

GitHub Copilot CLI

Создайте API key в панели управления, задайте его в переменной SERVER4AGENT_API_KEY и добавьте сервер в ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "server4agent": {
      "type": "http",
      "url": "https://mcp.server4agent.com",
      "headers": { "Authorization": "Bearer ${SERVER4AGENT_API_KEY}" }
    }
  }
}

Другие MCP-хосты

Добавьте https://mcp.server4agent.com как удалённый MCP-сервер. Если хост поддерживает OAuth, он откроет браузер для входа — больше ничего настраивать не потребуется. Для хоста без поддержки OAuth или для CI передавайте API key в заголовке Authorization: Bearer и храните ключ в переменной окружения, а не в конфигурационном файле, который попадёт в репозиторий.

Инструкции по настройке в других приложениях: https://www.server4agent.com/integrations

Использование

Формулируйте запросы обычным языком. Например:

  • «Создай целевую страницу для моей пекарни и опубликуй её в интернете».

  • «Создай API, которое преобразует загруженный CSV-файл в JSON, и сообщи мне URL».

  • «Проверяй наш сайт каждый час и записывай, когда он недоступен».

  • «Что запущено на моих серверах и сколько я потратил в этом месяце?»

Как всё устроено:

  • Сервер — это вычислительная среда выбранного размера: малая, средняя или большая. В ней размещаются проекты. На одном сервере может находиться несколько проектов.

  • Проект — это папка с приложением на сервере и собственными адресом и URL на домене .apps.server4agent.com. По умолчанию проекты закрыты; публичными они становятся после вызова deploy.

  • Ассистент может самостоятельно создавать файлы или передать задачу агенту, работающему на сервере (start_build, prompt). Такой агент расходует бюджет AI аккаунта.

  • Инструменты, которые удаляют данные или перезаписывают их, помечены как разрушающие. Хост может запросить подтверждение перед их запуском.

Инструменты

Всего доступно 38 инструментов. [read-only] — только чтение, без записи; [destructive] — инструмент может удалить или перезаписать данные.

Серверы

Сервер — это вычислительная среда выбранного размера. Проекты размещаются на ней и используют её ресурсы совместно.

  • create_server: Создать сервер выбранного размера.

  • list_servers [read-only]: Показать список серверов с указанием их уровня, типа, статуса, параметров совместного доступа к проектам и текущего количества проектов.

  • get_server [read-only]: Получить сведения об уровне, типе, статусе, ёмкости сервера, количестве проектов и параметрах совместного доступа к ним.

  • update_server [destructive]: Изменить название сервера, регион или доступ проектов друг к другу.

  • control_server [destructive]: Приостановить сервер (stop), возобновить его работу (start) или перезагрузить (restart).

  • delete_server [destructive]: Удалить сервер и все размещённые на нём проекты.

  • get_usage [read-only]: Получить сведения о расходах и бюджете AI аккаунта: сколько потрачено в текущем расчётном периоде, сколько кредитов включено в план, установлен ли лимит бюджета и заблокирован ли запуск новых задач (с указанием причины).

Проекты

Проект — это рабочая область с приложением на сервере, а также собственными идентификатором и URL. Новые проекты закрыты: URL начинает работать только после открытия доступа.

  • list_templates [read-only]: Показать доступные шаблоны для создания проектов.

  • create_project: Создать на сервере проект — основу для одной веб-страницы, сайта, приложения, API или бота с собственным URL на домене <slug>.apps.server4agent.com.

  • list_projects [read-only]: Показать список проектов.

  • get_project [read-only]: Получить сведения об отдельном проекте: название, идентификатор, описание, публичный URL, порт прослушивания, план запуска и временные метки.

  • update_project [destructive]: Переименовать проект, изменить его описание, видимость, доступ по ссылке или жизненный цикл, а также скорректировать план запуска.

  • init_project: Запустить или возобновить подготовку проекта, созданного из источника Git или архива: агент на сервере устанавливает зависимости, запускает приложение и проверяет, что оно отвечает на запросы.

  • export_project: Упаковать проект в переносимый архив и предоставить временную ссылку для скачивания.

  • import_project: Восстановить на сервере проект из архива, созданного с помощью export_project, в этой или другой среде Server4Agent.

  • cleanup_project [destructive]: Удалить временный проект после завершения задачи.

  • delete_project [destructive]: Удалить проект.

Секреты

Переменные окружения для серверов и проектов. Значения доступны только для записи: ни один инструмент не может прочитать их обратно.

  • set_secret [destructive]: Создать или обновить секрет на уровне аккаунта — переменную окружения в формате «ключ → значение».

  • list_secrets [read-only]: Показать секреты аккаунта: ключи, заметки и сведения о том, к каким объектам они привязаны — серверам или проектам.

  • attach_secret [destructive]: Привязать секрет к области действия, чтобы запуски в этой области могли использовать его как переменную окружения.

  • delete_secret [destructive]: Удалить секрет и все его привязки.

Среда выполнения агента

Запускайте приложение и поддерживайте его работу, поручайте задачи агенту на сервере или выполняйте команды в оболочке самостоятельно.

  • start_app [destructive]: Запустить приложение проекта и поддерживать его работу. Это шаг, который публикует проект после создания файлов.

  • prompt: Передать произвольный запрос агенту на сервере.

  • exec [destructive]: Выполнить команду оболочки на сервере и получить её результат.

  • get_run [read-only]: Получить статус запуска, последнюю заметку о ходе работы, итоговый ответ агента и сведения об изменениях в рабочей области — коммите, ветке и файлах.

  • get_logs [read-only]: Получить последние записи журналов сервера: по одной записи для каждого файла журналов, в который писали процессы проекта. Каждый длительно работающий процесс добавляет записи в файл .server4agent/<name>.log в папке проекта.

Файловая рабочая область

Работайте с файлами проекта напрямую, если помощь агента не требуется.

  • list_files [read-only]: Показать пути к файлам в рабочей области сервера.

  • read_file [read-only]: Прочитать файл из рабочей области сервера.

  • write_file [destructive]: Записать или перезаписать файл в рабочей области сервера.

  • delete_file [destructive]: Удалить файл из рабочей области сервера.

  • get_download_url: Создать временную ссылку для скачивания файла из рабочей области сервера. Например, после создания отчёта или преобразования файла можно передать пользователю эту ссылку вместо самого содержимого.

Сборка и публикация

Агент выполняет сборку по заданной цели, а deploy публикует работающий проект.

  • start_build: Поручить агенту на сервере создать веб-страницу, сайт, приложение или API по запросу на обычном языке.

  • get_build [read-only]: Получить статус сборки.

  • deploy: Опубликовать проект по общедоступному URL на домене <slug>.apps.server4agent.com. Это последний шаг перед запуском веб-страницы, сайта, приложения или API в интернете.

Автонастройка

Передайте агенту отчёт об оценке, чтобы он исправил найденные проблемы в собственном коде.

  • start_tuning: Исправить агента на основе отчёта платформы оценки.

  • get_tuning_session: Получить статус настройки и сведения о запуске агента, связанном с ней.

  • list_tuning_sessions [read-only]: Показать запуски настройки в аккаунте, начиная с самых новых.

  • report_tuning_result: Сообщить платформе оценки, что изменил запуск настройки и где доступна исправленная сборка.

Аргументы всех инструментов и примеры их использования приведены в Agent Skill по адресу

https://www.server4agent.com/skill.md, а также в JSON-схеме каждого инструмента после подключения.

Ссылки