M MCP모아
튜토리얼

나라장터 MCP 연동 가이드 — 조달청 API를 Claude에서 바로 조회하기

나라장터 MCP 연동 방법을 단계별로 안내합니다. 조달청 공공조달 API를 Claude Desktop·Claude Code에 연결해 입찰 정보를 AI로 바로 조회하세요.

조달청 나라장터 API와 Claude AI가 MCP 서버를 통해 연결되는 데이터 흐름을 나타낸 표지 이미지

조달청 나라장터 API를 MCP로 연결하면 Claude에서 입찰 공고·낙찰 결과·업체 정보를 자연어로 바로 조회할 수 있습니다. 이 가이드는 공공데이터포털 API 키 발급부터 Claude Desktop 설정, 실제 조회 확인까지 전 과정을 단계별로 안내합니다. 별도 서버 구축 없이 uvx 명령 하나로 시작할 수 있으며, 한 번 설정하면 이후에는 Claude 채팅창에서 바로 입찰 정보를 물어볼 수 있습니다.

나라장터 MCP 연동이 왜 필요한가

조달청 나라장터는 연간 200조 원 규모의 공공 입찰이 오가는 국내 최대 조달 플랫폼입니다. 하지만 웹 사이트 직접 탐색은 번거롭고, 원하는 조건의 공고를 빠르게 추려내기가 쉽지 않습니다. MCP(Model Context Protocol)를 이용하면 이 문제를 해결할 수 있습니다.

MCP란 AI 클라이언트(Claude 등)가 외부 도구·API와 표준 방식으로 통신하도록 Anthropic이 정의한 개방형 프로토콜입니다. 나라장터 API를 MCP 서버로 감싸면 Claude가 직접 API를 호출하고, 결과를 자연어로 가공해 돌려줍니다.

예를 들어 Claude에게 “이번 달 IT 용역 입찰 공고 중 예산 1억 원 이상인 것만 요약해줘”라고 물으면, MCP 서버가 나라장터 API에 조건을 전달하고 응답을 받아 Claude가 표로 정리해 보여줍니다.

사용자(Claude Desktop)
       │  자연어 질문
       ▼
  Claude (LLM)
       │  도구 호출 요청
       ▼
data-go-mcp-servers (MCP 서버)
       │  HTTP 요청 (API 키 포함)
       ▼
조달청 나라장터 API (data.go.kr)
       │  JSON 응답
       ▼
  Claude (결과 가공)
       │  자연어 답변
       ▼
사용자(Claude Desktop)

준비물 확인

항목설명필수 여부
Claude DesktopAnthropic 공식 데스크톱 앱필수
Python 3.10 이상 + uvuvx 실행 환경필수
공공데이터포털 계정data.go.kr 가입필수
나라장터 API 인증키포털에서 활용 신청 후 발급필수

Claude Code 사용자도 동일한 설정 방식을 사용합니다. Claude Code MCP 설정 가이드를 함께 참고하세요.

단계별 연동 방법

1단계: 공공데이터포털 API 키 발급

  1. 공공데이터포털(data.go.kr)에 접속해 회원가입 또는 로그인합니다.
  2. 상단 검색창에 “나라장터” 또는 **“조달청”**을 입력합니다.
  3. 원하는 데이터셋(예: 조달청 나라장터 입찰공고정보 서비스)을 선택하고 활용 신청 버튼을 클릭합니다.
  4. 신청 완료 후 마이페이지 → 개발계정 메뉴에서 발급된 **일반 인증키(Decoding)**를 복사해 둡니다.

승인 처리는 대부분 즉시~1 영업일 내 자동으로 완료됩니다. 승인 메일이 오면 키를 사용할 수 있습니다.

2단계: uv 설치 확인

uvx 명령을 사용하려면 uv가 설치되어 있어야 합니다.

# uv 설치 여부 확인
uv --version

# 미설치 시 설치 (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

3단계: data-go-mcp-servers 동작 확인 (선택)

설정 전에 서버가 정상 실행되는지 먼저 확인하려면 아래 명령을 터미널에서 실행합니다. 저장소는 GitHub(Koomook/data-go-mcp-servers)에서 확인하세요.

uvx data-go-mcp.nps-business-enrollment@latest --help

이 서버 모음은 나라장터 외에도 여러 공공 API를 지원합니다. 지원 API 목록은 저장소 README를 참고하세요.

4단계: Claude Desktop 설정 파일에 MCP 서버 등록

Claude Desktop의 MCP 서버 설정 파일을 엽니다.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

파일이 없으면 새로 만들고, 아래와 같이 작성합니다. YOUR_API_KEY_HERE 부분을 1단계에서 복사한 인증키로 교체하세요.

{
  "mcpServers": {
    "data-go-mcp": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

이미 다른 MCP 서버가 등록되어 있다면 mcpServers 객체 안에 "data-go-mcp" 항목만 추가하면 됩니다.

5단계: Claude Desktop 재시작 및 연동 확인

  1. Claude Desktop을 완전히 종료 후 다시 실행합니다.
  2. 채팅창 하단 도구 아이콘(망치 모양)에 MCP 서버 목록이 표시되는지 확인합니다.
  3. 아래와 같이 테스트 질문을 입력해 보세요.
나라장터에서 이번 달 소프트웨어 개발 관련 입찰 공고를 조회해줘.

Claude가 MCP 서버를 통해 API를 호출하고 결과를 표로 정리해 보여주면 연동이 성공한 것입니다.

자주 발생하는 오류와 해결 방법

증상원인해결 방법
”MCP 서버를 찾을 수 없음”uvx 미설치 또는 PATH 미등록uv --version 으로 설치 확인, 터미널 재시작
”API 인증 실패 (SERVICE_KEY_IS_NOT_REGISTERED_ERROR)“API 키 오류 또는 승인 전 사용마이페이지에서 키 재확인, 승인 완료 후 재시도
응답이 인코딩 깨짐Encoding/Decoding 키 혼용Decoding 인증키 사용 여부 확인
JSON 파싱 오류설정 파일 문법 오류JSON 유효성 검사 도구로 claude_desktop_config.json 확인
일 트래픽 초과무료 한도 소진포털에서 한도 상향 신청 또는 다음 날 재시도

활용 시나리오

나라장터 MCP 연동 후에는 다음과 같은 작업을 Claude에게 자연어로 요청할 수 있습니다.

  • 특정 키워드(예: “클라우드”, “AI”, “보안”) 포함 입찰 공고 목록 추출
  • 발주 기관별 최근 낙찰 현황 집계
  • 공고 마감일 기준 D-7 이내 긴급 공고 필터링
  • 업종 코드 기반 자격 요건 비교 정리

이러한 반복 분석 업무를 Claude가 대신 처리해 주기 때문에, 담당자가 매일 나라장터 사이트를 수동으로 확인하는 시간을 크게 줄일 수 있습니다.

함께 쓰면 좋은 공공데이터 MCP 서버

나라장터 API와 함께 다음 공공데이터 MCP 서버를 활용하면 더 폭넓은 공공 정보를 AI로 조회할 수 있습니다.

  • 공공데이터포털 MCP 서버 모음: 조달청 나라장터 외에도 국민연금, 국세청, 금융감독원 등 다양한 공공 API를 한곳에서 연결할 수 있습니다.
  • 한국 부동산 MCP: 국토교통부 실거래가 데이터와 청약 정보를 AI로 분석합니다. 공공조달 부동산 관련 업무와 함께 활용 시 유용합니다.
  • 표준국어대사전 MCP 서버: 공문서·조달 문서 작성 시 표준 표현을 Claude에서 바로 검색할 수 있습니다.

더 많은 공공데이터 카테고리 MCP 서버는 MCP모아에서 확인하세요.

자주 묻는 질문

나라장터 API 키는 어떻게 발급받나요?

공공데이터포털(data.go.kr)에 회원가입 후 “조달청 나라장터”로 검색해 원하는 데이터셋의 활용 신청을 클릭합니다. 심사 없이 즉시 또는 1~2 영업일 내 자동 승인되며, 마이페이지에서 발급된 일반 인증키(Encoding/Decoding)를 확인할 수 있습니다.

무료로 사용할 수 있나요?

공공데이터포털 API는 기본 무료입니다. 다만 일 트래픽 한도(일반적으로 1,000~10,000건)가 설정되어 있으며, 대량 조회가 필요하면 포털에서 한도 상향 신청이 가능합니다.

Claude Code와 Claude Desktop 중 어디에 연결해야 하나요?

반복적인 자동화·스크립트 작업에는 Claude Code(터미널 환경)가 적합하고, 대화형으로 입찰 공고를 탐색하거나 요약·분석할 때는 Claude Desktop이 편리합니다. 두 클라이언트 모두 동일한 설정 방식(MCP 서버 등록)을 사용합니다.

data-go-mcp-servers가 지원하는 API가 나라장터만인가요?

아닙니다. data-go-mcp-servers는 조달청 나라장터 외에도 국민연금공단 사업장 가입 API, 국세청 사업자등록 진위 확인 API, 금융감독원 기업재무정보 API 등 여러 공공 API를 모아 놓은 서버 모음입니다.

API 응답이 인코딩 오류로 깨져 보여요.

조달청 API는 URL 인코딩된 키(Encoding 인증키)와 디코딩된 키(Decoding 인증키)를 구분해 발급합니다. HTTP 요청을 직접 구성하는 경우 Decoding 인증키를 사용하고, SDK·라이브러리를 사용하는 경우 Encoding 인증키를 사용하세요. MCP 서버 내부에서 처리하는 경우 서버 README의 안내를 따릅니다.

나라장터 외 다른 공공데이터 MCP 서버는 어디서 찾나요?

MCP모아의 공공데이터 카테고리에서 국내 공공 API와 연결되는 MCP 서버 목록을 확인할 수 있습니다. 전체 서버 목록은 /servers에서 검색·필터링할 수 있습니다.

다음 단계

나라장터 MCP 연동을 완료했다면, 이제 Claude에게 입찰 공고 분석을 맡기고 업무 자동화를 시작해 보세요. 더 많은 한국 공공데이터 MCP 서버를 탐색하고 싶다면 공공데이터 카테고리를 방문하거나, 아직 등록되지 않은 서버가 있다면 서버 제출 페이지를 통해 MCP모아에 기여해 주세요.

이 글과 관련된 MCP 서버