Amvera`s MCP server¶

💡 Новый Amvera MCP доступен в Beta для всех пользователей платформы

Технология позволяет подключить tools для деплоя и мониторинга ваших приложений, развернутых нашей платформе, прямо в ваши агентные, RAG системы и чат боты.

Что из себя представляет наш MCP сервер¶

Amvera`s MCP server это удаленный Model Context Protocol сервер, развернутые для каждого доступного региона платформы, с авторизацией при помощи Bearer токена, на транспорте Streamable HTTP.

Его можно интегрировать с популярным AI ассистентами такими как Claude Code, это позволит вам, давать прямой доступ языковой модели на загрузку кода, чтение логов, создание проекта и другим функциям управления.

Можно полностью написать и задеплоить ваше приложение с помощью связки из нашего инференса языковых моделей, mcp сервера и ии-агента.

Регионы¶

На данный момент работает в двух регионах:

https://openmcp.msk0.amvera.ru/mcp - Москва
https://openmcp.waw0.amvera.ru/mcp - Варшава

Доступные Tools¶

Представлен список tools для управления проектами разделенный на категории

CRUD проектов¶

Метод	Описание
listProjects	Получение списка всех проектов пользователя.
getProject	Получение информации о конкретном проекте.
createProject	Создание нового проекта.
deleteProject	Удаление проекта.

Тарифы¶

Метод	Описание
listProjects	Получение списка всех проектов пользователя.
getProject	Получение информации о конкретном проекте.
createProject	Создание нового проекта.
deleteProject	Удаление проекта.

Конфигурация¶

Метод	Описание
listConfigurations	Получение списка доступных конфигураций.
getAmveraConfigTemplate	Получение шаблона конфигурации Amvera.

Файлы¶

Метод	Описание	Примечания
uploadFiles (filePath)	Загрузка файлов по пути.	На Windows может потребоваться корректное указание пути.
uploadFiles (fileText)	Загрузка файлов в виде текста (UTF-8).	Работает без указания filePath.
uploadFiles (fileBase64)	Загрузка файлов в формате Base64.	Поддерживает корректную обработку кириллицы.
downloadFiles (папка/репо)	Скачивание файлов из папки или репозитория в виде ZIP-архива (Base64).
downloadFiles (одиночный файл)	Скачивание одного файла.
listFiles	Получение списка файлов в проекте.
deleteFiles	Удаление файлов.	Требуется указание параметра email.

Коммиты и логи¶

Метод	Описание
getCommitHistory	Получение истории коммитов проекта.
getBuildLogs	Получение логов сборки проекта.
getRunLogs	Получение логов выполнения проекта.
getEventLogs	Получение логов событий проекта.

Управление проектом¶

Метод	Описание	Примечания
rebuildProject	Пересборка проекта.
restartProject	Перезапуск проекта.
stopBuild	Остановка сборки проекта.
scaleProject	Масштабирование проекта.	Ошибка 409, если деплой отсутствует.
freezeProject	Заморозка проекта.

Переменные окружения¶

Метод	Описание
createEnvVars	Создание переменных окружения.
listEnvVars	Получение списка переменных окружения (включая secret и non-secret).
updateEnvVar	Обновление переменной окружения.
deleteEnvVar	Удаление переменной окружения.

Домены¶

Метод	Описание	Примечания
listDomains	Получение списка доменов проекта.
createDomain	Создание нового домена.	Автодомен создаётся при пустом параметре domainName.
deleteDomain	Удаление домена.	Ошибка 403 на default-домене — ожидаемое поведение (серверная логика).

Сессии событий¶

Метод	Описание
registerEventSession	Регистрация сессии событий.

Аутентификация¶

Чтобы использовать Amvera`s MCP server, достаточно получить токен в личном кабинете вашего аккаунта Amvera.

Далее при обращениях, нужно использовать его для каждого запроса, в заголовке Authorization в следующем формате: [Authorization: Bearer <access_token>].

Подключение к Claude Code¶

С помощью команды:¶

Пример для добавления Московского сервера:

claude mcp add --transport http amvera-moscow https://openmcp.msk0.amvera.ru/mcp \
  --header "Authorization: Bearer <access_token>"

Актуальную информацию о том, как подключить Claude к MCP серверу можно посмотреть в их документации.

Редактируя файл настроек агента¶

Также есть более сложный способ, с редактированием файла настроек. Нужно добавить следующие настройки в .claude.json вашего рабочего окружения.

Пример для Варшавы:

"mcpServers": {
  "amvera-warsaw": {
    "type": "http",
    "url": "https://openmcp.waw0.amvera.ru/mcp",
    "headers": {
      "Authorization": "Bearer <access_token>"
    }
  }
}