← kr-bid
MCP 서버

나라장터를 AI 앱에서 직접

공고 검색 · 첨부 본문 · 북마크 · 키워드 알림 · 낙찰 조회까지 kr-bid 도구를 ChatGPT, Claude, Kakao PlayMCP, Codex, Cursor, VS Code 에서 호출하세요. 공개 조회 8개 도구는 로그인 없이, 개인화 7개 도구는 OAuth 로그인 후 사용할 수 있습니다.

연결 가이드

Support: [email protected]

kr-bid MCP 가 뭔가요

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

이런 식으로 씁니다

입찰 담당

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

시장 분석가

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

자동화

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

공개 웹 연결

ChatGPT, Claude web, Kakao PlayMCP 같은 공개 클라이언트는 같은 주소를 등록합니다. 직접 연결의 공개 읽기 도구는 인증 없이 실행할 수 있고, 개인화가 필요할 때 kr-bid OAuth 동의를 완료합니다. PlayMCP는 현재 OAuth 인증으로 등록되어 있어, 도구함에 추가할 때 OAuth 연결을 완료한 뒤 15개 도구를 사용합니다.

1

MCP URL 등록

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

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

Authentication
None for public read-only tools
OAuth authorization code + PKCE for personalization
2

공개 정보 조회

로그인 없이 공고·첨부·낙찰·기관 통계와 조건별 판정·추천을 조회합니다.
3

개인화 연결

북마크·관심 키워드·알림이 필요하면 Kakao 또는 Google 로그인과 OAuth 동의를 완료합니다.

인증 방식

공개 읽기 도구는 인증 없이 호출할 수 있습니다. 이 공개 읽기 표면은 8개 도구로 구성되며, PlayMCP는 OAuth 연결로 등록되어 있습니다. 개인화 7개 도구는 인증된 본인 범위에서만 실행됩니다. 개인화 도구의 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 를 기본 검증으로 둡니다.

사용 가능한 도구 (15개)

검색·낙찰·분석·추천 8개는 공개이며, 북마크·키워드·알림 7개는 OAuth 사용자 전용입니다.

검색 · 조회3개
  • search공고 · 첨부 본문 통합 검색 → 결과 id 반환
  • fetch결과 id(notice: / attachment:)의 원문 · 첨부 목록 펼침
  • attachment_text_chunk큰 HWP/PDF 첨부 본문을 문자 구간 단위로 이어 읽기
낙찰2개
  • search_awards업체 · 기관 · 분류별 낙찰 이력 (낙찰가 · 낙찰가율)
  • award_stats최근 N일 사업유형별 낙찰 집계 (평균 낙찰가율 · 응찰수)
분석 · 추천3개
  • notice_agency_stats최근 공고를 기관별 건수 · 예산 · 접수 상태로 집계
  • assess_notice_fit회사 조건과 공고의 자격 · 우대조건 적합성 판정
  • recommend_notices저장하지 않는 회사 조건으로 공개 공고 추천
북마크3개
  • list_bookmarks내 북마크 목록
  • add_bookmark공고 북마크 추가
  • remove_bookmark북마크 삭제
키워드 / 알림4개
  • list_watch_keywords내 알림 키워드 목록
  • add_watch_keyword알림 키워드 등록 (1~64자, 최대 50개)
  • remove_watch_keyword키워드 삭제 (목록의 id 기준)
  • list_notifications본인 최근 알림 (유형별 분류 · 미읽음 포함)

보안 권장사항

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

자주 묻는 질문

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