PostgreSQL 확장은 지원되는 AI 지원 호스트에 MCP(모델 컨텍스트 프로토콜) 서버 정의를 등록할 수 있습니다. 이 등록을 통해 호스트는 각 도구를 직접 구성하도록 요청하지 않고도 연결 관리, 스키마 탐색, 쿼리 실행 및 관련 워크플로를 위한 PostgreSQL 도구를 검색할 수 있습니다.
확장에서 MCP 지원이 작동하는 방식, 현재 지원되는 호스트 및 등록 후 사용할 수 있는 도구 패밀리를 이해하려면 이 페이지를 사용합니다.
필수 조건
MCP 서버에 의존하기 전에 다음이 있는지 확인합니다.
- Visual Studio Code 또는 커서에 설치된 PostgreSQL 확장입니다.
- 확장에서 활성화된 Copilot/AI 기능(
pgsql.copilot.enable는true입니다). 설정 ID는 두 편집기 모두에서pgsql.copilot.*접두사를 유지합니다. 레이블은 Cursor에서 AI로 표시됩니다. - MCP 도구가 서버에 빠르게 연결되도록 하려면 하나 이상의 저장된 연결 프로필입니다.
- MCP 등록 API를 노출하는 지원되는 호스트입니다.
MCP 등록 작동 방식 이해
다음이 모두 true이면 확장이 MCP 서버를 자동으로 등록합니다.
- 호스트는 지원되는 MCP 등록 API를 노출합니다.
- 확장은 해당 언어 서비스에서 유효한 MCP 서버 URL 및 전달자 토큰을 검색할 수 있습니다.
- Copilot 통합이 활성화되었습니다.
현재 코드 경로는 다음을 명시적으로 지원합니다.
- MCP 서버 정의 공급자 API를 통한 Visual Studio Code 1.102 이상
-
Cursor Cursor의
registerServerMCP API를 통해
Visual Studio Code 확장은 서버를 PostgreSQL MCP로 등록합니다. 커서에서 서버를 pgsql-mcp로 등록합니다.
Important
확장은 현재 MCP URL 및 토큰을 직접 입력해야 하는 독립 실행형 클라이언트에 대한 수동 복사 및 붙여넣기 설정 흐름을 노출하지 않습니다. 클라이언트가 호스트 수준 검색 또는 등록을 지원하지 않는 경우 확장의 기본 제공 AI 워크플로를 대신 사용합니다.
MCP 도구에 대한 연결 프로필 준비
가장 유용한 MCP 흐름은 저장된 연결 정보에 따라 달라집니다.
- 연결 및 ID를 열고 호스트에서 사용할 연결 프로필을 만들거나 업데이트합니다.
- 워크플로에 필요한 자격 증명을 저장합니다.
- MCP 기반 자동화에 의존하기 전에 확장에서 대상 데이터베이스에 연결할 수 있는지 확인합니다.
이는 연결 지향 MCP 도구가 AI 호스트의 별도 데이터베이스 구성이 아닌 확장의 연결 저장소에서 대상 프로필을 확인하기 때문에 중요합니다.
지원되는 호스트에서 MCP 도구 사용
호스트가 PostgreSQL MCP 서버를 검색한 후 확장에 의해 노출되는 도구 화면을 호출할 수 있습니다.
| 도구 패밀리 | 도움이 되는 부분 | 일반적인 용도 |
|---|---|---|
| 연결 프로필 나열 | 저장된 프로필 검색 | 연결하기 전에 올바른 프로필 찾기 |
| PostgreSQL 데이터베이스에 연결 | 저장된 프로필에서 데이터베이스 세션 열기 | 올바른 서버 또는 데이터베이스에서 작업 시작 |
| 데이터베이스 목록 | 연결된 서버의 데이터베이스 나열 | 컨텍스트 전환 또는 사용 가능한 데이터베이스 검사 |
| 데이터베이스 개체 가져오기 | 스키마 컨텍스트 가져오기 | 후속 질문을 하기 전에 테이블, 뷰, 함수 및 기타 개체 식별 |
| 쿼리 실행 | 읽기 지향 SQL 실행 | 데이터 검사 또는 가정 유효성 검사 |
| 데이터베이스 수정 | 데이터 또는 스키마 변경 실행 | 쓰기 액세스가 필요한 워크플로에서 DDL 또는 DML 적용 |
| SQL 스크립트 열기 | 검토를 위한 스크립트 만들기 | 에이전트 출력에서 사람이 검토한 쿼리 편집기 흐름으로 이동 |
| 쿼리 계획 | 캐시된 계획 데이터 검사 | 성능 워크플로 분석 |
| 데이터베이스 스키마 시각화 | 스키마 뷰 렌더링 | SQL을 작성하거나 변경하기 전에 관계 이해 |
| 대시보드 컨텍스트 가져오기 | 사용 가능한 메트릭 및 구성을 포함하여 활성 대시보드 세션 컨텍스트 검색 | 메트릭 데이터를 요청하기 전에 사용할 수 있는 메트릭 검색 |
| 대시보드 메트릭 데이터 가져오기 | 열린 서버 대시보드에서 일괄 처리된 캐시된 시계열 데이터 가져오기 | 라이브 쿼리를 실행하지 않고 서버 성능 추세 분석 |
Tip
더 안전한 워크플로를 위해 쿼리 또는 수정을 실행하기 전에 연결 프로필 나열, PostgreSQL 데이터베이스에 연결 및 데이터베이스 개체 가져오기 와 같은 검색 도구로 시작합니다.
MCP와 기본 제공 AI 환경 중에서 선택
호스트가 MCP 검색을 지원하고 확장에서 PostgreSQL 도구 화면을 노출하려는 경우 MCP 서버를 사용합니다.
다음과 같은 경우 기본 제공 확장 환경을 사용합니다.
- @pgsql 채팅 참가자와 직접 채팅하려는 경우(Visual Studio Code만 해당)
- 에이전트 모드(Visual Studio Code 및 Cursor) 내에서 다단계 자동화를 사용하려는 경우 또는
- 현재 사용 중인 호스트는 확장의 MCP 등록을 자동으로 노출하지 않습니다.
MCP 가용성 문제 해결
호스트에 PostgreSQL MCP 서버가 표시되지 않음
지원되는 호스트를 실행하고 있으며 확장에서 Copilot/AI 통합이 사용하도록 설정되어 있는지 확인합니다. 필요한 경우 로그인한 후 창을 다시 로드하거나 Copilot/AI 설정을 변경합니다.
등록 건너뛰기
확장은 언어 서비스에서 사용 가능한 MCP URL 또는 토큰을 검색할 수 없는 경우 등록을 건너뜁니다. 호스트가 다시 로드한 후 서버를 검색하지 않는 경우 확장 출력 로그를 확인합니다.
도구가 내 데이터베이스에 연결할 수 없음
대상 연결 프로필이 있고 확장에서 직접 사용할 수 있는지 확인합니다. MCP 흐름은 확장의 다른 부분과 동일한 연결 저장소 및 자격 증명 결정 방식에 의존합니다.
다른 MCP 클라이언트에 대한 수동 엔드포인트가 필요합니다.
확장은 현재 독립 실행형 MCP 클라이언트에 대한 사용자 지향 수동 엔드포인트 워크플로를 제공하지 않습니다. 지원되는 호스트를 사용하거나 이 문서 집합에 설명된 기본 제공 AI 환경으로 대체합니다.