← kr-bid
MCP 서버

나라장터를 AI 앱에서 직접

공고 검색 · 북마크 · 낙찰 조회 · HWP/PDF 본문 파싱까지 kr-bid 도구를 ChatGPT, Claude, Kakao PlayMCP, Codex, Cursor, VS Code 에서 호출하세요. 공개 웹 연결은 OAuth만 사용합니다.

연결 가이드

Support: [email protected]

kr-bid MCP 가 뭔가요

MCP (Model Context Protocol) 는 AI 에이전트가 외부 도구를 표준 방식으로 호출하는 프로토콜입니다. kr-bid 는 나라장터 공고 / 낙찰 데이터와 첨부 파싱 도구를 MCP 서버로 노출합니다.

이런 식으로 씁니다

입찰 담당

"이번 주 IT 용역 공고 추천 + 첨부 PDF 요약해줘"

시장 분석가

"기관 X 의 최근 6개월 낙찰가율 분포와 업체 top 10"

자동화

"매일 9시에 새 공고를 찾아 알림으로 정리해줘"

공개 웹 연결 (OAuth)

ChatGPT, Claude web, Kakao PlayMCP 같은 공개 클라이언트는 같은 주소를 등록하고 kr-bid 로그인 화면에서 OAuth 동의를 완료합니다.

1

MCP URL 등록

설정 위치: Settings → Connectors → Add custom connector

MCP server URL
https://kr-bid.com/mcp

Authentication
OAuth authorization code + PKCE
2

kr-bid 로그인

클라이언트가 여는 OAuth 화면에서 Kakao 또는 Google 로 로그인합니다.
3

연결 동의

동의가 끝나면 클라이언트가 access token 을 받아 /mcp 로 도구를 호출합니다.

인증 방식

공개 웹 연결은 OAuth만 사용합니다. discovery 는 /.well-known/oauth-authorization-server 와 /.well-known/oauth-protected-resource/mcp 에서 확인할 수 있습니다.

장기 연결이 필요한 클라이언트는 mcp offline_access scope 로 refresh token 을 회전합니다. OpenAI Responses API 연동은 search, fetch 만 허용하는 smoke 를 기본 검증으로 둡니다.

사용 가능한 도구 (28개)

AI 앱 호환2개
  • searchOpenAI / Deep Research 호환 공개 검색
  • fetchsearch 결과 id 의 원문/상세 조회
공고 검색7개
  • search_notices공고 검색 (query · 기관 · 지역 · 분야 · 마감일)
  • get_notice공고 상세 + 첨부 + 북마크 여부
  • list_attachments공고 첨부파일 목록
  • summarize_notice공고 본문 + 첫 첨부 raw_text 합쳐 요약 친화 포맷
  • create_saved_search사용자 검색 조건 저장
  • delete_saved_search저장된 검색 삭제
  • list_saved_searches내 저장된 검색 목록
북마크3개
  • add_bookmark공고 북마크 추가
  • remove_bookmark북마크 삭제
  • list_bookmarks내 북마크 목록
키워드 / 알림6개
  • add_watch_keyword알림 키워드 등록 (1~64자, 최대 50개)
  • remove_watch_keyword키워드 삭제
  • list_watch_keywords내 키워드 목록
  • list_notifications본인 알림
  • mark_notification_read알림 읽음 처리
  • trending_keywords최근 N일 공고 제목 단어 빈도 top_k
낙찰7개
  • get_award단건 낙찰업체 / 가격 / 낙찰가율
  • awards_by_corp사업자등록번호로 업체 낙찰 이력
  • awards_by_instt발주기관명으로 발주 패턴
  • awards_by_instt_cd기관 코드로 조회
  • awards_by_clsfc입찰 분류 번호로 조회
  • award_stats최근 N일 사업유형별 집계
  • award_estimate기관/분야 기반 낙찰가율 추정
첨부 본문 검색3개
  • search_attachments_by_text첨부 raw_text / preview_text 키워드 매칭
  • search_attachments_by_parsed자격요건 / 품목명 BM25
  • attachment_text_chunk큰 PDF/HWP raw_text char 단위 paginate

보안 권장사항

  • 클라이언트가 제공하는 OAuth 연결 화면에서만 승인하세요.
  • 사용하지 않는 연결은 각 AI 앱의 커넥터 설정에서 해제하세요.
  • 공유 PC 나 테스트 계정에서는 연결 후 반드시 로그아웃하세요.
  • 의심스러운 활동은 feedback 으로 접수하면 운영자가 OAuth client 를 폐기합니다.

자주 묻는 질문

요금이 있나요?
베타 기간 동안 무료입니다. 정식 출시 후 가격은 /pricing 참고.
연결 해제는 어디서 하나요?
현재는 연결한 AI 앱의 커넥터 설정에서 해제합니다. kr-bid 계정 화면의 연결 관리 UI는 공개 전 별도 추가 예정입니다.
rate limit 이 있나요?
베타 기간엔 IP/사용자 분당 60req soft limit. 자동화 봇으로 과도한 호출 시 일시 차단될 수 있습니다.
어떤 데이터를 볼 수 있나요?
나라장터 공개 데이터와 본인이 등록한 북마크, 키워드, 알림을 볼 수 있습니다. 개인 상태는 OAuth 로 인증된 사용자 범위 안에서만 접근합니다.
MCP 가 뭔가요?
AI 에이전트가 외부 도구를 JSON-RPC 로 호출하는 표준 프로토콜입니다. modelcontextprotocol.io