Aiven 의 PostgreSQL 서비스를 읽기 전용으로 조회하기

누구에게 맞나

도우미에서 Aiven 의 PostgreSQL, Apache Kafka, 애플리케이션 및 다른 서비스를 관리하려면 mcp-aiven 이 맞다. 공식이 이름을 댄 도우미는 Claude, Cursor, VS Code Copilot.

이미 Aiven 계정이 있고 브라우저 인가를 마칠 수 있는 사람에게 맞다. 호스팅 입구:

https://mcp.aiven.live/mcp

저장소:

https://github.com/Aiven-Open/mcp-aiven

이 서비스는 사용자를 대신해 Aiven 서비스와 데이터를 만들고 바꾸고 삭제할 수 있다. 도우미는 이해한 대로 파괴적 동작(데이터베이스 삭제, 서비스 삭제, Kafka 로 메시지 생산)을 할 수 있다. 책임은 사용자. 첫 시도는 반드시 읽기 전용이다.

3 분 만에 첫 시도

공식 주 경로는 호스팅 HTTP 이며 로컬 token 을 먼저 두지 말 것. 전제: Aiven 에 로그인한 브라우저 세션. 클라이언트가 인가를 요청한다. 읽기 전용 모드는 MCP 에서 모든 쓰기를 뺀다. 읽기 전용 주소:

https://mcp.aiven.live/mcp?read_only=true

설치 위치는 Claude Code 의 사용자 수준 MCP. 처음에는 읽기 전용 주소로 추가한다(공식 추가 명령의 전송과 이름은 그대로 두고 공식 읽기 전용 URL 만 바꾼다):

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp?read_only=true"

인가 후 끝점이 통하는지 보는 데 그치지 말고 근거 있는 실제 호출을 바로 한다: 도우미가 계정 아래 기존 PostgreSQL 서비스를 조회하게 한다(공식 능력은 PostgreSQL 관리). 발췌는 도구 함수 이름을 주지 않으므로 만든 list_* 를 외치지 말 것. 「PostgreSQL 서비스」로 묻고 등록된 읽기 전용 도구가 서비스 정보를 반환하게 한다.

관찰 가능한 성공: 도우미가 프로젝트 또는 PostgreSQL 서비스의 이름/상태를 하나 이상 말하거나 계정에 없다고 분명히 말한다. 「연결됨」만 있고 서비스 조회 결과가 없으면 이번 시도는 끝나지 않은 것이다.

사용 사례

사례 1: PostgreSQL 서비스를 본다. 대응 능력은 Aiven PostgreSQL 직접 관리. read_only=true 아래에서 도우미가 인스턴스 이름, 상태, 연결 관련 읽기 전용 정보를 읽게 한다. 공식에 필드 표는 없다. 데이터베이스를 drop 하지 말 것.

사례 2: Apache Kafka 서비스를 본다. 대응 능력은 Kafka 관리. 마찬가지로 클러스터나 서비스 상태를 읽기 전용으로 조회한다. 공식이 이름을 댄 위험한 쓰기는 producing messages. 읽기 전용에서는 쓰기가 빠져야 하지만 메시지 생산이나 서비스 삭제를 스스로 요청하지 말 것.

applications 와 다른 Aiven 서비스도 관리 대상으로 이름이 나오지만 처음에는 쓰기로 넓히지 말 것.

사용 경계

로컬 대안은 Node.js 18+ 의 npx -y mcp-aiven 과 AIVEN_TOKEN 설정이다. 첫 주 경로가 아니다. 문서의 예시 token 값을 붙이지 말 것.

전체 호스팅 URL 에서 읽기 전용 인자를 빼도 되지만 그러면 쓰기 도구가 등록된다. 접근은 인가된 Aiven 사용자를 따른다. 이름 댄 서비스 밖의 클라우드 업체는 적혀 있지 않다.

read_only=true 는 위험 제로가 아니다: 여전히 클라우드 프로젝트를 읽고 인가는 Aiven 을 연다. 나타나지 않은 도구 이름을 만들지 말 것.