# Amvera`s MCP server

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

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

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

Amvera`s MCP server это удаленный Model Context Protocol сервер, развернутые для каждого доступного региона платформы, с авторизацией при помощи Bearer токена, на транспорте [Streamable HTTP](https://modelcontextprotocol.io/specification/draft/basic/transports/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 серверу можно посмотреть в их [документации](https://code.claude.com/docs/en/mcp).

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

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

Пример для Варшавы:
```
"mcpServers": {
  "amvera-warsaw": {
    "type": "http",
    "url": "https://openmcp.waw0.amvera.ru/mcp",
    "headers": {
      "Authorization": "Bearer <access_token>"
    }
  }
}
```