Install
claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp?read_only=true"Para quem
Se quiser gerir PostgreSQL, Apache Kafka, aplicações e outros serviços na Aiven a partir de um assistente, o mcp-aiven serve. Os assistentes nomeados oficialmente são Claude, Cursor e VS Code Copilot.
Serve a quem já tem uma conta Aiven e consegue terminar a autorização do navegador. Entrada alojada:
https://mcp.aiven.live/mcp
Repositório:
https://github.com/Aiven-Open/mcp-aiven
Este serviço pode criar, alterar e apagar serviços e dados Aiven em seu nome. O assistente pode executar ações destrutivas segundo o que entender (apagar uma base, apagar um serviço, produzir mensagens para Kafka). A responsabilidade é sua. A primeira tentativa tem de ser de só leitura.
Primeira tentativa em 3 minutos
O caminho oficial principal é HTTP alojado; não configure primeiro um token local. Pré-requisitos: uma sessão de navegador já iniciada na Aiven. O cliente pedirá autorização. O modo de só leitura retira todas as escritas do MCP. URL de só leitura:
https://mcp.aiven.live/mcp?read_only=true
A instalação é um MCP de utilizador no Claude Code. A primeira adição usa o URL de só leitura (mantenha o transporte e o nome do comando oficial, só troque o URL de só leitura oficial):
claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp?read_only=true"
Após autorizar, faça de imediato uma chamada real com evidência, não só verifique que o ponto responde: peça ao assistente que consulte os serviços PostgreSQL existentes na sua conta (a capacidade oficial é gerir PostgreSQL). O excerto não dá nomes de função de ferramentas; não grite um list_* inventado. Pergunte em termos de «serviços PostgreSQL» e deixe as ferramentas de só leitura registadas devolverem informação do serviço.
Sinal observável: o assistente nomeia pelo menos um projeto ou um nome/estado de serviço PostgreSQL, ou diz com clareza que a conta não tem. Se só vir «ligado» sem resultado de consulta de serviço, esta tentativa não terminou.
Casos de uso
Caso 1: ver serviços PostgreSQL. A capacidade é gerir Aiven PostgreSQL diretamente. Sob read_only=true, deixe o assistente ler nomes de instância, estado ou informação de ligação de só leitura. O oficial não escreve uma tabela de campos. Não faça drop de uma base.
Caso 2: ver serviços Apache Kafka. A capacidade é gerir Kafka. Consulte igual o estado do cluster ou do serviço em só leitura. A escrita perigosa nomeada oficialmente é producing messages; em só leitura as escritas devem ficar de fora, e mesmo assim não peça para produzir mensagens nem apagar serviços.
applications e outros serviços Aiven também são nomeados como geríveis; não passe à escrita na primeira tentativa.
Limites de uso
A alternativa local é npx -y mcp-aiven em Node.js 18+, com AIVEN_TOKEN. Não é o caminho principal da primeira tentativa. Não cole valores de token de exemplo da documentação.
O URL alojado completo também pode omitir o parâmetro de só leitura, mas então registam-se ferramentas de escrita. O acesso segue o utilizador Aiven autorizado. Não há fornecedores de nuvem fora dos serviços nomeados.
read_only=true não é risco zero: continua a ler os seus projetos na nuvem e a autorização abre a Aiven. Não invente nomes de ferramentas que não apareçam.