QGIS & Claude AI 연동: 90% 실패하던 MCP 설치, 5분 만에 성공하는 완벽 가이드!
AI한테 QGIS 시키는 법 알려줄게! (MCP 설치 방법)
원래 QGIS(큐지스)라는 프로그램을 쓰려면 우리가 직접 클릭하고 명령 내리고 해야 했잖아? 근데 이제는 AI한테 "이거 해줘!" 하고 시킬 수 있게 됐어! 그걸 가능하게 해주는 게 바로 MCP라는 거야.
준비물:
- 윈도우 컴퓨터: 이 설명은 윈도우 기준으로 할 거야.
- 클로드 데스크탑: 이게 뭐냐면 ChatGPT랑 비슷한 AI 중에 하나야.
- 클로드 가입: 먼저 '클로드'라고 검색해서 사이트에 들어가서 회원 가입을 해야 해.
- 클로드 데스크탑 다운로드: 구글에 '클로드 데스크탑'이라고 검색하면 다운로드 링크가 나올 거야. 그걸로 들어가서 윈도우용을 다운받아 설치하면 돼.
클로드 구독해야 하나요?
- 필수! 사실 MCP 자체는 구독 안 해도 쓸 수 있다고 하는데, AI한테 질문 몇 번 하다 보면 구독하라고 뜰 거야. 그래서 사실상 구독해야 한다고 보면 돼.
- 추천: QGIS가 너무 어려워서 못 따라가겠다면, 한 달 정도만 구독해서 AI한테 시켜보는 걸 추천해. 한 달에 20달러 정도 하니까 부담 없을 거야. 마음에 안 들면 해지하면 되니까!
MCP, 그게 뭔데?
간단하게 말하면, AI(클로드)한테 QGIS를 다룰 수 있는 도구(망치 같은 거)를 만들어 주는 거야.
왜 이게 가능할까?
QGIS라는 프로그램은 사실 파이썬이랑 SQL이라는 코딩 언어로 만들어져 있어. QGIS에서 버퍼 만들기, 위치로 선택하기 같은 기능들이 다 파이썬이랑 SQL로 돌아가는 거지.
똑똑한 사람들이 생각했어. "야, 클로드라는 AI한테 파이썬이랑 SQL을 알려주면, 클로드가 QGIS한테 명령을 내릴 수 있지 않을까?" 그래서 MCP를 만든 거야. 우리는 이 MCP를 받아서 컴퓨터에 설치하고, 클로드한테 QGIS를 시키는 거지!
설치하면 뭐가 좋아지는데?
예를 들어, 내가 경매 사건 데이터가 있고, 학원 건물 데이터가 있다고 해보자.
- AI한테 시키면: "경매 사건 레이어에서 학원 건물 위에 있는 것만 골라줘!" 라고 말하면, AI가 알아서 QGIS한테 명령을 내려서 딱 필요한 데이터만 골라주는 거야.
MCP 설치 방법 (차근차근 따라와!)
1단계: MCP 다운로드 및 설치 도구 준비
- GitHub 접속: 구글에 'GitHub'라고 검색해서 들어가. (프로그래머들이 코드를 모아두는 곳이야)
- QGIS MCP 검색: GitHub 검색창에 'qgis mcp'라고 검색해.
- 가장 인기 있는 거 찾기: 여러 개가 나올 텐데, '별표'가 가장 많은 걸 찾아봐. (보통 'santos-qgis-mcp' 같은 이름일 거야)
- 다운로드: 해당 페이지에 들어가서 'Code' 누르고 'Download ZIP'을 눌러서 다운받아.
- 압축 풀기: 다운받은 파일을 압축 해제해 줘.
2단계: 설치 도구 실행 (Windows PowerShell)
- PowerShell 열기: 윈도우 시작 버튼 누르고 'PowerShell'이라고 검색해서 'Windows PowerShell'을 실행해.
- 명령어 복사 & 붙여넣기:
- 압축 푼 폴더 안에 'windows-powershell'이라고 적힌 파일이 있을 거야. 그걸 열어서 안에 있는 명령어들을 전부 복사해.
- PowerShell 창에 복사한 명령어를 붙여넣고 Enter를 눌러.
- 뭔가 쭉쭉 올라가면서 설치가 될 거야. 이게 MCP를 설치하기 위한 다른 도구(UVX)를 설치하는 과정이야.
- 닫기: 설치가 끝나면 PowerShell 창을 닫아.
3단계: 클로드 데스크탑 설정
- 클로드 데스크탑 실행: 설치한 클로드 데스크탑을 켜고 로그인해.
- 설정 들어가기: 왼쪽 위에 있는 점 세 개 (☰) 를 누르고 '파일' -> '설정'으로 들어가.
- 개발자 설정: '개발자' 탭을 누르고 '구성 편집'을 눌러.
-
JSON 파일 편집:
- '클로드데스크탑.config.json' 이라는 파일이 보일 거야. (아이콘 모양은 다를 수 있어)
- 이 파일을 마우스 오른쪽 버튼으로 클릭하고 '메모장에서 편집'을 눌러.
- 파일 내용을 전부 지우고 아래 코드를 그대로 붙여넣기 해.
json { "plugins": [ { "name": "qgis", "path": "YOUR_QGIS_MCP_PLUGIN_PATH" } ] }
* 중요!YOUR_QGIS_MCP_PLUGIN_PATH부분은 네 컴퓨터에 MCP 플러그인이 있는 실제 경로로 바꿔줘야 해. (아래 5단계에서 알려줄 거야)
* 저장:Ctrl + S를 눌러서 저장하고 메모장을 닫아.
4단계: QGIS MCP 플러그인 경로 설정
- 압축 풀었던 폴더로 가기: 아까 MCP 파일을 다운받아서 압축 풀었던 폴더로 다시 들어가.
- 경로 복사: 폴더를 쭉 따라 들어가다 보면 'src' 라는 폴더가 보일 거야. 이 'src' 폴더까지의 전체 경로를 복사해. (폴더 경로를 클릭하면 위쪽에 주소처럼 보일 거야)
- 클로드 설정에 붙여넣기:
- 다시 클로드 데스크탑 설정의 '개발자' -> '구성 편집'으로 들어가.
- 아까 붙여넣었던 JSON 코드에서
"YOUR_QGIS_MCP_PLUGIN_PATH"부분을 복사한 경로로 바꿔줘. - 주의! 경로를 붙여넣을 때, 윈도우에서 쓰는
\(원화 표시)를/(슬래시)로 바꿔줘야 해. 예를 들어C:\Users\...\qgis-mcp\src라면C:/Users/.../qgis-mcp/src이렇게 바꿔야 해.
- 저장:
Ctrl + S로 저장하고 닫아.
5단계: 클로드 데스크탑 재시작 및 확인
- 클로드 종료: 클로드 데스크탑을 그냥 끄면 백그라운드에서 계속 돌아갈 수 있어. 작업 표시줄에 있는 클로드 아이콘을 마우스 오른쪽 버튼으로 클릭하고 '종료'를 눌러서 완전히 꺼줘.
- 클로드 다시 켜기: 클로드 데스크탑을 다시 실행해.
- 설정 확인: 다시 '파일' -> '설정' -> '개발자' 탭으로 들어가면, 아까랑 다르게 'QGIS' 관련 설정이 보일 거야. (QGIS, QGIS 러닝 등으로 보일 수 있어) 이게 잘 연결됐다는 뜻이야!
6단계: QGIS에 MCP 플러그인 설치
- QGIS 프로파일 폴더 열기:
- QGIS를 실행해.
- '설정' -> '사용자 프로파일' -> '현재 프로파일 폴더 열기'를 눌러.
- 플러그인 폴더 찾기: 열린 폴더에서 'python' 폴더를 찾고, 그 안에 있는 'plugins' 폴더로 들어가.
- MCP 플러그인 복사:
- 아까 MCP 파일을 다운받아서 압축 풀었던 폴더로 다시 가.
- 그 안에 'qgis-mcp-plugin' 이라고 되어 있는 폴더가 있을 거야. 이걸 복사해.
- QGIS의 'plugins' 폴더 안에 복사한 'qgis-mcp-plugin' 폴더를 붙여넣기 해.
- QGIS 재시작: QGIS를 완전히 껐다가 다시 켜.
7단계: QGIS에서 MCP 활성화 및 실행
- 플러그인 관리자 열기: QGIS 상단 메뉴에서 '플러그인' -> '플러그인 관리 및 설치'를 눌러.
- MCP 찾아서 활성화: 설치된 플러그인 목록에서 'QGIS MCP' (또는 비슷한 이름)를 찾아서 체크 표시를 해주고 '닫기'를 눌러.
- MCP 서버 실행: QGIS 상단 메뉴에 '플러그인' -> 'QGIS MCP'를 누르면 'Start Server' 라는 버튼이 보일 거야. 이걸 눌러서 서버를 켜주면 설치 완료!
이제 AI한테 QGIS 시켜보자!
MCP 설치가 끝나면, 이제 AI한테 QGIS 명령을 내릴 수 있어.
예시:
내가 '상업용 부동산 경매 사건' 데이터와 '학원 건물' 데이터를 가지고 있다고 가정해 보자.
- AI한테 이렇게 말할 수 있어: "상업용 부동산 경매 사건 중에서 학원 건물 위에 있는 사건만 골라줘."
원래는...
AI한테 그냥 이렇게 말하면, AI가 QGIS를 잘 모를 수도 있고, 공간 인덱스 같은 어려운 개념 때문에 버벅거리거나 시간이 오래 걸릴 수 있어.
하지만 MCP를 설치하면...
AI가 QGIS의 기능을 이해하고, 필요한 작업을 알아서 수행하려고 노력해. 아까처럼 학원 건물 위에 있는 경매 사건만 골라내는 작업을 훨씬 빠르고 정확하게 해낼 수 있게 되는 거지!
주의할 점:
- AI가 QGIS를 완벽하게 이해하려면 '프로젝트'라는 걸 만들어서 AI한테 어떻게 작동해야 하는지 규칙을 미리 알려줘야 해. 이게 바로 '노하우'인데, 이건 좀 더 복잡해서 여기서는 다 설명하기 어렵고, 수업 같은 걸 들어야 배울 수 있다고 하네.
- 하지만 기본적인 기능들은 MCP 설치만으로도 AI한테 시킬 수 있다는 거!
궁금한 점이 있다면?
QGIS 관련해서 궁금한 점이 있거나 소통하고 싶으면, 영상 설명란에 단톡방 링크가 있으니 들어와서 같이 이야기해보자!