Это экспериментальная версия API, предназначенная исключительно для тестирования и получения обратной связи.

Эта страница переведена с помощью Cloud Translation API.

Подключитесь к серверу Developer Knowledge MCP.

Сервер Google Developer Knowledge MCP предоставляет инструментам разработки на основе ИИ возможность искать информацию в официальной документации Google для разработчиков и получать данные о таких продуктах Google, как Firebase, Google Cloud, Android, Maps и многих других. Подключая ваше ИИ-приложение напрямую к нашей официальной библиотеке документации, вы гарантируете, что получаемый код и рекомендации будут актуальными и основанными на авторитетном контексте.

После настройки сервера интегрированные инструменты могут помочь с такими запросами, как:

Руководство по внедрению
- Например: Как лучше всего реализовать push-уведомления с помощью Firebase Cloud Messaging в Android-приложении?
Генерация и объяснение кода
- Например: найдите в документации Google пример на Python для вывода списка всех сегментов в проекте Cloud Storage.
Поиск и устранение неисправностей
- Например: Почему мой ключ API Google Maps отображается с водяным знаком «Только для целей разработки»?
Сравнительный анализ и обобщение
- Например: Помогите мне выбрать между Cloud Run и Cloud Functions для нового микросервиса. Создайте таблицу в формате Markdown, которая сравнивает ключевые аспекты, такие как основной сценарий использования, параллелизм и модель ценообразования.

Возможности сервера MCP

Сервер Google Developer Knowledge MCP предоставляет вашему приложению на основе искусственного интеллекта следующие инструменты:

Название инструмента Описание

search_documents Выполняет поиск в документации для разработчиков Google (Firebase, Google Cloud, Android, Maps и другие), чтобы найти релевантные страницы и фрагменты кода для вашего запроса. Используйте get_documents с parent из результатов поиска, чтобы получить полное содержимое страницы.

get_documents Получает полное содержимое нескольких документов, используя parent элементы из результатов search_documents .

Название инструмента	Описание
`search_documents`	Выполняет поиск в документации для разработчиков Google (Firebase, Google Cloud, Android, Maps и другие), чтобы найти релевантные страницы и фрагменты кода для вашего запроса. Используйте `get_documents` с `parent` из результатов поиска, чтобы получить полное содержимое страницы.
`get_documents`	Получает полное содержимое нескольких документов, используя `parent` элементы из результатов `search_documents` .

Инструмент search_documents разбивает документ на более мелкие фрагменты текста, оптимизированные для поиска и извлечения информации с помощью искусственного интеллекта. При поиске инструмент возвращает один или несколько фрагментов документа, релевантных вашему запросу. Если вам нужно просмотреть полное содержимое страницы, окружающее фрагмент, используйте get_documents с указанием parent в результатах поиска, чтобы получить полное содержимое страницы.

Установка

Сервер Google Developer Knowledge MCP — это удалённый сервер MCP, использующий API Developer Knowledge для поиска и получения документации. Аутентификация может осуществляться с помощью OAuth или ключа API .

Аутентификация с использованием OAuth

В этом разделе описан процесс аутентификации вашего приложения искусственного интеллекта на сервере Developer Knowledge MCP с использованием протокола OAuth.

Предварительное условие: настройка Google Cloud CLI.

Прежде чем продолжить, убедитесь, что у вас есть:

Шаг 1: Включите API базы знаний для разработчиков в проекте.

Откройте страницу API для разработчиков в библиотеке API Google.
Убедитесь, что вы выбрали правильный проект, в котором планируете использовать API.
Нажмите «Включить» . Для включения или использования API не требуются специальные роли IAM.

Шаг 2: Выберите способ аутентификации

Выбор метода аутентификации зависит от того, поддерживает ли ваш ИИ-помощник учетные данные приложения по умолчанию (ADC) с помощью CLI gcloud или требует отдельного идентификатора клиента OAuth. Такие помощники, как Gemini CLI, могут использовать вашу существующую учетную запись Google Cloud для простой настройки, в то время как другие, например Antigravity, требуют от вас вручную создать и указать собственные учетные данные для установления безопасного соединения.

Выберите вкладку, соответствующую требованиям к настройке вашего конкретного ИИ-помощника.

АЦП

Подключите свой аккаунт

Чтобы предоставить серверу MCP возможность действовать от вашего имени, выполните следующую команду, заменив PROJECT_ID на идентификатор вашего проекта Google Cloud:
```
gcloud auth application-default login
--project=PROJECT_ID
```
При появлении запроса выберите учетную запись, затем нажмите «Продолжить» .

Настройте ваше приложение на основе ИИ.

После аутентификации последним шагом является предоставление вашему ИИ-приложению сведений о конфигурации сервера. Хотя точная структура 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 Auth Platform нажмите «Аудитория» .
В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
Введите свой адрес электронной почты и имена других авторизованных пользователей, затем нажмите «Сохранить» .

Создайте OAuth-клиент

Для аутентификации в качестве конечного пользователя и доступа к пользовательским данным в вашем приложении необходимо создать идентификатор клиента OAuth 2.0. Идентификатор клиента используется для идентификации отдельного приложения на серверах OAuth Google.

В платформе аутентификации Google нажмите «Клиенты» .
Нажмите «Создать клиента» .
В поле выбора типа приложения выберите «Настольное приложение» .
В поле «Имя» введите имя для учетных данных. Это имя отображается только в консоли Google Cloud.
Нажмите «Создать» . Появится экран создания клиента OAuth, на котором отобразятся ваш новый идентификатор клиента и секретный ключ клиента.
Нажмите ОК . Созданные учетные данные отобразятся в разделе «Идентификаторы клиентов OAuth 2.0» .
Щелкните по созданному идентификатору клиента. В разделе «Секреты клиента » щелкните значок загрузки, чтобы сохранить JSON-файл. Значения client_id и client_secret из этого файла вы будете использовать на следующем шаге .

Настройте ваше приложение на основе ИИ.

Далее вам необходимо предоставить вашему ИИ-приложению данные для настройки сервера. Хотя точная последовательность шагов может различаться в зависимости от приложения, вы можете использовать следующий пример в качестве шаблона.

Чтобы настроить Antigravity для использования сервера MCP:

В Antigravity в панели агента выберите пункт « Дополнительные параметры > «Серверы MCP» > «Управление серверами MCP» .
В верхней части открывшейся панели «Управление серверами MCP» нажмите «Просмотреть исходную конфигурацию» , чтобы отредактировать файл mcp_config.json :
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
Вернитесь к разделу «Управление серверами MCP» и нажмите «Обновить» .

Добавить учетные данные OAuth

При первом использовании сервера Developer Knowledge MCP ваш ИИ-помощник предложит вам завершить настройку:

Попросите агента использовать сервер Developer Knowledge MCP, выведя следующую команду:
```
How do I list Cloud Storage buckets?
```
Если вы видите сообщение с просьбой зарегистрировать один или несколько URI перенаправления, нажмите кнопку «Продолжить». Поскольку вы настроили идентификатор клиента как настольное приложение, нет необходимости добавлять эти конкретные URI в платформу аутентификации Google.
Когда ваш ИИ-помощник запросит у вас идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret ), вставьте соответствующие ключи из JSON-файла с секретным ключом клиента, который вы сохранили ранее .
При появлении запроса выберите учетную запись, затем нажмите «Продолжить» .
Вернитесь к своему ИИ-помощнику. Теперь агент обработает ваш запрос, используя недавно прошедший аутентификацию сервер.

Аутентификация с использованием ключа API.

В этом разделе описан процесс аутентификации вашего приложения искусственного интеллекта на сервере Developer Knowledge MCP с использованием ключа API.

Шаг 1: Создайте ключ API.

Вы можете сгенерировать ключ API для разработчиков в своем проекте Google Cloud, используя либо консоль Google Cloud, либо интерфейс командной строки gcloud:

Консоль Google Cloud

Включить API

Откройте страницу API для разработчиков в библиотеке API Google.
Убедитесь, что вы выбрали правильный проект, в котором планируете использовать API.
Нажмите «Включить» . Для включения или использования API не требуются специальные роли IAM.

Создайте и защитите ключ API.

В консоли Google Cloud для проекта, в котором вы включили API, перейдите на страницу «Учетные данные» .
Нажмите «Создать учетные данные» , а затем выберите «Ключ API» в меню. В диалоговом окне создания ключа API отобразится строка для вашего нового ключа.
Нажмите «Редактировать ключ API» .
В поле «Имя» укажите имя для ключа.
В разделе «Ограничения API» выберите «Ограничить ключ» .
В списке «Выберите API» включите Developer Knowledge API и нажмите «ОК» .
- Примечание: Если вы только что включили API базы знаний для разработчиков, может быть задержка, прежде чем он появится в списке выбранных API .
Нажмите « Сохранить ».

После создания ключа нажмите «Показать ключ» , чтобы просмотреть его. Запишите его для использования при настройке вашего приложения на основе ИИ .

gcloud CLI

Если вы еще этого не сделали, скачайте и установите gcloud CLI .
Включите API базы знаний для разработчиков, заменив PROJECT_ID на идентификатор вашего проекта Google Cloud:
```
gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
```
Создайте ключ API, используя тот же идентификатор проекта Google Cloud:
```
gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
```
Эта команда возвращает строку с ключом API. Запишите её, чтобы использовать при настройке вашего приложения на основе ИИ .
Защитите свой API-ключ, добавив ограничения на его использование . Для повышения уровня безопасности ограничьте доступ к API-ключу только для API базы знаний разработчиков.

Шаг 2: Включите сервер Developer Knowledge MCP в проекте.

Чтобы включить сервер Developer Knowledge MCP в вашем проекте Google Cloud, загрузите и установите CLI gcloud , а затем выполните следующую команду, заменив PROJECT_ID на идентификатор вашего проекта Google Cloud:

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

Если для вашего проекта Google Cloud не включена служба Developer Knowledge, вам будет предложено включить эту службу перед включением удаленного сервера MCP.

В целях обеспечения безопасности мы рекомендуем включать серверы MCP только для тех служб, которые необходимы для функционирования вашего приложения искусственного интеллекта.

Шаг 3: Настройка вашего приложения на основе ИИ.

Настройте популярные приложения ИИ, следуя этим инструкциям. Замените YOUR_API_KEY на ключ 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 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

Чтобы настроить GitHub Copilot в VS Code для отдельного проекта, отредактируйте файл .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 отредактируйте файл ~/.codeium/windsurf/mcp_config.json .

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

Проверьте установку

После настройки откройте приложение с искусственным интеллектом и введите запрос, например:

How do I list Cloud Storage buckets?

Если вы видите вызов инструмента search_documents или другого инструмента сервера Developer Knowledge MCP, значит, сервер работает корректно.

Управление использованием токенов

Получение содержимого документа, особенно при использовании batch_get_documents , расходует токены в контекстном окне вашего ИИ-приложения. Поскольку некоторые страницы документации для разработчиков Google довольно большие, получение нескольких документов может быстро привести к увеличению затрат, замедлению времени отклика модели и переполнению контекстного окна.

Чтобы оптимизировать производительность и избежать неожиданных расходов, создавайте конкретные запросы, ориентированные только на необходимую информацию. Избегайте общих запросов (например, «Сравнить все продукты Firebase»), которые заставляют агент обрабатывать огромные объемы данных одновременно.

Включенная документация

См. справочник по корпусу для получения информации о том, какие документы ищутся на сервере.

Известные ограничения

Содержание: Включены только общедоступные страницы из эталонного корпуса . Контент из других источников, таких как GitHub, сайты с открытым исходным кодом, блоги или YouTube, не включен.
Результаты только на английском языке: Сервер поддерживает результаты только на английском языке.
Зависимость от сети : Инструменты сервера используют работающие сервисы Google Cloud. Если вы постоянно сталкиваетесь с ошибками, проверьте подключение к интернету и конфигурацию ключа API для разработчиков.

Поиск неисправностей

Если возникнут проблемы, проверьте следующее:

Файл конфигурации MCP для вашего инструмента искусственного интеллекта отформатирован правильно.
Если вы используете метод аутентификации API , значит, в вашем конфигурационном файле указан действительный ключ API для разработчиков, и API для разработчиков включен .
Вы не исчерпали квоту на использование API знаний для разработчиков .

Модель брони

Если вы используете Model Armor для защиты своего приложения, при выполнении некоторых запросов могут возникать ошибки 403 PERMISSION_DENIED . Поскольку сервер Developer Knowledge MCP возвращает только общедоступную документацию из надежных источников Google, мы рекомендуем установить фильтры Prompt Injection and Jailbreak (PIJB) на уровень достоверности HIGH_AND_ABOVE чтобы уменьшить количество ложных срабатываний. Если ваш сценарий использования не предполагает использования других инструментов, получающих доступ к конфиденциальным или секретным данным, вы также можете рассмотреть возможность отключения фильтров PIJB.

Подключитесь к серверу Developer Knowledge MCP. Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Возможности сервера MCP

Установка

Аутентификация с использованием OAuth

Предварительное условие: настройка Google Cloud CLI.

Шаг 1: Включите API базы знаний для разработчиков в проекте.

Шаг 2: Выберите способ аутентификации

АЦП

Подключите свой аккаунт

Настройте ваше приложение на основе ИИ.

Ручные учетные данные

Настройте экран согласия OAuth.

Добавить тестовых пользователей

Создайте OAuth-клиент

Настройте ваше приложение на основе ИИ.

Добавить учетные данные OAuth

Аутентификация с использованием ключа API.

Шаг 1: Создайте ключ API.

Консоль Google Cloud

Включить API

Создайте и защитите ключ API.

gcloud CLI

Шаг 2: Включите сервер Developer Knowledge MCP в проекте.

Шаг 3: Настройка вашего приложения на основе ИИ.

Gemini CLI

Gemini Code Assist

Кодекс Клода

Курсор

GitHub Copilot

Виндсёрфинг

Проверьте установку

Управление использованием токенов

Включенная документация

Известные ограничения

Поиск неисправностей

Модель брони

Подключитесь к серверу Developer Knowledge MCP.