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 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 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 programación con IA:

Nombre de la herramienta	Descripción
search_documents	Busca en la documentación para desarrolladores de Google y devuelve los fragmentos de página más relevantes junto con los nombres de los documentos.
get_documents	Recupera el contenido completo en 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 relevantes que coincidan con tu búsqueda. 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 una respuesta directa a una pregunta extraída del corpus de conocimiento para desarrolladores 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 la CLI de gcloud:

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 restricciones:
   • En Restricciones de API, elige Restringir clave.
   • Selecciona API de Developer Knowledge.
   • Si planeas usar la misma clave para las llamadas al modelo (como GEMINI_API_KEY), también selecciona 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 dos valores siguientes 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 al 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 la misma clave para las llamadas generales del modelo 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.
• La CLI de gcloud 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 tu 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 automáticamente. Otros clientes de MCP pueden usar ADC pasando un token de 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 las ADC, genera un token de 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 y un secreto de cliente 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 configura el Tipo de usuario como 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 de escritorio para los clientes de escritorio que solicitan un ID y un secreto del cliente (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 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 tu secreto del cliente (o descarga el archivo JSON de las credenciales del cliente).

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 de portador de ADC o ID de cliente de OAuth 2.0

Para usar un token de 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): Reemplaza este valor por tu cadena de clave de API sin procesar.
• ID del proyecto (PROJECT_ID): Reemplázalo por el ID de tu proyecto de Google Cloud.

• Token de acceso (ACCESS_TOKEN): Reemplaza con 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 MCP Servers.
2. Busca Google Developer Knowledge.
3. Haz clic en el ícono Instalar (). 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"
      }
    }
  }
}

Nota: 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 Antigravity en VS Code en lugar de GitHub Copilot, selecciona la pestaña Google Antigravity.

Configuración del espacio de trabajo

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 se accedió. Esto es normal y no afectará tu acceso.

Otro

Para configurar cualquier otro cliente de MCP remoto (como JetBrains AI Assistant, Windsurf, Cline, Zed, Continue o Claude Desktop) o para usar un token de portador de ADC o un ID de cliente de OAuth 2.0 en un cliente externo, 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 el de Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer).

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

ID de cliente de OAuth

Para autenticarte con un ID y un secreto de cliente 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 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 del 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 que lo configures, 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, significa que tu servidor está conectado y activo.

Usa la habilidad del agente de conocimiento para desarrolladores

Instala la habilidad de agente oficial 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 conocimiento del desarrollador.

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 agente 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 amplias de "cómo hacer", y search_documents (con dos a cinco palabras clave enfocadas) cuando busque marcas exactas de CLI, permisos de IAM o sintaxis de código.
• 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 una clave de API o un error de cuota con documentación faltante, ni recurra a conjeturas basadas en datos de entrenamiento anteriores.
• Recurrir a la API de REST: Le da a tu asistente comandos de curl para llamar a la API de Developer Knowledge directamente si tu editor no admite servidores de MCP o si falla la conexión de MCP.

Instala la habilidad del agente

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 el siguiente comando:

npx skills update

Para ver las instrucciones completas de la habilidad 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 altos de tokens, 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:

• Instala la habilidad del agente (recomendado): Instala la habilidad del agente 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 (segmentos) 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, indícale a tu agente que use answer_query. Esta herramienta genera una respuesta directamente desde el corpus de conocimiento para desarrolladores sin mostrar páginas completas sin procesar de Markdown.

• 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 objetivo:

  How do I write a Firestore transaction in Dart with error handling?
  

• Agrega reglas personalizadas del agente: Si no usas la habilidad retrieving-developer-knowledge, agrega lineamientos a nivel del proyecto en 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 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 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 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, 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 podría ser diferente para los distintos servidores de MCP y podría incumplir 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 con 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. Un parámetro de configuración mínimo 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.

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

Configura un ajuste mínimo de Model Armor con la limpieza de MCP habilitada. Para obtener más información, consulta Configura los parámetros mínimos de Model Armor.

Nota: Si el agente y el servidor de MCP están en proyectos diferentes, puedes crear configuración mínima 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 que inspecciona el contenido del servidor de MCP de Google y bloquea las instrucciones y las respuestas que coinciden con los filtros.
• ENABLED: Es el parámetro de configuración que habilita un filtro o la 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 de Google Cloud. Model Armor no aplica automáticamente las reglas definidas en la configuración mínima de este proyecto al tráfico de ningún 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 el MCP. Dado 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 del tráfico y los comportamientos de seguridad en todos los servicios integrados, no solo en el MCP.

Ajusta la configuración de Model Armor

Si usas Model Armor para proteger tu aplicación, es posible que encuentres errores de 403 PERMISSION_DENIED para algunas búsquedas. Dado que el servidor de MCP de Developer Knowledge solo devuelve documentación pública de fuentes confiables de Google, recomendamos establecer los filtros de inyección de instrucciones y jailbreak (PIJB) en niveles de confianza de HIGH_AND_ABOVE para reducir los falsos positivos. Si tu caso de uso no involucra otras herramientas que acceden 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 para consultarlo, busca tu síntoma o 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 MCP HTTP remotos o no se puede conectar al servidor.	Instala la habilidad del agente 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 clave 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 que 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 la clave 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 de 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 de 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 Consola de Google Cloud > Plataforma de autenticación > Público, agrega tu dirección de correo electrónico activa de Google 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 Aplicación 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 del corpus para obtener la lista completa de los productos de Google y los 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 se indica en la Referencia del corpus. No se incluyen documentos internos, repositorios privados ni recursos de terceros.
• Idioma inglés: El servidor indexa y devuelve la 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.comNo se admiten en la VIP restringida (restricted.googleapis.com/199.36.153.4/30) ni en 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 o un registro DNS privado específicos para que developerknowledge.googleapis.com se resuelva en private.googleapis.com (199.36.153.8/30).