Agent를
실제 로컬 데이터에 연결하세요.

각 단계를 확인할 수 있는 워크플로.

Agent에 구체적인 작업을 요청하고 원본, 계획과 저장 결과를 검토하세요. 아래 예시는 지원되는 로컬 Sentinel-2 장면 분류 레이어(SCL)를 사용합니다.

1. 원본과 픽셀 검사

   래스터의 CRS, 크기, 체크섬과 원본 픽셀 값을 검사하세요. 레시피를 정확한 원본 작업과 체크섬에 고정합니다.

   geod_raster_inspect · geod_raster_pixel

2. 픽셀에 정렬된 잘라내기 계획 검토

   작업 생성 전에 출력 크기, 잘라내기 범위와 경고를 검토하세요.

   geod_recipe_plan

3. 쓰기 활성화 후 실행하고 완료 대기

   쓰기 도구는 시작 시 명시적으로 설정해야 합니다. 레시피 실행 후 작업이 성공하고 워커의 정리가 끝날 때까지 기다리세요.

   geod_recipe_run → geod_job_status
status = succeeded · settled = true

4. 저장된 GeoTIFF 결과 검사

   완료된 파일과 샘플 픽셀을 검사하세요. 출력과 원본 및 레시피의 연결을 유지합니다.

   geod_raster_inspect · geod_raster_pixel

유용한 결과를 확인할 수 있는 도구.

• 작업과 프로젝트

  저장된 작업 상태와 프로젝트 기록을 읽고 같은 작업을 완료까지 추적합니다.

  geod_jobs_list · geod_job_status · geod_projects_list
• 래스터 검사와 레시피

  실제 픽셀을 읽고 지원되는 레시피의 출력 격자를 실행 전에 확인합니다.

  geod_raster_inspect · geod_raster_pixel · geod_recipe_plan
• 저장된 WCS 커버리지

  저장된 커버리지 설명과 계획, 완료된 로컬 파일의 원본 샘플을 검사합니다.

  geod_wcs_plan · geod_wcs_inspect · geod_wcs_pixel
• 명시적으로 활성화한 작업

  쓰기 도구를 활성화하면 지원되는 레시피 실행, 파일 다운로드, 작업 취소와 재시도가 가능합니다.

  geod_recipe_run · geod_download · geod_job_cancel

두 가지 연결 방법.

소스에서 빌드한 개발 런타임을 사용하세요. 호환 MCP 클라이언트에 실행 파일 경로를 설정한 뒤 연결 모드 하나를 선택합니다.

기존 로컬 서비스 사용

먼저 로컬 GeoD 서비스를 시작하고 루프백 주소에 연결하세요. 서비스가 작업을 관리하므로 Agent 세션을 닫은 뒤에도 작업을 계속할 수 있습니다.

geod-runtime serve-mcp --server http://127.0.0.1:4318

별도 로컬 작업 공간 사용

독립 MCP 프로세스가 데이터 디렉터리를 독점합니다. 데스크톱이나 다른 프로세스가 사용하지 않는 디렉터리를 선택하고 작업 정리가 끝날 때까지 세션을 유지하세요.

geod-runtime serve-mcp --data-dir ./geod-agent-data

쓰기 도구를 활성화하려는 경우에만 다음 시작 옵션을 추가하세요.

--allow-write

호환 클라이언트의 로컬 MCP 어댑터로 연결합니다. GeoD 런타임을 사용하며 열린 데스크톱 창을 자동으로 제어하지는 않습니다.