# Aiven MCP

Подключает AI-ассистента к сервисам Aiven: PostgreSQL, Apache Kafka, приложениям и другим ресурсам. Подходит для управления ими из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Автор: Aiven-Open
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Aiven-Open/mcp-aiven
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/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` и отдельный список разрешённых операций записи. Сервер может передавать агенту учётные данные сервисов, поэтому команды с изменением или удалением стоит проверять перед выполнением.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}`
- Переменные окружения: `AIVEN_TOKEN`, `AIVEN_READ_ONLY`, `AIVEN_SERVICES_SCOPE`, `AIVEN_ALLOW_SECRETS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
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. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'
```

### Codex

1. **Командой платформы**
```bash
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. **Командой платформы: удалённый сервер**
```bash
codex mcp add aiven-mcp --url 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'
```

### Cursor

1. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aiven-mcp": {
            "url": "https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}"
        }
    }
}
```

### GitHub Copilot

1. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "aiven-mcp": {
            "type": "http",
            "url": "https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}"
        }
    }
}
```

### Gemini CLI

1. **Командой платформы**
```bash
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. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http aiven-mcp 'https://mcp.aiven.live/mcp?read_only={read_only}&services_scope={services_scope}&allow_secrets={allow_secrets}'
```

## Когда брать
- создать сервис PostgreSQL в Aiven
- управлять топиками Apache Kafka
- разворачивать приложения через Aiven
- просматривать проекты и сервисы Aiven
- ограничить агенту операции записи

## Примеры запросов агенту
- Создай сервис PostgreSQL в проекте Aiven и покажи его параметры.
- Покажи топики Apache Kafka и создай новый топик с нужными настройками.
- Работай в режиме только чтения и перечисли доступные сервисы Aiven.

## Похожие
- [Scalix Cloud](https://affpapa.org/nevibecode/mcp/scalix-cloud.md) — MCP-сервер · ★ 2
- [gcp-expert](https://affpapa.org/nevibecode/skills/gcp-expert.md) — скилл · 547 установок
- [mcp-neo4j-aura-manager](https://affpapa.org/nevibecode/mcp/mcp-neo4j-aura-manager.md) — MCP-сервер · ★ 989
- [gcs](https://affpapa.org/nevibecode/mcp/gcs.md) — MCP-сервер · ★ 81
- [huawei-cloud-find-skills](https://affpapa.org/nevibecode/skills/huawei-cloud-find-skills.md) — скилл · 17200 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
