Aiven MCP — MCP-сервер для Claude Code: установка
Подключает AI-ассистента к сервисам Aiven: PostgreSQL, Apache Kafka, приложениям и другим ресурсам. Подходит для управления ими из чата.
claude mcp add --env AIVEN_TOKEN=<AIVEN_TOKEN> --env AIVEN_READ_ONLY=<AIVEN_READ_ONLY> --env AIVEN_SERVICES_SCOPE=<AIVEN_SERVICES_SCOPE> --env AIVEN_ALLOW_SECRETS=<AIVEN_ALLOW_SECRETS> --transport stdio aiven-mcp -- npx -y mcp-aivenЧто делает Aiven MCP
Aiven MCP даёт ассистенту доступ к управлению сервисами Aiven. Через него можно работать с PostgreSQL, Apache Kafka и приложениями, а также создавать, изменять и удалять сервисы и данные. Права ограничены разрешениями учётной записи Aiven.
Есть удалённое подключение через https://mcp.aiven.live/mcp с авторизацией в Aiven и локальный режим через npx -y mcp-aiven. Для локального stdio-варианта нужен Node.js 18+ и токен в AIVEN_TOKEN. Без AIVEN_TOKEN локальный сервер не запустится.
Удалённый режим поддерживает только чтение через read_only=true, ограничение набора инструментов по services_scope и отдельный список разрешённых операций записи. Сервер может передавать агенту учётные данные сервисов, поэтому команды с изменением или удалением стоит проверять перед выполнением.
Какие задачи решает
- создать сервис PostgreSQL в Aiven
- управлять топиками Apache Kafka
- разворачивать приложения через Aiven
- просматривать проекты и сервисы Aiven
- ограничить агенту операции записи
Примеры запросов агенту
- Создай сервис PostgreSQL в проекте Aiven и покажи его параметры.
- Покажи топики Apache Kafka и создай новый топик с нужными настройками.
- Работай в режиме только чтения и перечисли доступные сервисы Aiven.
Как установить Aiven MCP
1Командой платформы
claude mcp add --env AIVEN_TOKEN=<AIVEN_TOKEN> --env AIVEN_READ_ONLY=<AIVEN_READ_ONLY> --env AIVEN_SERVICES_SCOPE=<AIVEN_SERVICES_SCOPE> --env AIVEN_ALLOW_SECRETS=<AIVEN_ALLOW_SECRETS> --transport stdio aiven-mcp -- npx -y mcp-aivenВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http mcp 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'1Командой платформы
codex mcp add aiven-mcp --env AIVEN_TOKEN=<AIVEN_TOKEN> --env AIVEN_READ_ONLY=<AIVEN_READ_ONLY> --env AIVEN_SERVICES_SCOPE=<AIVEN_SERVICES_SCOPE> --env AIVEN_ALLOW_SECRETS=<AIVEN_ALLOW_SECRETS> -- npx -y mcp-aivenВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
codex mcp add aiven-mcp --url 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'1Файл настроек
{
"mcpServers": {
"aiven-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-aiven"
],
"env": {
"AIVEN_TOKEN": "<AIVEN_TOKEN>",
"AIVEN_READ_ONLY": "<AIVEN_READ_ONLY>",
"AIVEN_SERVICES_SCOPE": "<AIVEN_SERVICES_SCOPE>",
"AIVEN_ALLOW_SECRETS": "<AIVEN_ALLOW_SECRETS>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"mcpServers": {
"aiven-mcp": {
"url": "https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}"
}
}
}1Файл настроек
{
"servers": {
"aiven-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-aiven"
],
"env": {
"AIVEN_TOKEN": "<AIVEN_TOKEN>",
"AIVEN_READ_ONLY": "<AIVEN_READ_ONLY>",
"AIVEN_SERVICES_SCOPE": "<AIVEN_SERVICES_SCOPE>",
"AIVEN_ALLOW_SECRETS": "<AIVEN_ALLOW_SECRETS>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"servers": {
"aiven-mcp": {
"type": "http",
"url": "https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}"
}
}
}1Командой платформы
gemini mcp add -e AIVEN_TOKEN=<AIVEN_TOKEN> -e AIVEN_READ_ONLY=<AIVEN_READ_ONLY> -e AIVEN_SERVICES_SCOPE=<AIVEN_SERVICES_SCOPE> -e AIVEN_ALLOW_SECRETS=<AIVEN_ALLOW_SECRETS> aiven-mcp npx -y mcp-aivenВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
gemini mcp add -t http aiven-mcp 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Aiven MCP
Как установить Aiven MCP в Claude Code?
Для локального подключения выполните `claude mcp add --env AIVEN_TOKEN=<AIVEN_TOKEN> --env AIVEN_READ_ONLY=<AIVEN_READ_ONLY> --env AIVEN_SERVICES_SCOPE=<AIVEN_SERVICES_SCOPE> --env AIVEN_ALLOW_SECRETS=<AIVEN_ALLOW_SECRETS> --transport stdio aiven-mcp -- npx -y mcp-aiven`.
Что делает Aiven MCP?
Сервер связывает AI-ассистента с Aiven и позволяет управлять PostgreSQL, Apache Kafka, приложениями и другими сервисами. Агент может выполнять операции, разрешённые аккаунту Aiven.
Как ограничить действия Aiven MCP?
Параметр read_only=true отключает операции записи. Для отдельных исключений используется write_allowlist, а services_scope ограничивает набор сервисов и инструментов.
