Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Conéctate al servidor de MCP de Developer Knowledge

El servidor de MCP de Google Developer Knowledge brinda a las herramientas de desarrollo potenciadas por IA acceso directo para buscar y recuperar documentación oficial para desarrolladores de Google para productos como Firebase, Google Cloud, Android, Google Maps Platform y muchos más. Cuando conectas tu asistente de codificación a la biblioteca autorizada de documentación de Google, evitas las búsquedas manuales en la Web, el contexto desactualizado y el scraping.

Funciones del servidor de MCP

El servidor de MCP de Google Developer Knowledge proporciona tres herramientas principales a tu asistente de codificación de IA:

Nombre de la herramienta	Descripción
`search_documents`	Busca en la documentación para desarrolladores de Google y muestra los fragmentos de página más relevantes junto con sus nombres de documento.
`get_documents`	Recupera el contenido completo de Markdown de los documentos con los nombres que muestra `search_documents`.
`answer_query`	Genera respuestas estructuradas y sintetizadas basadas en el corpus de Developer Knowledge.

La herramienta search_documents busca en la documentación de Google para encontrar las secciones más relevantes que coincidan con tu consulta. Cuando haces una pregunta, la herramienta muestra pasajes de texto cortos. Si tu agente necesita el contexto completo de la página que rodea un pasaje, puede pasar el nombre del recurso del documento a get_documents para recuperar toda la página.

Usa la herramienta answer_query cuando quieras una respuesta directa a una pregunta sintetizada del corpus de Developer Knowledge en lugar de resultados de búsqueda sin procesar o archivos de Markdown completos.

Elige tu método de autenticación

El servidor de MCP de Developer Knowledge admite dos métodos de autenticación según tu entorno de desarrollo y el asistente de IA:

Clave de API: Es la mejor opción para IDEs y agentes de CLI de terceros, como Claude Code, Cursor, GitHub Copilot, Codex y otros clientes de MCP remotos. Pasa la clave de API en el encabezado X-Goog-Api-Key a través de HTTPS.
OAuth y ADC: Es la mejor opción para Google Antigravity o flujos de trabajo empresariales que usan credenciales predeterminadas de la aplicación (ADC) o un ID de cliente de OAuth 2.0 independiente.

Genera las credenciales necesarias para el método de autenticación elegido para permitir que tu asistente de IA o agente de codificación autentiquen las solicitudes con el servicio del servidor de MCP de Developer Knowledge.

Selecciona una pestaña para crear tus credenciales:

Clave de API

Requisitos previos

Antes de crear una clave de API, asegúrate de tener lo siguiente:

Un proyecto de Google Cloud.
La CLI de gcloud instalada (si la configuras desde la línea de comandos).

Habilita la API y crea una clave de API

Puedes generar una clave de API con la consola de Google Cloud o la CLI de gcloud:

Consola de Google Cloud

Abre la página de la API de Developer Knowledge en la consola de Google Cloud.
Selecciona tu proyecto de Google Cloud y haz clic en Habilitar.
Ve a la página Credenciales.
Haz clic en Crear credenciales y selecciona Clave de API.
Haz clic en la acción Editar clave de API para configurar las restricciones:
- En Restricciones de API, elige Restringir clave.
- Selecciona API de Developer Knowledge.
- Si planeas usar esta misma clave para las llamadas al modelo (como GEMINI_API_KEY), selecciona también API de Generative Language.
Haz clic en Guardar y, luego, copia tu clave de API.

gcloud CLI

Habilita la API de Developer Knowledge en tu proyecto y reemplaza PROJECT_ID por el ID de tu proyecto:
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
Crea una clave de API:
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
Este comando muestra detalles de metadatos sobre tu nueva clave. Copia y guarda los siguientes valores del resultado del comando:
- keyString: Es la clave de API sin procesar (por ejemplo, AIzaSy...). Pegarás este valor en la configuración de tu IDE.
- name: Es la ruta de acceso del recurso de la clave (por ejemplo, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Usarás esta ruta para restringir la clave en el siguiente paso.
Restringe la clave a la API de Developer Knowledge para evitar el uso no autorizado. Reemplaza KEY_NAME por la ruta de acceso name completa copiada del paso anterior:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
Importante: Si planeas usar esta misma clave para las llamadas al modelo general de tu cliente de IA (por ejemplo, GEMINI_API_KEY), también debes permitir la API de Generative Language:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth y ADC

Requisitos previos

Antes de configurar OAuth, asegúrate de tener lo siguiente:

Habilita la API

Ejecuta el siguiente comando para habilitar la API de Developer Knowledge en tu proyecto:

gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID

Elige tu tipo de credencial de OAuth

Selecciona el enfoque de credenciales que requiere tu herramienta:

Credencial predeterminada de la aplicación

Si tu asistente de IA admite ADC (como Google Antigravity), haz lo siguiente:

Autentícate con tu Cuenta de Google y configura tu proyecto de cuota:

gcloud auth application-default login \
  --project=PROJECT_ID

Cuando se abra el navegador, accede con tu Cuenta de Google y otorga los permisos solicitados.

ID de cliente de OAuth

Si tu asistente de IA requiere un cliente de OAuth y un secreto independientes, haz lo siguiente:

Abre la Pantalla de consentimiento de OAuth.
Establece el tipo de usuario en Externo, completa el nombre de la app y el correo electrónico de asistencia obligatorios, y haz clic en Guardar y continuar.
En la página Público, haz clic en Agregar usuarios en Usuarios de prueba, ingresa tu dirección de correo electrónico de Google y haz clic en Guardar.
Ve a la página Clientes, haz clic en Crear cliente y establece Tipo de aplicación en Aplicación para computadoras.
Haz clic en Crear y, luego, descarga el archivo JSON de credenciales de cliente.

Configura tu IDE o agente de codificación

Después de obtener tus credenciales, selecciona tu entorno de codificación preferido para ver las instrucciones de configuración.

Según el método de autenticación elegido, reemplaza los marcadores de posición en las plantillas de configuración de la siguiente manera:

Autenticación de la clave de API: Reemplaza YOUR_API_KEY con tu cadena de clave de API sin procesar.
Autenticación de OAuth o ADC: Reemplaza PROJECT_ID por el ID de tu proyecto de Google Cloud:

Google Antigravity

IDE de Antigravity y extensiones

Para configurar el servidor de MCP en el IDE de Antigravity o la extensión de Antigravity (como en VS Code), selecciona tu método de autenticación:

Credenciales de Google

Para instalar el servidor de MCP con la configuración de un solo clic, haz lo siguiente:

En el panel Agent, haz clic en el menú Opciones adicionales () y selecciona Servidores de MCP.
Busca Google Developer Knowledge.
Haz clic en el ícono Instalar (). Antigravity configura automáticamente el servidor y se conecta con tus credenciales de Google activas.

Clave de API

Para configurar una clave de API en el IDE de Antigravity o la extensión de Antigravity, haz lo siguiente:

En el panel Agent, haz clic en el menú Opciones adicionales () > Servidores de MCP > Administrar servidores de MCP > Ver configuración sin procesar (o abre .agents/mcp_config.json).

Agrega la siguiente configuración del servidor:

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

CLI de Antigravity

Configura el servidor de MCP en el archivo .agents/mcp_config.json de tu proyecto (o de forma global en ~/.gemini/config/mcp_config.json):

Credenciales de Google

{
  "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"
      }
    }
  }
}

Clave de API

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

Claude Code

Ejecuta el siguiente comando en la terminal:

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

Cursor

Para configurar Cursor, edita .cursor/mcp.json en la raíz de tu proyecto o ~/.cursor/mcp.json para el acceso global:

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

GitHub Copilot

Configuración del lugar de trabajo

Para configurar GitHub Copilot en VS Code para un lugar de trabajo específico, crea o edita .vscode/mcp.json:

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

Configuración global del usuario

Para que el servidor esté disponible en todos los lugares de trabajo de VS Code, abre la configuración del usuario (JSON) y agrega lo siguiente en la clave "mcp":

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

Codex

Para configurar la CLI de Codex o el agente de Codex, agrega la configuración del servidor a ~/.codex/config.json (o .codex/config.json de tu proyecto):

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

Otro

Para configurar cualquier otro cliente de MCP remoto (como el asistente de IA de JetBrains, Windsurf, Cline, Zed, Continue o Claude Desktop), configura un servidor de transporte HTTP con los siguientes parámetros de configuración:

URL del servidor: https://developerknowledge.googleapis.com/mcp
Encabezado HTTP: X-Goog-Api-Key: YOUR_API_KEY

Plantilla de configuración JSON estándar:

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

Verifica la conexión

Una vez configurado, reinicia tu asistente de IA o vuelve a cargar sus servidores de MCP. Luego, envía una instrucción de prueba para verificar que la integración de la herramienta funcione:

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

Si el agente invoca search_documents o answer_query y muestra información de la documentación de Google, tu servidor está conectado y activo.

Optimiza la ventana de contexto y el uso de tokens

Recuperar páginas completas de documentación en la ventana de contexto de un modelo de IA consume tokens significativos. Ingerir varios documentos grandes puede generar costos de tokens altos, mayor latencia y desbordamiento de la ventana de contexto.

Para garantizar respuestas rápidas y rentables, sigue estas prácticas recomendadas de ingeniería de instrucciones:

Confía en la recuperación de dos pasos: Permite que el agente comience llamando a search_documents. Esto muestra fragmentos enfocados (fragmentos) que suelen contener la sintaxis exacta o la firma de la API que necesitas sin consumir tokens para toda la página. Indica a tu agente que llame a get_documents solo cuando el contexto circundante sea estrictamente necesario.
Prefiere answer_query para preguntas conceptuales: Cuando necesites una explicación sintetizada o una comparación de diseño, indica a tu agente que use answer_query. Esta herramienta sintetiza una respuesta directamente del corpus de Developer Knowledge sin mostrar páginas completas de Markdown sin procesar.
Escribe instrucciones específicas y con alcance: Evita las instrucciones demasiado amplias, como "Explica todo Firebase". En su lugar, especifica el producto, la plataforma y el idioma de destino:
```
How do I write a Firestore transaction in Dart with error handling?
```
Agrega reglas de agente personalizadas: Agrega lineamientos a nivel del proyecto a los archivos de instrucciones de tu asistente (por ejemplo, .cursorrules, CLAUDE.md, o .github/copilot-instructions.md) para restringir las recuperaciones automáticas de página completa:
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

Configuraciones de seguridad opcionales

MCP introduce nuevos riesgos y consideraciones de seguridad debido a la amplia variedad de acciones que puedes realizar con las herramientas de MCP. Para minimizar y administrar estos riesgos, Google Cloud ofrece parámetros de configuración predeterminados y políticas personalizables para controlar el uso de las herramientas de MCP en tu organización o proyecto de Google Cloud.

Para obtener más información sobre la seguridad y la administración de MCP, consulta Seguridad de la IA.

Usa Model Armor

Model Armor es un servicio de Google Cloud diseñado para mejorar la seguridad y la seguridad de tus aplicaciones de IA. Funciona analizando de forma proactiva las instrucciones y respuestas de los LLM, protegiendo contra diversos riesgos y admitiendo prácticas de IA responsable. Ya sea que implementes IA en tu entorno de nube o en proveedores de servicios en la nube externos, Model Armor puede ayudarte a evitar entradas maliciosas, verificar la seguridad del contenido, proteger datos sensibles, mantener el cumplimiento y aplicar tus políticas de seguridad de la IA de manera coherente en todo tu diverso panorama de IA.

Cuando Model Armor está habilitado con el registro habilitado, Model Armor registra toda la carga útil. Esto podría exponer información sensible en tus registros.

Enrutamiento de solicitudes de MCP a Model Armor

Model Armor está disponible en ciertas regiones. Cuando Model Armor está habilitado y usas un servidor de MCP en una jurisdicción que Model Armor no admite, el comportamiento de enrutamiento de la llamada puede ser diferente para diferentes servidores de MCP y puede interrumpir el cumplimiento de la residencia de datos para los datos en uso y en tránsito. Para obtener más información sobre el comportamiento de los servidores de MCP individuales, consulta Productos compatibles con Model Armor.

Habilita Model Armor

Sigue los pasos que se indican en Integra con servidores de MCP de Google y Google Cloud para habilitar Model Armor.

Configura la protección para servidores de MCP remotos

Para proteger las llamadas y respuestas de tu herramienta de MCP, puedes usar la configuración mínima de Model Armor. Un parámetro de configuración mínima define los filtros de seguridad mínimos que se aplican en todo el proyecto. Esta configuración aplica un conjunto coherente de filtros a todas las llamadas y respuestas de la herramienta de MCP dentro del proyecto.

Configura un parámetro de configuración mínima de Model Armor con la limpieza de MCP habilitada. Para obtener más información, consulta Configura los parámetros de configuración mínima de Model Armor settings.

Consulta el siguiente comando de ejemplo:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Reemplaza PROJECT_ID por el ID del proyecto de.

Ten en cuenta los siguientes parámetros de configuración:

INSPECT_AND_BLOCK: Es el tipo de aplicación que inspecciona el contenido del servidor de MCP de Google y bloquea las instrucciones y respuestas que coinciden con los filtros.
ENABLED: Es el parámetro de configuración que habilita un filtro o una aplicación.
MEDIUM_AND_ABOVE: Es el nivel de confianza para la configuración del filtro de IA responsable: peligroso. Puedes modificar este parámetro de configuración, aunque los valores más bajos pueden generar más falsos positivos. Para obtener más información, consulta Niveles de confianza de Model Armor.

Inhabilita el análisis del tráfico de MCP con Model Armor

Para evitar que Model Armor analice automáticamente el tráfico hacia y desde los servidores de MCP de Google según la configuración mínima del proyecto, ejecuta el siguiente comando:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Reemplaza PROJECT_ID por el ID del proyecto. Model Armor no aplica automáticamente las reglas definidas en la configuración mínima de este proyecto a ningún tráfico del servidor de MCP de Google.

La configuración mínima de Model Armor y la configuración general pueden afectar a más que solo a MCP. Debido a que Model Armor se integra con servicios como Vertex AI, cualquier cambio que realices en la configuración mínima puede afectar el análisis de tráfico y los comportamientos de seguridad en todos los servicios integrados, no solo en MCP.

Ajusta la configuración de Model Armor

Si usas Model Armor para proteger tu aplicación, es posible que encuentres 403 PERMISSION_DENIED errores para algunas consultas. Debido a que el servidor de MCP de Developer Knowledge solo muestra documentación pública de fuentes confiables de Google, recomendamos configurar los filtros de inyección de instrucciones y jailbreaking (PIJB) en niveles de confianza HIGH_AND_ABOVE para reducir los falsos positivos. Si tu caso de uso no incluye otras herramientas que accedan a datos privados o sensibles, también puedes inhabilitar los filtros de PIJB.

Solución de problemas

Si tienes problemas para conectarte al servidor de MCP de Developer Knowledge o consultarlo, consulta la siguiente matriz de solución de problemas y los pasos de resolución:

Matriz de solución de problemas

Síntoma o error	Causa probable	Solución
`400 Bad Request: API key not valid`	Falta la cadena de clave de API, no es válida o tiene un formato incorrecto.	Verifica que la clave de API se haya copiado correctamente y configurado en el `headers` objeto con la `X-Goog-Api-Key` clave.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	La API de Developer Knowledge no está habilitada en el proyecto de Google Cloud.	Habilita la API en la consola de Google Cloud o ejecuta `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED: API target restriction`	La lista de restricciones de la clave de API excluye la API de Developer Knowledge.	Actualiza las restricciones de la clave de API en la página Credenciales de la consola de Google Cloud para incluir la API de Developer Knowledge.
`401 UNAUTHENTICATED` o faltan credenciales de ADC	Las credenciales predeterminadas de la aplicación vencieron o no se inicializaron.	Ejecuta `gcloud auth application-default login --project=PROJECT_ID` para actualizar las credenciales locales.
`403 access_denied` / "Acceso bloqueado: error de autorización"	Tu cuenta no aparece como un usuario de prueba autorizado en el consentimiento de OAuth.	En Consola de Google Cloud > Plataforma de autenticación > Público, agrega tu dirección de correo electrónico en Usuarios de prueba.
Error del cliente de OAuth o URI de redireccionamiento no válido	El cliente de OAuth se creó con un tipo de aplicación no compatible.	Vuelve a crear tu ID de cliente de OAuth con el tipo establecido en Aplicación para computadoras.
`404 NOT_FOUND` en el extremo `/mcp`	La API no está habilitada para tu proyecto.	Habilita la API de Developer Knowledge en la consola de Google Cloud o ejecuta `gcloud services enable developerknowledge.googleapis.com`.
`429 RESOURCE_EXHAUSTED`	Alcanzaste el límite de cuota de tu proyecto.	Verifica el uso de la cuota de la API de Developer Knowledge en la consola y solicita un aumento de cuota si es necesario.
`403 PERMISSION_DENIED` con Model Armor	Un falso positivo del filtro de PIJB de Model Armor bloqueó una consulta segura.	Establece la confianza del filtro de PIJB en `HIGH_AND_ABOVE` en la configuración de la plantilla de Model Armor.

Resuelve errores de autenticación y consentimiento

Configuración del encabezado de la clave de API: Verifica que tu configuración JSON de MCP incluya la sección headers con "X-Goog-Api-Key". No pases la clave de API como un parámetro de búsqueda en la URL.
Usuarios de prueba de la pantalla de consentimiento de OAuth: Cuando creas un cliente de OAuth para computadoras en un proyecto con un tipo de usuario externo en modo de prueba, Google bloquea el acceso para las cuentas que no aparecen en los usuarios de prueba. Asegúrate de que tu dirección de correo electrónico activa de Google se agregue en Público > Usuarios de prueba en la consola de Google Cloud.
Cuota y límites de frecuencia: Para supervisar tu uso diario y por minuto, ve a IAM y administración > Cuotas y límites del sistema en la consola de Google Cloud y filtra por API de Developer Knowledge.

Documentación incluida

Consulta la referencia del corpus para obtener la lista completa de productos de Google y repositorios de documentación indexados por el servidor.

Limitaciones conocidas

Solo documentación pública: El servidor indexa solo la documentación disponible públicamente que aparece en la referencia del corpus. No se incluyen documentos internos, repositorios privados ni recursos de terceros.
Idioma inglés: El servidor indexa y muestra documentación solo en inglés.
Dependencia de la red: El servidor requiere conectividad a Internet activa para llegar a https://developerknowledge.googleapis.com.

Conéctate al servidor de MCP de Developer Knowledge Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Funciones del servidor de MCP

Elige tu método de autenticación

Clave de API

Requisitos previos

Habilita la API y crea una clave de API

Consola de Google Cloud

gcloud CLI

OAuth y ADC

Requisitos previos

Habilita la API

Elige tu tipo de credencial de OAuth

Credencial predeterminada de la aplicación

ID de cliente de OAuth

Configura tu IDE o agente de codificación

Google Antigravity

IDE de Antigravity y extensiones

Credenciales de Google

Clave de API

CLI de Antigravity

Credenciales de Google

Clave de API

Claude Code

Cursor

GitHub Copilot

Configuración del lugar de trabajo

Configuración global del usuario

Codex

Otro

Verifica la conexión

Optimiza la ventana de contexto y el uso de tokens

Configuraciones de seguridad opcionales

Usa Model Armor

Enrutamiento de solicitudes de MCP a Model Armor

Habilita Model Armor

Configura la protección para servidores de MCP remotos

Inhabilita el análisis del tráfico de MCP con Model Armor

Ajusta la configuración de Model Armor

Solución de problemas

Matriz de solución de problemas

Resuelve errores de autenticación y consentimiento

Documentación incluida

Limitaciones conocidas

Conéctate al servidor de MCP de Developer Knowledge