본문 바로가기

인공지능

Google Developer Knowledge API와 MCP 서버 공개, AI 개발 환경의 새로운 기준

728x90
반응형
728x170

AI 기반 개발 도구와 자동화된 코딩 환경이 빠르게 확산되면서, 개발자에게 가장 중요한 요소 중 하나는 최신 개발 문서에 얼마나 정확하게 접근할 수 있는가입니다. 그러나 많은 AI 도구는 오래된 학습 데이터나 비공식적인 웹 스크래핑 결과에 의존해, 실제 최신 문서와 다른 답변을 제공하는 한계를 가지고 있었습니다.
Google은 이러한 문제를 해결하기 위해 Developer Knowledge APIModel Context Protocol(MCP) 서버의 공개 프리뷰를 발표했습니다. 이 글에서는 두 기술의 개념과 배경, 주요 특징, 그리고 AI 개발 환경에서 어떤 가치를 제공하는지 정리해봅니다.

반응형

AI 개발 환경에서 문서 접근성이 중요한 이유

AI 어시스턴트와 IDE 내 코딩 보조 기능은 점점 더 많은 개발자의 일상 도구가 되고 있습니다. 하지만 이 도구들이 참조하는 문서가 최신이 아니라면 다음과 같은 문제가 발생합니다.

  • 이미 변경되거나 폐기된 API 사용
  • 설정 방식이 달라진 서비스에 대한 잘못된 가이드
  • 오류 원인 분석 시 부정확한 해결책 제시

결국 AI 기반 개발 생산성을 높이기 위해서는, 공식 개발 문서를 최신 상태로 직접 읽고 활용할 수 있는 구조가 필수적입니다. Google이 이번에 공개한 두 가지 도구는 바로 이 지점을 해결하기 위한 핵심 인프라입니다.


Developer Knowledge API란 무엇인가

Developer Knowledge API는 Google의 공식 개발 문서에 대한 프로그램적 접근 경로를 제공하는 API입니다. 기존처럼 웹 페이지를 사람이 직접 읽거나, 비공식적인 스크래핑 방식에 의존하지 않아도 됩니다.

핵심 개념과 특징

  • 공식 문서 직접 접근
    Google이 관리하는 최신 개발 문서를 API 형태로 검색하고 조회할 수 있습니다.
  • 머신 친화적인 Markdown 제공
    문서 전체를 사람이 읽기 쉬운 웹 페이지가 아닌, AI와 프로그램이 처리하기 쉬운 Markdown 형태로 제공합니다.
  • 광범위한 문서 커버리지
    firebase.google.com, developer.android.com, docs.cloud.google.com 등 주요 Google 개발 문서를 포함합니다.
  • 검색 및 조회 기능
    특정 키워드로 관련 문서를 찾고, 코드 스니펫을 포함한 전체 콘텐츠를 가져올 수 있습니다.
  • 빠른 업데이트 반영
    공개 프리뷰 기간 동안 문서 변경 시 최대 24시간 내 재색인이 이뤄집니다.

이 API를 활용하면 AI 도구는 더 이상 “추정된 지식”이 아닌, 현재 시점의 공식 정보를 기반으로 답변할 수 있습니다.


MCP(Model Context Protocol) 서버의 역할

MCP 서버는 AI 어시스턴트가 외부 데이터 소스에 안전하고 표준화된 방식으로 접근할 수 있도록 설계된 오픈 표준 기반 서버입니다.

Developer Knowledge MCP 서버의 의미

Developer Knowledge MCP 서버를 IDE나 AI 어시스턴트에 연결하면, 다음과 같은 작업이 가능해집니다.

  • 구현 가이드 제공
    예: Firebase 푸시 알림 구현 방법을 공식 문서를 기준으로 안내
  • 문제 해결 지원
    예: Maps API 사용 중 발생한 ApiNotActivatedMapError 오류의 공식 해결 방법 검색
  • 비교 분석 수행
    예: Cloud Run과 Cloud Functions를 특정 사용 사례 기준으로 비교

즉, MCP 서버는 AI가 Google 개발 문서를 “참고”하는 수준을 넘어, 직접 읽고 이해한 뒤 상황에 맞게 활용하도록 만들어줍니다. 또한 다양한 AI 도구 및 보조 시스템과 호환되도록 설계되어 활용 범위가 넓습니다.


공개 프리뷰 버전 시작 방법

현재 Developer Knowledge API와 MCP 서버는 공개 프리뷰 형태로 즉시 사용 가능합니다. 기본적인 시작 절차는 다음과 같습니다.

  1. API 키 생성
    Google Cloud 프로젝트의 Credentials 페이지에서 Developer Knowledge API용 API 키를 생성하고 제한을 설정합니다.
  2. MCP 서버 활성화
    Google Cloud CLI 설치 후 아래 명령어로 MCP 서버를 활성화합니다.
  3. gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID
  4. 도구 설정 파일 수정
    mcp_config.json, settings.json 등 사용하는 AI 도구의 설정 파일에 API 연결 정보를 구성합니다.

AI 어시스턴트별 세부 설정 방법은 Google 공식 문서를 통해 확인할 수 있습니다.


현재 공개 프리뷰는 비정형 Markdown 콘텐츠 제공에 초점을 맞추고 있습니다. 하지만 Google은 정식 출시 전까지 다음과 같은 확장을 예고했습니다.

  • 코드 샘플 객체, API 참조 엔티티 등 구조화된 콘텐츠 지원
  • Google 개발 문서 커버리지 확대
  • 문서 변경 후 재색인 지연 시간 단축

이를 통해 AI 도구가 단순 설명을 넘어, 정확한 코드 중심의 가이드와 분석을 제공할 수 있는 기반이 마련될 것으로 보입니다.


728x90

Developer Knowledge API와 MCP 서버는 AI 기반 개발 환경에서 가장 큰 약점으로 지적되던 문서 최신성 및 신뢰성 문제를 정면으로 해결하려는 시도입니다.
공식 개발 문서를 머신이 직접 읽고 활용할 수 있게 됨으로써, AI 어시스턴트는 더 정확한 구현 가이드와 문제 해결 방안을 제시할 수 있습니다.

앞으로 이 두 도구가 정식 출시되고 기능이 확장된다면, AI 개발 도구는 단순한 보조 수단을 넘어 신뢰할 수 있는 실전 개발 파트너로 자리 잡을 가능성이 큽니다. 개발 생산성과 코드 품질을 동시에 높이고자 하는 개발자라면, 이번 Google의 공개 프리뷰를 주목해볼 만합니다.

300x250

https://developers.googleblog.com/introducing-the-developer-knowledge-api-and-mcp-server/

 

Introducing the Developer Knowledge API and MCP Server- Google Developers Blog

As the ecosystem of AI-powered developer tools—from agentic platforms like Antigravity to command-line interfaces like Gemini CLI—continues to expand, a critical challenge has emerged: how do we ensure these models have access to the most accurate, up-

developers.googleblog.com

728x90
반응형
그리드형