experiment 테스트 및 의견 수집 목적으로만 사용되는 실험 버전의 API입니다.

개발자 지식 MCP 서버에 연결

Google Developer Knowledge MCP 서버를 사용하면 AI 기반 개발 도구에서 Google의 공식 개발자 문서를 검색하고 Firebase, Google Cloud, Android, 지도 등 Google 제품의 정보를 검색할 수 있습니다. AI 애플리케이션을 Google의 공식 문서 라이브러리에 바로 연결하면 제공되는 코드와 안내가 최신 상태이고 공신력 있는 컨텍스트를 기반으로 합니다.

서버를 설정하면 통합 도구를 사용하여 다음과 같은 요청을 처리할 수 있습니다.

구현 가이드라인
- 예: Android 앱에서 Firebase 클라우드 메시징을 사용하여 푸시 알림을 구현하는 가장 좋은 방법은 무엇인가요?
코드 생성 및 설명
- 예를 들면 다음과 같습니다. Cloud Storage 프로젝트의 모든 버킷을 나열하는 Python 예제를 Google 문서에서 검색해 줘.
문제 해결 및 디버깅
- 예: Google 지도 API 키에 '개발 전용' 워터마크가 표시되는 이유는 무엇인가요?
비교 분석 및 요약
- 예를 들면 다음과 같습니다. 새 마이크로서비스에 Cloud Run과 Cloud Functions 중 어떤 것을 선택해야 할지 알려 줘. 기본 사용 사례, 동시성, 가격 책정 모델과 같은 주요 측면을 비교하는 마크다운 표를 만들어 줘.

MCP 서버 기능

Google Developer Knowledge MCP 서버는 AI 애플리케이션에 다음 도구를 제공합니다.

도구 이름	설명
`search_documents`	Google의 개발자 문서 (Firebase, Google Cloud, Android, 지도 등)를 검색하여 질문과 관련된 페이지와 스니펫을 찾습니다. 검색 결과의 `parent`와 함께 `get_documents`를 사용하여 전체 페이지 콘텐츠를 가져옵니다.
`get_documents`	`search_documents` 결과의 `parent`를 사용하여 여러 문서의 전체 콘텐츠를 가져옵니다.

search_documents 도구는 AI 기반 검색 및 검색에 최적화된 더 작은 텍스트 청크로 문서를 나눕니다. 검색하면 도구에서 질문과 관련된 하나 이상의 문서 스니펫을 반환합니다. 스니펫을 둘러싼 전체 페이지 콘텐츠를 확인해야 하는 경우 검색 결과에 제공된 parent와 함께 get_documents를 사용하여 전체 페이지 콘텐츠를 가져옵니다.

설치

Google Developer Knowledge MCP 서버는 Developer Knowledge API를 사용하여 문서를 검색하고 가져오는 원격 MCP 서버입니다. OAuth 또는 API 키를 사용하여 인증할 수 있습니다.

OAuth를 사용하여 인증

이 섹션에서는 OAuth를 사용하여 개발자 지식 MCP 서버로 AI 애플리케이션을 인증하는 과정을 안내합니다.

필수사항: Google Cloud CLI 설정

계속하기 전에 다음 사항을 확인하세요.

1단계: 프로젝트에서 Developer Knowledge API 사용 설정

Google API 라이브러리에서 Developer Knowledge API 페이지를 엽니다.
API를 사용할 프로젝트가 올바르게 선택되어 있는지 확인합니다.
사용 설정을 클릭합니다. API를 사용 설정하거나 사용하는 데 필요한 특정 IAM 역할은 없습니다.

2단계: 인증 방법 선택하기

선택하는 인증 방법은 AI 어시스턴트가 gcloud CLI를 사용하여 애플리케이션 기본 사용자 인증 정보(ADC)를 지원하는지 아니면 독립형 OAuth 클라이언트 ID가 필요한지에 따라 달라집니다. Gemini CLI와 같은 어시스턴트는 기존 Google Cloud 로그인을 사용하여 원활하게 설정할 수 있지만, Antigravity와 같은 다른 어시스턴트는 보안 연결을 설정하기 위해 사용자 인증 정보를 직접 만들어 제공해야 합니다.

특정 AI 어시스턴트의 설정 요구사항에 해당하는 탭을 선택합니다.

ADC

내 계정 연결

MCP 서버가 사용자를 대신하여 작업을 실행할 수 있는 권한을 부여하려면 PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿔서 다음 명령어를 실행합니다.
```
gcloud auth application-default login
--project=PROJECT_ID
```
메시지가 표시되면 계정을 선택하고 계속을 클릭합니다.

AI 애플리케이션 구성

인증이 완료되면 마지막 단계는 AI 애플리케이션에 서버 구성 세부정보를 제공하는 것입니다. 정확한 JSON 구조는 애플리케이션에 따라 다르지만 다음 예시를 템플릿으로 사용할 수 있습니다.

Gemini CLI 또는 Gemini Code Assist를 구성하려면 다음 구성 파일 중 하나를 수정하거나 만드세요.

프로젝트에서: .gemini/settings.json
홈 디렉터리에서: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
     },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

MCP 서버가 예상대로 작동하는지 확인하려면 설치 확인으로 계속 진행하세요.

수동 사용자 인증 정보

OAuth 동의 화면 구성

프로젝트의 OAuth 동의 화면을 구성하고 자신을 테스트 사용자로 추가합니다. Google Cloud 프로젝트에서 이 단계를 이미 완료했다면 다음 단계로 건너뛰세요.

Google Cloud 콘솔 인증 개요 페이지를 열고 시작하기를 클릭합니다.
앱 이름을 입력하고 지원 이메일을 선택한 후 다음을 클릭합니다.
대상에서 외부를 선택하고 다음을 클릭합니다.
연락처 정보에 이메일 주소를 입력하고 다음을 클릭합니다.
Google API 서비스: 사용자 데이터 정책을 검토하고 동의한 다음 계속을 클릭합니다.
만들기를 클릭합니다.

테스트 사용자 추가

Google 인증 플랫폼에서 잠재고객을 클릭합니다.
테스트 사용자에서 사용자 추가를 클릭합니다.
이메일 주소와 기타 승인된 테스트 사용자를 입력한 후 저장을 클릭합니다.

OAuth 클라이언트 만들기

최종 사용자로 인증하고 앱에서 사용자 데이터에 액세스하려면 OAuth 2.0 클라이언트 ID를 만들어야 합니다. 클라이언트 ID는 Google OAuth 서버에서 단일 앱을 식별하는 데 사용됩니다.

Google 인증 플랫폼에서 클라이언트를 클릭합니다.
클라이언트 만들기를 클릭합니다.
애플리케이션 유형 선택기에서 데스크톱 앱을 선택합니다.
이름 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
만들기를 클릭합니다. OAuth 클라이언트 생성됨 화면이 표시되고 여기에 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다.
확인을 클릭합니다. 새로 만든 사용자 인증 정보가 OAuth 2.0 클라이언트 ID 아래에 표시됩니다.
새로 만든 클라이언트 ID를 클릭합니다. 클라이언트 보안 비밀 섹션에서 다운로드 아이콘을 클릭하여 JSON 파일을 저장합니다. 이 파일의 client_id 및 client_secret 값은 후속 단계에서 사용됩니다.

AI 애플리케이션 구성

다음으로 AI 애플리케이션에 서버 구성 세부정보를 제공해야 합니다. 정확한 단계는 애플리케이션에 따라 다르지만 다음 예시를 템플릿으로 사용할 수 있습니다.

MCP 서버를 사용하도록 Antigravity를 구성하려면 다음 단계를 따르세요.

Antigravity에서 에이전트 창의 추가 옵션 메뉴 > MCP 서버 > MCP 서버 관리를 클릭합니다.

열린 MCP 서버 관리 창 상단에서 원시 구성 보기를 클릭하여 mcp_config.json 파일을 수정합니다.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}

MCP 서버 관리로 돌아가서 새로고침을 클릭합니다.

OAuth 사용자 인증 정보 추가

개발자 지식 MCP 서버를 처음 사용하려고 하면 AI 어시스턴트에서 설정을 완료하라는 메시지가 표시됩니다.

다음과 같은 프롬프트로 에이전트에게 개발자 지식 MCP 서버를 사용하도록 요청합니다.
```
How do I list Cloud Storage buckets?
```
하나 이상의 리디렉션 URI를 등록하라는 메시지가 표시되면 계속 진행하는 옵션을 클릭합니다. 클라이언트 ID를 데스크톱 앱으로 설정했으므로 Google 인증 플랫폼에 이러한 특정 URI를 추가할 필요가 없습니다.
AI 어시스턴트에서 클라이언트 ID와 클라이언트 보안 비밀을 묻는 메시지가 표시되면 이전에 저장한 클라이언트 보안 비밀 JSON 파일에서 각 키를 붙여넣습니다.
메시지가 표시되면 계정을 선택하고 계속을 클릭합니다.
AI 어시스턴트로 돌아갑니다. 이제 에이전트가 새로 인증된 서버를 사용하여 요청을 처리합니다.

API 키를 사용하여 인증

이 섹션에서는 API 키를 사용하여 개발자 지식 MCP 서버로 AI 애플리케이션을 인증하는 과정을 안내합니다.

1단계: API 키 만들기

Google Cloud 콘솔 또는 gcloud CLI를 사용하여 Google Cloud 프로젝트에서 Developer Knowledge API 키를 생성할 수 있습니다.

Google Cloud Console

API 사용 설정

Google API 라이브러리에서 Developer Knowledge API 페이지를 엽니다.
API를 사용할 프로젝트가 올바르게 선택되어 있는지 확인합니다.
사용 설정을 클릭합니다. API를 사용 설정하거나 사용하는 데 필요한 특정 IAM 역할은 없습니다.

API 키 만들기 및 보안 설정

API를 사용 설정한 프로젝트의 Google Cloud 콘솔에서 사용자 인증 정보 페이지로 이동합니다.
사용자 인증 정보 만들기를 클릭한 후 메뉴에서 API 키를 선택합니다. API 키 생성 완료 대화상자에 새로 생성된 키의 문자열이 표시됩니다.
API 키 수정을 클릭합니다.
이름 필드에 키 이름을 입력합니다.
API 제한사항에서 키 제한을 선택합니다.
API 선택 목록에서 Developer Knowledge API를 사용 설정하고 확인을 클릭합니다.
- 참고: 개발자 지식 API를 방금 사용 설정한 경우 API 선택 목록에 표시되기까지 지연이 발생할 수 있습니다.
저장을 클릭합니다.

키가 생성되면 키 표시를 클릭하여 확인합니다. AI 애플리케이션을 구성할 때 사용할 수 있도록 기록해 둡니다.

gcloud CLI

아직 설치하지 않았다면 gcloud CLI를 다운로드하고 설치합니다.
PROJECT_ID를 Google Cloud 프로젝트 ID로 바꾸어 Developer Knowledge API를 사용 설정합니다.
```
gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
```
동일한 Google Cloud 프로젝트 ID를 사용하여 API 키를 만듭니다.
```
gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
```
이 명령어는 API 키 문자열을 반환합니다. AI 애플리케이션을 구성할 때 사용할 수 있도록 기록해 둡니다.
API 키 제한사항을 추가하여 API 키를 보호합니다. 보안 강화를 위해 API 키를 Developer Knowledge API로 제한하세요.

2단계: 프로젝트에서 개발자 지식 MCP 서버 사용 설정

Google Cloud 프로젝트에서 개발자 지식 MCP 서버를 사용 설정하려면 gcloud CLI를 다운로드하여 설치한 후 다음 명령어를 실행하고 PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Google Cloud 프로젝트에 개발자 지식 서비스가 사용 설정되어 있지 않으면 원격 MCP 서버를 사용 설정하기 전에 서비스를 사용 설정하라는 메시지가 표시됩니다.

보안 권장사항에 따라 AI 애플리케이션이 작동하는 데 필요한 서비스에만 MCP 서버를 사용 설정하는 것이 좋습니다.

3단계: AI 애플리케이션 구성

이 안내에 따라 인기 AI 애플리케이션을 구성하세요. YOUR_API_KEY를 이전 단계에서 생성한 Developer Knowledge API 키로 바꿉니다.

Gemini CLI

Gemini CLI를 구성하려면 다음 명령어를 실행합니다.

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

또는 다음 구성 파일 중 하나를 수정하거나 만듭니다.

프로젝트에서: .gemini/settings.json
홈 디렉터리에서: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Gemini Code Assist를 구성하려면 다음 구성 파일 중 하나를 수정하거나 만드세요.

프로젝트에서: .gemini/settings.json
홈 디렉터리에서: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Claude Code를 구성하려면 앱 폴더에서 다음 명령어를 실행합니다.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

커서

Cursor를 구성하려면 .cursor/mcp.json (특정 프로젝트의 경우) 또는 ~/.cursor/mcp.json (모든 프로젝트의 경우)을 수정합니다.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

단일 프로젝트에 대해 VS Code에서 GitHub Copilot을 구성하려면 작업공간에서 .vscode/mcp.json 파일을 수정합니다.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

모든 프로젝트에서 서버를 사용할 수 있도록 하려면 사용자 설정을 수정합니다. 설정 열기 (JSON) 버튼을 클릭합니다.

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Windsurf

Windsurf Editor를 구성하려면 ~/.codeium/windsurf/mcp_config.json 파일을 수정합니다.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

설치 확인

구성 후 AI 애플리케이션을 열고 다음과 같은 프롬프트를 입력합니다.

How do I list Cloud Storage buckets?

search_documents 또는 다른 개발자 지식 MCP 서버 도구에 대한 도구 호출이 표시되면 서버가 올바르게 작동하는 것입니다.

토큰 사용량 관리

문서 콘텐츠를 가져오는 작업(특히 batch_get_documents 사용 시)은 AI 애플리케이션의 컨텍스트 창 내에서 토큰을 사용합니다. 일부 Google 개발자 문서 페이지는 상당히 크기 때문에 여러 문서를 가져오면 비용이 빠르게 증가하고, 모델 응답 시간이 느려지며, 컨텍스트 윈도우가 오버플로될 수 있습니다.

성능을 최적화하고 예상치 못한 청구를 방지하려면 필요한 정보만 타겟팅하는 구체적인 프롬프트를 작성하세요. 에이전트가 한 번에 대량의 데이터를 수집하도록 하는 광범위한 요청('모든 Firebase 제품 비교' 등)은 피하세요.

포함된 문서

서버에서 검색하는 문서에 관한 자세한 내용은 코퍼스 참조를 참고하세요.

알려진 제한사항

콘텐츠 범위: 코퍼스 참조에서 공개적으로 표시되는 페이지만 포함됩니다. GitHub, OSS 사이트, 블로그, YouTube와 같은 다른 소스의 콘텐츠는 포함되지 않습니다.
영어 결과만: 서버는 영어 결과만 지원합니다.
네트워크 종속: 서버의 도구가 실시간 Google Cloud 서비스를 사용합니다. 지속적인 오류가 발생하면 인터넷 연결과 Developer Knowledge API 키 구성을 확인하세요.

문제 해결

문제가 발생하면 다음을 확인하세요.

AI 도구의 MCP 구성 파일 형식이 올바릅니다.
API 인증 방법을 사용하는 경우 Developer Knowledge API가 사용 설정된 구성 파일에서 유효한 Developer Knowledge API 키를 사용했습니다.
Developer Knowledge API 할당량이 소진되지 않았습니다.

Model Armor

Model Armor를 사용하여 애플리케이션을 보호하는 경우 일부 쿼리에 대해 403 PERMISSION_DENIED 오류가 발생할 수 있습니다. 개발자 지식 MCP 서버는 신뢰할 수 있는 Google 소스의 공개 문서만 반환하므로 거짓양성을 줄이기 위해 프롬프트 인젝션 및 탈옥(PIJB) 필터를 HIGH_AND_ABOVE 신뢰도 수준으로 설정하는 것이 좋습니다. 비공개 또는 민감한 데이터에 액세스하는 다른 도구가 사용 사례에 포함되지 않는 경우 PIJB 필터를 사용 중지하는 것도 고려해 볼 수 있습니다.

개발자 지식 MCP 서버에 연결 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

MCP 서버 기능

설치

OAuth를 사용하여 인증

필수사항: Google Cloud CLI 설정

1단계: 프로젝트에서 Developer Knowledge API 사용 설정

2단계: 인증 방법 선택하기

ADC

내 계정 연결

AI 애플리케이션 구성

수동 사용자 인증 정보

OAuth 동의 화면 구성

테스트 사용자 추가

OAuth 클라이언트 만들기

AI 애플리케이션 구성

OAuth 사용자 인증 정보 추가

API 키를 사용하여 인증

1단계: API 키 만들기

Google Cloud Console

API 사용 설정

API 키 만들기 및 보안 설정

gcloud CLI

2단계: 프로젝트에서 개발자 지식 MCP 서버 사용 설정

3단계: AI 애플리케이션 구성

Gemini CLI

Gemini Code Assist

Claude Code

커서

GitHub Copilot

Windsurf

설치 확인

토큰 사용량 관리

포함된 문서

알려진 제한사항

문제 해결

Model Armor

개발자 지식 MCP 서버에 연결