Neon 자동화
Neon 서버리스 Postgres 워크플로우를 자동화하세요 — 프로젝트 및 브랜치 목록 조회, 데이터베이스 검사, 연결 URI 검색, 역할 관리, 그리고 Neon 데이터베이스 작업을 여러 앱 간 파이프라인에 통합할 수 있습니다.
툴킷 문서: composio.dev/toolkits/neon
설정
- Composio MCP 서버를 클라이언트에 추가:
https://rube.app/mcp - 프롬프트가 나타나면 Neon 계정 연결 (API 키 인증)
- 아래 워크플로우 사용 시작
핵심 워크플로우
1. 프로젝트 목록 조회
NEON_RETRIEVE_PROJECTS_LIST를 사용하여 인증된 사용자와 연결된 모든 프로젝트를 확인합니다.
도구: NEON_RETRIEVE_PROJECTS_LIST
입력:
- org_id: 문자열 (개인 API 키 사용 시 필수)
- limit: 정수 (1-400, 기본값 10)
- cursor: 문자열 (이전 응답의 페이지네이션 커서)
- search: 문자열 (프로젝트 이름 또는 ID로 검색, 부분 일치 지원)
- timeout: 정수 (밀리초; 시간 초과 시 부분 결과 반환)
중요: 개인 API 키를 사용하는 경우 org_id가 필수입니다. 먼저 NEON_GET_USER_ORGANIZATIONS를 통해 조회하세요.
2. 프로젝트 세부 정보 가져오기
NEON_ACCESS_PROJECT_DETAILS_BY_ID를 사용하여 프로젝트 구성, 소유자 정보 및 소비 메트릭을 확인합니다.
도구: NEON_ACCESS_PROJECT_DETAILS_BY_ID
입력:
- project_id: 문자열 (필수) -- 형식: "형용사-명사-숫자", 예: "dry-smoke-26258271"
3. 프로젝트의 브랜치 목록 조회
NEON_GET_BRANCHES_FOR_PROJECT를 사용하여 프로젝트 내 브랜치(개발 단계)를 열거합니다.
도구: NEON_GET_BRANCHES_FOR_PROJECT
입력:
- project_id: 문자열 (필수)
- search: 문자열 (선택 사항, 브랜치 이름 또는 ID로 검색)
4. 브랜치의 데이터베이스 목록 조회
NEON_FETCH_DATABASE_FOR_BRANCH를 사용하여 특정 프로젝트 및 브랜치 내 데이터베이스를 목록화합니다.
도구: NEON_FETCH_DATABASE_FOR_BRANCH
입력:
- project_id: 문자열 (필수)
- branch_id: 문자열 (필수)
5. 연결 URI 가져오기
NEON_GET_PROJECT_CONNECTION_URI를 사용하여 프로젝트/브랜치/데이터베이스에 대한 Postgres 연결 문자열을 얻습니다.
도구: NEON_GET_PROJECT_CONNECTION_URI
입력:
- project_id: 문자열 (필수)
- database_name: 문자열 (필수) -- 예: "neondb"
- role_name: 문자열 (필수) -- 예: "neondb_owner"
- branch_id: 문자열 (선택 사항, 기본값은 프로젝트 기본 브랜치)
- endpoint_id: 문자열 (선택 사항, 기본값은 읽기-쓰기 엔드포인트)
- pooled: 부울 (선택 사항, 연결 풀링을 위해 -pooler 추가)
보안: 반환된 URI에는 자격 증명이 포함됩니다. 이를 비밀로 취급하여 로그에 기록하거나 공유하지 마십시오.
6. 데이터베이스 세부 정보 및 역할 검사
NEON_RETRIEVE_BRANCH_DATABASE_DETAILS를 사용하여 연결 전 데이터베이스를 확인하고, NEON_GET_BRANCH_ROLES_FOR_PROJECT를 사용하여 사용 가능한 역할을 나열합니다.
도구: NEON_RETRIEVE_BRANCH_DATABASE_DETAILS
입력:
- project_id: 문자열 (필수)
- branch_id: 문자열 (필수)
- database_name: 문자열 (필수)
도구: NEON_GET_BRANCH_ROLES_FOR_PROJECT
입력:
- project_id: 문자열 (필수)
- branch_id: 문자열 (필수)
알려진 문제점
| 문제점 | 세부사항 |
|---|---|
| org_id 필수 | 개인 API 키 사용 시 NEON_RETRIEVE_PROJECTS_LIST가 HTTP 400 "org_id is required" 오류 반환. 먼저 NEON_GET_USER_ORGANIZATIONS를 호출하세요. |
| 페이지네이션 불완전 | 페이지네이션 없이 프로젝트 목록이 불완전할 수 있습니다. cursor가 빌 때까지 반복하여 사용하세요. |
| 속도 제한 | NEON_RETRIEVE_PROJECTS_LIST가 과도한 요청 시 HTTP 429 반환. 중복 호출을 피하고 재시도 전에 지연하세요. |
| 잘못된 역할/데이터베이스 쌍 | NEON_GET_PROJECT_CONNECTION_URI가 유효하지 않은 database_name/role_name 쌍에 대해 401/403 반환. 허용된 역할을 선택하려면 NEON_GET_BRANCH_ROLES_FOR_PROJECT를 사용하세요. |
| 연결 URI는 비밀 | 반환된 URI에는 자격 증명이 포함됩니다. 절대 로그에 기록하거나, 표시하거나, 일반 텍스트로 공유하지 마십시오. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
NEON_RETRIEVE_PROJECTS_LIST | 페이지네이션 및 검색으로 모든 Neon 프로젝트 나열 |
NEON_ACCESS_PROJECT_DETAILS_BY_ID | 프로젝트 구성 및 소비 메트릭 가져오기 |
NEON_GET_BRANCHES_FOR_PROJECT | 프로젝트 내 브랜치 나열 |
NEON_FETCH_DATABASE_FOR_BRANCH | 특정 브랜치의 데이터베이스 나열 |
NEON_GET_PROJECT_CONNECTION_URI | Postgres 연결 URI 가져오기 (자격 증명 포함) |
NEON_RETRIEVE_BRANCH_DATABASE_DETAILS | 데이터베이스 메타데이터 및 설정 검사 |
NEON_GET_USER_ORGANIZATIONS | 인증된 사용자의 조직 나열 |
NEON_CREATE_API_KEY_FOR_ORGANIZATION | 조직에 대한 새 API 키 생성 |
NEON_GET_BRANCH_ROLES_FOR_PROJECT | 브랜치에서 사용 가능한 역할 나열 |
Composio 제공