Google Cloud나 Firebase 코드를 AI에게 맡길 때, 현재 공식 문서를 찾는 경로를 개발 도구에 붙일 수 있습니다. Google은 2026년 10월 7일 Developer Knowledge API 생태계를 소개했습니다. 터미널용 명령, 공식 에이전트 스킬, 언어별 클라이언트 라이브러리와 요청을 시험하는 APIs Explorer를 통해 문서 검색과 가져오기, 근거가 있는 답변을 연결하는 내용입니다. 공개된 사용자 반응은 아직 확인되지 않았습니다. (공식 발표)

한눈에 보기

궁금한 점 이번 발표의 핵심
새로 나온 API입니까? API와 MCP 서버는 2월 4일 프리뷰, 4월 16일 정식 출시됐습니다. 이번 발표는 그 위에 붙는 gcloud 명령·공식 스킬·클라이언트 라이브러리 소개입니다.
무엇을 연결합니까? Google Cloud·Firebase·Android 등 Google 개발자 문서를 검색하고 Markdown으로 가져옵니다.
어떤 문제에 맞습니까? 웹페이지 스크래핑의 불안정성과 모델 학습 이후 바뀐 문서 내용을 보완하는 경로입니다.
터미널에서 쓸 수 있습니까? gcloud 명령을 제공하며 Cloud Shell 사전 설치, Linux·macOS·Windows 지원을 안내합니다.
에이전트에는 어떻게 붙입니까? 공식 스킬과 Developer Knowledge MCP 서버를 연결합니다. Codex용 플러그인·인증 절차도 문서에 있습니다.
지원 언어는 무엇입니까? C#·Go·Java·Node.js/TypeScript·PHP·Python·Ruby입니다.
프로젝트 조건은 무엇입니까? 공식 환경 안내는 계정·프로젝트 IAM 권한·Cloud Billing 활성화를 전제로 둡니다.
얼마나 호출할 수 있습니까? 프로젝트당 기본 한도는 근거 답변 하루 50회, 검색과 문서 가져오기는 각각 분당 100회입니다.
비용은 얼마입니까? API 단가와 무료 한도는 공개 자료에서 확인되지 않았습니다.
한국에서 이용합니까? 한국 계정의 API/MCP 이용 가능 여부와 한국 내 처리 보장은 미확인입니다.

기능은 Google 발표, 설정은 Google Cloud 공식 문서를 기준으로 설명합니다. 문서 검색 경로가 생긴 사실과 답변 정확도·토큰 절감 효과는 구분합니다. 후자는 Google이 설명한 기대 효과이며, 여기서 직접 호출해 측정한 결과는 없습니다. (환경 설정 문서 · gcloud 참조)

이번 발표에서 새로 생긴 것은 무엇입니까?

Developer Knowledge API 자체는 이번에 처음 나온 서비스가 아닙니다. Google은 2026년 2월 4일 API와 MCP 서버를 공개 프리뷰로 내놓았고, 당시 Firebase·Android·Google Cloud 문서를 Markdown으로 제공하며 문서가 바뀌면 24시간 안에 다시 색인한다고 설명했습니다. 공식 변경 기록에 따르면 4월 16일 API와 MCP 서버가 정식 출시(GA)됐고, 근거 답변 기능 AnswerQuery는 4월 20일 추가된 뒤 7월 17일 정식 기능이 됐습니다. (2월 출시 발표 · 공식 변경 기록)

10월 7일 발표는 이 API를 쓰는 도구를 한데 모아 소개한 글입니다. 변경 기록상 gcloud developer-knowledge 명령은 9월 22일 정식 버전이 됐고, 공식 스킬 retrieving-developer-knowledge는 9월 25일 google/skills 저장소에 추가됐습니다. 이미 MCP 서버를 연결해 쓰던 사람이라면 달라진 점은 터미널 명령과 스킬, 언어별 라이브러리라는 선택지가 늘어난 것입니다. 처음 접하는 사람에게는 아래 네 경로 가운데 하나를 고르는 안내로 읽으면 됩니다. 변경 기록에는 근거 답변이 6월부터 인용과 참고 문서를 함께 돌려주고, 답변 생성에 gemini-3-flash-preview 모델을 쓴다는 항목도 있습니다. (공식 변경 기록)

검색 결과와 근거 답변은 어떻게 다릅니까?

쉽게 말하면 필요한 문서 조각을 찾는 기능, 문서 전체를 읽는 기능, 그 문서를 바탕으로 질문에 답하는 기능을 나눠 제공합니다. 의미 검색은 질문의 뜻에 가까운 내용을 찾고, 키워드 검색은 제품명이나 함수명 같은 단어로 찾는 방식입니다. 청크(chunk)는 문서를 나눈 작은 조각으로, 관련 부분부터 읽을 때 쓰입니다. API는 검색과 문서 조각, Markdown 형식의 본문, 근거 답변 기능을 제공한다고 설명합니다. (기능 설명)

예를 들어 Firebase 코드를 고치는 도구라면 관련 문서 조각을 먼저 찾고, 실제 변경에 필요한 페이지를 가져오는 순서로 설계할 수 있습니다. 모델이 기억하는 예전 설명과 현재 문서를 대조할 길이 생긴다는 의미입니다. Google은 문서를 자주 색인한다고 설명하며, 구체적인 갱신 주기와 최대 반영 지연 수치는 미공개입니다. 따라서 검색된 페이지의 내용과 적용 제품 버전을 함께 보는 방식이 적절합니다. (문서 갱신 설명)

gcloud에서는 어떤 명령을 씁니까?

이미 Google Cloud CLI를 쓰는 개발자는 터미널에서 문서를 찾을 수 있습니다. 공식 발표의 예시는 BigQuery 데이터셋 생성 질문, Firestore 트랜잭션 문서 검색, Cloud Storage 버킷 생성 문서 가져오기입니다. 아래는 공식 발표의 세 경로를 보여 주는 명령 예시입니다. (명령 예시 · 명령 그룹 참조)

gcloud developer-knowledge answer-query --query="How do I create a BigQuery dataset?"
gcloud developer-knowledge documents search-chunks --query="Firestore transactions"
gcloud developer-knowledge documents describe "documents/docs.cloud.google.com/storage/docs/creating-buckets"

answer-query는 자연어 질문에 근거 답변을 요청하고, search-chunks는 관련 문서 조각을 찾습니다. describe는 특정 문서의 메타데이터와 내용을 가져옵니다. 발표는 오류 메시지를 파일에 담아 --query="$(cat error.txt)"처럼 그대로 질문으로 넘기는 예도 보여 줍니다. 빌드 오류가 났을 때 관련 공식 문서를 근거로 원인을 찾는 용도입니다. 발표는 Cloud Shell에 사전 설치되고 일반 Google Cloud SDK의 Linux·macOS·Windows 환경에서도 별도 플러그인 없이 쓸 수 있다고 안내합니다. 이는 명령 제공 설명이며 프로젝트 선택·인증은 별도 환경 설정 절차에 나옵니다. (CLI 제공 안내 · 인증 안내)

공식 스킬은 에이전트의 작업을 어떻게 바꿉니까?

스킬은 에이전트에게 문서를 언제, 어떤 순서로 찾을지 알려 주는 작업 지침입니다. Google의 스킬은 searchDocumentChunks로 조각부터 살핀 뒤 documents.get으로 전체 Markdown을 가져오거나 answerQuery로 근거 답변을 받도록 안내합니다. 필요한 내용을 먼저 좁혀 읽는 흐름이므로 문서 전체를 매번 문맥에 넣는 작업을 줄이는 데 목적이 있습니다. (공식 스킬 설명)

발표에 나온 설치 명령은 다음과 같습니다. 이 명령은 프로젝트에 스킬을 추가하며 API 서버 인증은 별도로 설정합니다. MCP(Model Context Protocol)는 에이전트가 외부 도구를 호출하는 연결 규약입니다. 이 스킬은 MCP를 이용하며 필요한 경우 REST API를 사용하는 대체 경로도 안내합니다. 발표는 Antigravity·Claude Code·Cursor·GitHub Copilot과 자체 에이전트 프레임워크를 예로 듭니다. (설치와 연결 안내)

npx skills add google/skills --skill retrieving-developer-knowledge

Codex의 제공·이용 조건과 설정은 무엇입니까?

Google의 로컬 개발 환경 설정 문서는 조직 관리자에게 계정 마련, 프로젝트 접근 및 IAM 역할 부여, Cloud Billing 활성화를 요청하는 절차로 시작합니다. IAM은 프로젝트에서 어떤 작업을 할 수 있는지 정하는 권한 체계입니다. 이 절차는 Google Cloud 개발 환경 전반의 안내이고, Developer Knowledge API 문서는 API를 켜고 쓰는 데 별도 IAM 역할이 필요 없다고 적습니다. 필요한 것은 API를 켤 Google Cloud 프로젝트입니다. (API 시작 안내) CLI 환경은 gcloud init으로 로그인과 기본 프로젝트를 선택하고, 로컬 라이브러리는 gcloud auth application-default login으로 ADC(Application Default Credentials)를 설정하도록 안내합니다. ADC는 라이브러리가 사용할 기본 인증 정보입니다.

같은 문서의 Codex CLI 절에는 아래 순서가 나옵니다. 스킬 한 개만 추가하는 앞의 명령과 달리 google-cloud-developer 플러그인은 Google 작업용 스킬, 필요한 스킬을 찾는 기능, Developer Knowledge 원격 MCP 연결을 묶습니다. API 활성화는 프로젝트 설정을 바꾸는 명령이며 YOUR_PROJECT_ID는 사용할 프로젝트 ID로 바꿉니다. (Codex 설치 절차)

codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins
gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

그다음 문서의 API 키 생성·보호 안내를 따라 키를 준비하고, 사용자 설정 ~/.codex/config.toml 또는 프로젝트의 .codex/config.toml에 아래 연결 정보를 넣습니다. 실제 키 값은 설정에 직접 쓰지 않고 DEVELOPERKNOWLEDGE_API_KEY 환경 변수로 전달하는 예시입니다. (인증 설정 원문)

[mcp_servers.developer-knowledge]
url = "https://developerknowledge.googleapis.com/mcp"
env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }

환경 변수는 Codex를 시작하기 전에 설정합니다. Windows PowerShell에서는 해당 세션에 $env:DEVELOPERKNOWLEDGE_API_KEY로 값을 지정할 수 있습니다. 이 문서가 보여 주는 인증 방식은 API 키 헤더이며, 설정 후 MCP 서버 상태가 not logged in으로 표시돼도 접근을 막지 않는다고 안내합니다. 한국 계정의 API/MCP 실제 이용 가능 여부와 처리 지역은 미확인입니다. 국내 제공과 국내 데이터 처리는 연결 주소와 별도로 확인할 조건입니다. (Google 환경 설정 문서)

앱 코드와 APIs Explorer에서는 어떻게 이용합니까?

클라이언트 라이브러리는 문서 검색을 자체 개발 도구나 백엔드에 넣을 때 쓰는 경로입니다. C#·Go·Java·Node.js/TypeScript·PHP·Python·Ruby에서 AnswerQuery, SearchDocumentChunks, GetDocument, BatchGetDocuments를 사용할 수 있다고 안내합니다. 일괄 가져오기는 한 API 호출로 최대 20개 문서를 받는 기능입니다. 예를 들어 여러 제품의 문서를 근거로 답하는 사내 도구라면 관련 문서를 모으는 단계에 연결할 수 있습니다. (라이브러리 기능·언어 안내)

발표의 Python 예시는 제품의 최신 릴리스 노트를 검색해 반환된 조각의 텍스트를 모으는 코드입니다. 문서 변경을 확인하는 작업에 검색을 붙이는 구체적인 사례입니다. 라이브러리는 ADC 인증, 자동 재시도, 구조화된 인용 추적도 지원한다고 설명합니다. APIs Explorer는 코드를 작성하지 않고 요청과 응답 구조를 시험하는 대화형 도구입니다. CLI에서 답을 받아 보는 단계, Explorer에서 요청 형식을 살피는 단계, 라이브러리로 앱에 통합하는 단계 중 자신의 작업에 맞는 경로를 고를 수 있습니다. (Python 예시와 Explorer 설명)

비용·요금은 어디까지 확인됐습니까?

2026년 10월 8일 확인한 발표와 환경 설정 문서에서는 Developer Knowledge API의 호출 단가·무료 한도·초과 요금을 찾지 못했습니다. 환경 설정 문서는 Cloud Billing 활성화를 전제로 적지만, 이 조건만으로 Developer Knowledge API 호출마다 요금이 발생한다고 계산할 수도 없습니다. API 자체 가격은 미확인입니다. 공식 할당량 문서에는 프로젝트당 기본 한도가 나옵니다. 근거 답변 AnswerQuery는 하루 50회, 문서 가져오기(GetDocument·BatchGetDocuments 합산)와 문서 조각 검색은 각각 분당 100회입니다. 근거 답변 한도가 특히 작으므로 여러 사람이 한 프로젝트를 함께 쓰거나 에이전트가 반복 질문하는 구조라면, 검색과 문서 가져오기를 먼저 쓰고 근거 답변은 아껴 쓰는 설계가 맞습니다. (할당량 문서 · 발표 · 결제 전제 조건)

문서 검색 API의 비용과 이를 호출하는 코딩 에이전트의 모델·구독 비용은 서로 다른 항목입니다. 도입을 검토한다면 API 가격과 프로젝트의 실제 이용 조건을 확인한 뒤, 같은 문서 질문에 대한 검색 호출 수와 에이전트 입력량을 비교하는 방법이 있습니다. 검색 호출 수와 에이전트 입력량을 함께 기록하면 비용이 어디서 달라지는지 알 수 있습니다.

반응 (2026년 10월 8일 확인 기준)

공개된 사용자 반응은 아직 확인되지 않았습니다.

참고한 자료

확인일은 2026년 10월 8일입니다. 설치·API 호출·한국 계정 연결은 직접 시험하지 않았습니다.