Conéctate al servidor de MCP de Developer Knowledge

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

Para conectarte al servidor de MCP de Developer Knowledge desde tu propio código de aplicación o agente en lugar de un IDE, consulta Conéctate con los SDKs de MCP.

Funciones del servidor de MCP

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

Nombre de la herramienta	Descripción
search_documents	Busca en la documentación para desarrolladores de Google Developers y devuelve los extractos de página más relevantes junto con los nombres de los documentos.
get_documents	Recupera el contenido completo de Markdown de los documentos con los nombres que devuelve search_documents.
answer_query	Genera respuestas estructuradas extraídas del corpus de conocimiento del desarrollador.

La herramienta search_documents busca en la documentación de Google para encontrar las secciones más pertinentes que coincidan con tu consulta. Cuando haces una pregunta, la herramienta devuelve pasajes de texto breves. 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 obtener una respuesta directa a una pregunta extraída del corpus de Developer Knowledge en lugar de resultados de la búsqueda sin procesar o archivos Markdown completos.

Nota: Vincula el servidor de MCP de Developer Knowledge con la habilidad del agente retrieving-developer-knowledge. Esta habilidad le brinda a tu asistente de programación de IA instrucciones integradas sobre qué herramienta elegir, cómo controlar los errores y cómo llamar a la API de REST si el servidor de MCP no está disponible. Para obtener más información, consulta Cómo usar la habilidad del agente de conocimiento para desarrolladores.

Elige un método de autenticación

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

• Clave de API: Es la mejor opción para IDEs de terceros y agentes de CLI, 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, que tiene compatibilidad integrada con las credenciales predeterminadas de la aplicación (ADC), o para los flujos de trabajo empresariales que requieren un token de portador de OAuth 2.0 o un ID de cliente de OAuth 2.0 independiente en lugar de una clave de API.

Genera las credenciales necesarias para el método de autenticación que elegiste y permite que tu asistente de IA o agente de programación autentiquen 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 se configura 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 gcloud CLI:

Consola de Google Cloud

1. Abre la página de la API de Developer Knowledge en la consola de Google Cloud.
2. Selecciona tu proyecto de Google Cloud y haz clic en Habilitar.
3. Ve a la página Credenciales.
4. Haz clic en Crear credenciales y selecciona Clave de API.
5. 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 la API de Generative Language.
6. Haz clic en Guardar y, luego, copia tu clave de API.

gcloud CLI

1. 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
   

2. Crea una clave de API:

   gcloud services api-keys create \
     --project=PROJECT_ID \
     --display-name="DK API Key"
   

   Este comando devuelve detalles de los metadatos sobre tu clave nueva. Copia y guarda los siguientes valores del resultado del comando:

   • keyString: Esta 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 de acceso para restringir la clave en el siguiente paso.

3. Restringe la clave a la API de Developer Knowledge para evitar el uso no autorizado. Reemplaza KEY_NAME por la ruta de acceso completa de name que copiaste en el 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 o ADC, asegúrate de tener lo siguiente:

• Un proyecto de Google Cloud.
• gcloud CLI instalada.

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 el tipo de credencial de OAuth

Selecciona el enfoque de credenciales que requiere tu herramienta:

ADC

Google Antigravity tiene compatibilidad integrada con ADC y actualiza los tokens de actualización automáticamente. Otros clientes de MCP pueden usar ADC pasando un token del portador de corta duración en el encabezado Authorization:

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

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

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

3. (Opcional) Si configuras un cliente de MCP de terceros que no tiene compatibilidad integrada con ADC, genera un token del portador (válido por una hora) para usarlo en el encabezado Authorization de tu cliente:

   gcloud auth application-default print-access-token
   

ID de cliente de OAuth

Crea un ID de cliente y un secreto de OAuth 2.0 si tu asistente de IA usa un flujo de OAuth interactivo, ya que los servidores de MCP remotos de Google no admiten el registro dinámico de clientes (DCR) de OAuth.

1. Ve a la página de desarrollo de la marca y selecciona tu proyecto. Ingresa un Nombre de la app y un Correo electrónico de asistencia del usuario, y haz clic en Guardar.
2. Ve a la página Público y establece el Tipo de usuario en Externo.
3. En la misma página, haz clic en Agregar usuarios en Usuarios de prueba, ingresa tu dirección de correo electrónico de Google y haz clic en Guardar.
4. Ve a la página Clientes, haz clic en Crear cliente y elige el tipo de aplicación que requiere tu cliente de MCP:
   • Selecciona App para computadoras para los clientes de escritorio que solicitan un ID de cliente y un secreto (como VS Code).
   • Selecciona Aplicación web y agrega la URI de redireccionamiento de tu cliente para los clientes que requieren devoluciones de llamada de redireccionamiento de OAuth estáticas (como los conectores personalizados de Cursor o Claude Code). Usa el URI de redireccionamiento exacto que documenta tu cliente. No se admiten los URIs de redireccionamiento personalizados. Para obtener información sobre los URIs de redireccionamiento específicos del cliente, consulta Cómo configurar el MCP en una aplicación de IA.
5. Haz clic en Crear y, luego, copia tu ID de cliente y el secreto del cliente (o descarga el archivo JSON de credenciales del cliente).

Alcances de OAuth

El servidor de MCP de Developer Knowledge acepta los siguientes permisos de OAuth:

• https://www.googleapis.com/auth/cloud-platform: Es el alcance predeterminado que usan las credenciales predeterminadas de la aplicación (ADC) y la gcloud CLI.
• https://www.googleapis.com/auth/devprofiles.full_control: Es el permiso que se usa para los flujos de consentimiento del ID de cliente de OAuth 2.0 y el descubrimiento de servidores de MCP.
• https://www.googleapis.com/auth/developerprofiles.readonly: Es el alcance de solo lectura compatible con las cuentas de servicio y las credenciales que no requieren una pantalla de consentimiento de OAuth para el usuario final.

Configura tu IDE o agente de programación

Después de obtener tus credenciales, sigue las instrucciones de configuración para tu entorno de programación. Las instrucciones para cada entorno de programación admiten los siguientes métodos de autenticación:

Entorno de programación	Métodos de autenticación
Google Antigravity	Credenciales de Google integradas (ADC) o clave de API
Claude Code, Cursor, GitHub Copilot, Codex	Clave de API
Otro	Clave de API, token del portador de ADC o ID de cliente de OAuth 2.0

Para usar un token del portador de ADC o un ID de cliente de OAuth 2.0 con Claude Code, Cursor, GitHub Copilot o Codex, sigue las instrucciones de la pestaña Otro.

Según la plantilla que uses, reemplaza los siguientes marcadores de posición:

• Clave de API (YOUR_API_KEY): Reemplázala por la cadena de tu clave de API sin procesar.
• ID del proyecto (PROJECT_ID): Reemplaza por el ID de tu proyecto de Google Cloud.

• Token de acceso (ACCESS_TOKEN): Reemplaza por el token del portador de gcloud auth application-default print-access-token.

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:

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

Clave de API

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

1. 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).

2. 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"
      }
    }
  }
}

Sugerencia: Si usas la aplicación independiente Antigravity 2.0, ve a Configuración > Personalizaciones y haz clic en Abrir configuración de MCP en Servidores de MCP instalados para agregar tu configuración.

Claude Code

Ejecuta el siguiente comando en la terminal:

claude mcp add google-developer-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

Nota: Si usas la extensión de Antigravity en VS Code en lugar de GitHub Copilot, selecciona la pestaña Google Antigravity.

Configuración de Workspace

Para configurar GitHub Copilot en VS Code para un espacio 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 espacios de trabajo de VS Code, abre la paleta de comandos, ejecuta MCP: Open User Configuration y agrega lo siguiente al archivo mcp.json en tu perfil de usuario:

{
  "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.toml (o al .codex/config.toml de tu proyecto):

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

Nota: Después de cambiar la configuración, es posible que el servidor muestre el estado no accediste. Esto es normal y no afectará tu acceso.

Otro

Para configurar cualquier otro cliente de MCP remoto (como el asistente de IA de JetBrains, Windsurf, Cline, Zed, Continue o Claude Desktop) o para usar un token del portador de ADC o un ID de cliente de OAuth 2.0 en un cliente de terceros, selecciona tu método de autenticación:

Clave de API

Configura un servidor de transporte HTTP con los siguientes parámetros:

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

Plantilla de configuración de JSON estándar:

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

Token del portador del ADC

Si tu cliente de MCP no tiene compatibilidad integrada con ADC, puedes autenticarte con ADC pasando el token del portador de gcloud auth application-default print-access-token y el ID del proyecto de Google Cloud en los encabezados de la solicitud:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

El encabezado X-Goog-User-Project requiere el permiso serviceusage.services.use en el proyecto. Los propietarios y editores del proyecto tienen este permiso. Otros usuarios necesitan un rol que lo incluya, como Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer).

Nota: Los tokens de portador de ADC vencen después de una hora. Cuando el token venza, vuelve a ejecutar gcloud auth application-default print-access-token para generar uno nuevo.

ID de cliente de OAuth

Para autenticarte con un ID de cliente y un secreto de OAuth 2.0 independientes, haz lo siguiente:

1. Agrega el extremo del servidor de MCP a la configuración del cliente sin un encabezado de clave de API:

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

   Nota: VS Code usa una clave servers de nivel superior en lugar de mcpServers. Agrega el servidor a .vscode/mcp.json en la carpeta que abres como tu espacio de trabajo o ejecuta MCP: Open User Configuration desde la paleta de comandos para que esté disponible en todos los espacios de trabajo. Para conocer la estructura de archivos de VS Code, consulta la pestaña GitHub Copilot y omite la sección headers.

2. Completa la configuración de OAuth para tu cliente:

   • Mensaje interactivo (como VS Code): Envía un mensaje de prueba al agente. Cuando se te indique que no se admite el registro dinámico de clientes, continúa y, luego, ingresa tu ID de cliente y tu secreto de cliente. Luego, accede con tu Cuenta de Google.
   • Configuración estática de OAuth (como Cursor o Claude Code): proporciona tu ID de cliente de OAuth, el secreto de cliente y el URI de redireccionamiento en la configuración de OAuth de tu cliente. Para obtener instrucciones específicas del cliente, consulta Configura MCP en una aplicación de IA.

   Si tu cliente te pide que especifiques permisos de OAuth, usa https://www.googleapis.com/auth/devprofiles.full_control.

No es necesario que especifiques un ID del proyecto de Google Cloud en esta configuración. Las solicitudes se atribuyen al proyecto que posee tu ID de cliente de OAuth.

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 devuelve información de la documentación de Google, tu servidor está conectado y activo.

Usa la habilidad para agentes Developer Knowledge

Instala la habilidad para agentes oficial de retrieving-developer-knowledge para enseñarle a tu asistente cuándo y cómo usar las herramientas principales que ofrece el servidor de MCP de Developer Knowledge.

Una habilidad de agente es un conjunto de instrucciones que tu asistente de programación de IA lee antes de comenzar una tarea. La habilidad retrieving-developer-knowledge funciona con cualquier asistente que admita el estándar abierto de habilidades de agentes y ayuda a tu asistente a hacer lo siguiente:

• Elige la herramienta adecuada: Guía a tu asistente para que use answer_query para preguntas y comparaciones generales de tipo "instructivo", y search_documents (con entre dos y cinco palabras clave enfocadas) cuando busque marcas de la CLI, permisos de IAM o sintaxis de código exactos.
• Verifica si hay errores antes de responder: Le indica a tu asistente que se asegure de que una búsqueda de documentación se haya realizado correctamente antes de escribir una respuesta, de modo que no confunda un error de clave de API o de cuota con documentación faltante ni recurra a adivinar a partir de datos de entrenamiento más antiguos.
• Recurrir a la API de REST: Le da a tu asistente comandos de curl para llamar directamente a la API de Developer Knowledge si tu editor no admite servidores de MCP o si falla la conexión de MCP.

Instala la habilidad para agentes

Selecciona tu asistente de programación para instalar la habilidad retrieving-developer-knowledge en el directorio de tu proyecto:

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

Cursor

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

Otro

Para otros asistentes de IA que admitan el estándar abierto de Agent Skills, ejecuta lo siguiente:

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

Para actualizar las habilidades instaladas a la versión más reciente, ejecuta lo siguiente:

npx skills update

Para ver las instrucciones completas de las habilidades y las guías de referencia, consulta el directorio retrieving-developer-knowledge en GitHub.

Optimiza la ventana de contexto y el uso de tokens

Recuperar páginas de documentación completas en la ventana de contexto de un modelo de IA consume una cantidad significativa de tokens. La transferencia de varios documentos grandes puede generar costos de tokens altos, un aumento de la latencia y un desbordamiento de la ventana de contexto.

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

• Instala la habilidad para agentes (recomendado): Instala la habilidad para agentes retrieving-developer-knowledge para que tu asistente elija automáticamente la herramienta de búsqueda adecuada (answer_query o search_documents), use búsquedas de palabras clave cortas y solo descargue páginas completas cuando sea necesario.

• Confía en la recuperación en dos pasos: Permite que el agente comience llamando a search_documents. Esto devuelve 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. Indícale 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 generada o una comparación de diseño, indica a tu agente que use answer_query. Esta herramienta genera una respuesta directamente del corpus de Developer Knowledge sin devolver páginas de Markdown sin procesar completas.

• Escribe instrucciones específicas y con un alcance definido: Evita las instrucciones demasiado amplias, como "Explica todo sobre 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: Si no usas la habilidad retrieving-developer-knowledge, 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áginas completas:

  When searching Google developer documentation, inspect search_documents
  snippets first. Do not call get_documents unless the snippet lacks
  necessary code context.
  

Configuraciones opcionales de seguridad

El MCP presenta nuevos riesgos y consideraciones de seguridad debido a la gran variedad de acciones que puedes realizar con las herramientas del 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 y protección de la IA.

Usa Model Armor

Model Armor es un servicio de Google Cloud diseñado para mejorar la seguridad de tus aplicaciones de IA. Funciona analizando de forma proactiva las instrucciones y respuestas de los LLM, protegiendo contra diversos riesgos y respaldando prácticas de IA responsable. Ya sea que implementes la 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 panorama de IA diverso.

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 distintos servidores de MCP y puede incumplir 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 Integración en los 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. La 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 herramientas de MCP dentro del proyecto.

Sugerencia: No habilites el filtro de inyección de instrucciones y jailbreak, a menos que tu tráfico de MCP transporte datos de lenguaje natural.

Establecer una configuración mínima de Model Armor con la limpieza de MCP habilitada Para obtener más información, consulta Configura la configuración mínima de Model Armor.

Nota: Si el agente y el servidor de MCP están en proyectos diferentes, puedes crear configuraciones mínimas en ambos proyectos (el proyecto del cliente y el proyecto del recurso). En este caso, Model Armor se invoca dos veces, una para cada proyecto.

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 Google Cloud.

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

• INSPECT_AND_BLOCK: Es el tipo de aplicación de medidas por incumplimiento 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 de política.
• 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 de Google Cloud. 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 y general de Model Armor puede afectar más que solo MCP. Debido a que Model Armor se integra en servicios como Vertex AI, cualquier cambio que realices en la configuración mínima puede afectar el análisis del 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 errores 403 PERMISSION_DENIED en algunas consultas. Debido a que el servidor de MCP de Developer Knowledge solo devuelve documentación pública de fuentes de Google confiables, recomendamos establecer los filtros de inyección de instrucciones y jailbreak (PIJB) en niveles de confianza HIGH_AND_ABOVE para reducir los falsos positivos. Si tu caso de uso no involucra otras herramientas que accedan a datos privados o sensibles, también puedes considerar inhabilitar los filtros de PIJB.

Solución de problemas

Si tienes problemas para conectarte al servidor de MCP de Developer Knowledge o realizar consultas en él, busca el síntoma o el mensaje de error en las siguientes tablas.

Errores de configuración y conexión

Síntoma o error	Causa probable	Solución
Extremo 404 NOT_FOUND en /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.
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.
Faltan herramientas del MCP o falla la conexión	Tu herramienta de programación no admite servidores de MCP HTTP remotos o no puede conectarse al servidor.	Instala la habilidad del agente de retrieving-developer-knowledge, que le indica a tu asistente cómo recurrir a los extremos de la API de REST de Developer Knowledge con curl cuando las herramientas de MCP no están disponibles.

Errores de claves de API

Síntoma o error	Causa probable	Solución
400 Bad Request: API key not valid	Falta la cadena de la clave de API, no es válida o tiene un formato incorrecto.	Verifica que la clave de API se haya copiado correctamente y se haya configurado en el objeto headers con la clave X-Goog-Api-Key. No pases la clave de API como parámetro de consulta en la URL.
403 PERMISSION_DENIED: API target restriction	La lista de restricciones de claves de API excluye la API de Developer Knowledge.	Actualiza las restricciones de tu clave de API en la página Credenciales de la consola de Google Cloud para incluir la API de Developer Knowledge.

Errores de OAuth y ADC

Síntoma o error	Causa probable	Solución
Faltan credenciales de ADC o 401 UNAUTHENTICATED	Las credenciales predeterminadas de la aplicación o los tokens del portador de ADC vencieron o no se inicializaron.	Ejecuta gcloud auth application-default login --project=PROJECT_ID para actualizar las credenciales locales o ejecuta gcloud auth application-default print-access-token para generar un nuevo token de portador.
403 PERMISSION_DENIED: API requires a quota project, which is not set by default	La solicitud usa un token del portador de ADC sin un encabezado X-Goog-User-Project.	Agrega el encabezado X-Goog-User-Project con el ID de tu proyecto de Google Cloud a la configuración del cliente de MCP.
403 PERMISSION_DENIED con un encabezado X-Goog-User-Project	Tu cuenta no tiene el permiso serviceusage.services.use en el proyecto del encabezado.	Solicita a un administrador del proyecto que te otorgue el rol de consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer).
403 access_denied / "Acceso bloqueado: Error de autorización"	Tu pantalla de consentimiento de OAuth usa el tipo de usuario Externo en el modo de prueba, y tu cuenta no aparece como usuario de prueba.	En la consola de Google Cloud > Auth Platform > Público, agrega tu dirección de correo electrónico de Google activa 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 admitido o falta el URI de redireccionamiento.	Usa App para computadoras para clientes con instrucciones interactivas (como VS Code) o Aplicación web con el URI de redireccionamiento autorizado de tu cliente (como Cursor o Claude Code).

Errores de cuota y filtros de seguridad

Síntoma o error	Causa probable	Solución
429 RESOURCE_EXHAUSTED	Alcanzaste el límite de cuota de tu proyecto.	Verifica tu uso en la página de cuotas de la API de Developer Knowledge en la consola de Google Cloud. Para obtener información sobre los límites y solicitar un aumento, consulta la cuota de la API de Developer Knowledge.
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.

Documentación incluida

Consulta la referencia de Corpus para obtener la lista completa de productos de Google y repositorios de documentación que indexa el servidor.

Limitaciones conocidas

• Solo documentación pública: El servidor indexa solo la documentación disponible públicamente que se indica en la Referencia del corpus. No se incluyen los documentos internos, los repositorios privados ni los recursos de terceros.
• Idioma inglés: El servidor indexa y devuelve documentación solo en inglés.
• Dependencia de red y Controles del servicio de VPC: Dado que el servidor de MCP de Developer Knowledge es un servicio alojado remoto, tu cliente debe tener conectividad de red para acceder a https://developerknowledge.googleapis.com.
  • Dentro de las redes de VPC de Google Cloud: No se requiere salida a Internet pública. Puedes acceder a developerknowledge.googleapis.com de forma privada sin direcciones IP externas ni Cloud NAT. Para ello, enruta el tráfico con el Acceso privado a Google (private.googleapis.com / 199.36.153.8/30) o un extremo de Private Service Connect (PSC) que apunte al paquete all-apis.
  • Controles del servicio de VPC (VPC-SC): developerknowledge.googleapis.com no es compatible con la VIP restringida (restricted.googleapis.com / 199.36.153.4/30) ni con los extremos de PSC vpc-sc. Si tu VPC enruta *.googleapis.com a restricted.googleapis.com, configura una política de respuesta de Cloud DNS específica o un registro DNS privado para que developerknowledge.googleapis.com se resuelva en private.googleapis.com (199.36.153.8/30).