Conectarse al servidor de MCP de Developer Knowledge

El servidor de MCP de Google Developer Knowledge ofrece a las herramientas de desarrollo basadas en IA la posibilidad de buscar en la documentación oficial para desarrolladores de Google y recuperar información sobre los productos de Google, como Firebase, Google Cloud, Android y Maps, entre otros. Al conectar tu aplicación de IA directamente a nuestra biblioteca oficial de documentación, te aseguras de que el código y las directrices que recibas estén actualizados y se basen en un contexto autorizado.

Una vez que hayas configurado el servidor, las herramientas integradas podrán ayudarte con solicitudes como las siguientes:

  • Prácticas recomendadas de implementación

    • Por ejemplo: ¿Cuál es la mejor forma de implementar notificaciones push con Firebase Cloud Messaging en una aplicación Android?

  • Generación y explicación de código

    • Por ejemplo: Busca en la documentación de Google un ejemplo de Python para enumerar todos los segmentos de un proyecto de Cloud Storage.

  • Solución de problemas y depuración

    • Por ejemplo: ¿Por qué mi clave de API de Google Maps muestra la marca de agua "Solo con fines de desarrollo"?

  • Análisis comparativo y resumen

    • Por ejemplo: Ayúdame a elegir entre Cloud Run y Cloud Functions para un nuevo microservicio. Crea una tabla Markdown que compare aspectos clave como el caso práctico principal, la simultaneidad y el modelo de precios.

Funciones del servidor de MCP

El servidor de MCP de Developer Knowledge de Google proporciona las siguientes herramientas a tu aplicación de IA:

Nombre de la herramienta Descripción
search_documents Busca en la documentación para desarrolladores de Google (Firebase, Google Cloud, Android, Maps y más) páginas y fragmentos relevantes para tu consulta. Usa get_document o batch_get_documents con parent de los resultados de búsqueda para obtener el contenido de la página completa.
get_document Obtiene todo el contenido de un documento mediante el parent de un resultado de search_documents.
batch_get_documents Obtiene el contenido completo de varios documentos mediante parents de los resultados de search_documents.

La herramienta search_documents divide la documentación en fragmentos de texto más pequeños que están optimizados para la búsqueda y la recuperación basadas en IA. Cuando haces una búsqueda, la herramienta devuelve uno o varios fragmentos de documentos que son relevantes para tu consulta. Si necesitas ver el contenido completo de la página que rodea a un fragmento, usa get_document o batch_get_documents con el parent proporcionado en los resultados de búsqueda para obtener el contenido completo de la página.

Instalación

El servidor de MCP de Developer Knowledge de Google es un servidor de MCP remoto que usa la API Developer Knowledge para buscar y recuperar documentación. Puedes autenticarte mediante OAuth o una clave de API.

Autenticarse mediante OAuth

En esta sección se explica cómo autenticar tu aplicación de IA con el servidor de MCP de Developer Knowledge mediante OAuth.

Requisito previo: configurar Google Cloud CLI

Antes de continuar, asegúrate de que tienes lo siguiente:

Paso 1: Habilita la API Developer Knowledge en un proyecto

  1. Abre la página de la API Developer Knowledge en la biblioteca de APIs de Google.
  2. Comprueba que hayas seleccionado el proyecto correcto en el que quieres usar la API.
  3. Haz clic en Habilitar. No se necesitan roles de gestión de identidades y accesos específicos para habilitar o usar la API.

Paso 2: Habilita el servidor de MCP de Developer Knowledge en un proyecto

Para habilitar el servidor MCP de Developer Knowledge, ejecuta el siguiente comando y sustituye PROJECT_ID por el ID de tu proyecto de Google Cloud:

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

Si el servicio Developer Knowledge no está habilitado en tu proyecto de Google Cloud, se te pedirá que lo habilites antes de habilitar el servidor de MCP remoto.

Como práctica recomendada de seguridad, te recomendamos que habilites los servidores MCP solo para los servicios que necesite tu aplicación de IA para funcionar.

Paso 3: Elige tu método de autenticación

El método de autenticación que elijas dependerá de si tu asistente de IA admite credenciales de aplicación predeterminadas (ADC) mediante la gcloud CLI o si requiere un ID de cliente de OAuth independiente. Los asistentes como la CLI de Gemini pueden usar tus credenciales de inicio de sesión de Google Cloud para que la configuración sea sencilla, mientras que otros, como Antigravity, requieren que crees y proporciones tus propias credenciales manualmente para establecer una conexión segura.

Selecciona la pestaña que corresponda a los requisitos de configuración de tu asistente de IA específico.

ADC

Conectar la cuenta

  1. Para conceder al servidor de MCP la capacidad de actuar en tu nombre, ejecuta el siguiente comando, sustituyendo PROJECT_ID por el ID de tu proyecto de Google Cloud:

    gcloud auth application-default login
--project=PROJECT_ID

  2. Cuando se te solicite, elige una cuenta y haz clic en Continuar.

Configurar tu aplicación de IA

Una vez autenticado, el último paso es proporcionar a tu aplicación de IA los detalles de configuración del servidor. Aunque la estructura JSON exacta varía en función de la aplicación, puedes usar el siguiente ejemplo como plantilla.

  1. Para configurar Gemini CLI o Gemini Code Assist, edita o crea uno de los siguientes archivos de configuración:

    • En tu proyecto: .gemini/settings.json
    • En tu directorio principal: ~/.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"
      }
    }
  }
}

    Para comprobar si el servidor de MCP funciona según lo previsto, ve a verificar la instalación.

Credenciales manuales

Configurar la pantalla de consentimiento de OAuth

Configura la pantalla de consentimiento de OAuth del proyecto y añádete como usuario de prueba. Si ya has completado este paso en tu proyecto en la nube de Google Cloud, ve al siguiente.

  1. Abre la página de resumen de autenticación de la consola de Google Cloud y haz clic en Empezar.
  2. Introduce un nombre de aplicación, selecciona tu correo de asistencia y haz clic en Siguiente.
  3. En Audiencia, selecciona Externa y haz clic en Siguiente.
  4. En Información de contacto, introduce tu dirección de correo y haz clic en Siguiente.
  5. Lee y acepta la Política de Datos de Usuario de los Servicios de las APIs de Google y, a continuación, haz clic en Continuar.
  6. Haz clic en Crear.

Añadir usuarios de prueba

  1. En la plataforma de autenticación de Google, haz clic en Audiencia.
  2. En Usuarios de prueba, haz clic en Añadir usuarios.
  3. Introduce tu dirección de correo y las de los demás usuarios de prueba autorizados y, a continuación, haz clic en Guardar.

Crear un cliente de OAuth

Para autenticarte como usuario final y acceder a los datos de usuario en tu aplicación, debes crear IDs de cliente de OAuth 2.0. Los IDs de cliente se utilizan para identificar aplicaciones de manera individualizada en los servidores OAuth de Google.

  1. En la plataforma de autenticación de Google, haz clic en Clientes.
  2. Haz clic en Crear cliente.
  3. En el selector Tipo de aplicación, elige Aplicación de escritorio.
  4. En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
  5. Haz clic en Crear. Aparecerá la pantalla de cliente de OAuth creado, que muestra el nuevo ID de cliente y el secreto de cliente.
  6. Haz clic en Aceptar. La credencial que acabas de crear aparece en IDs de cliente de OAuth 2.0.
  7. Haga clic en el ID de cliente que acaba de crear. En la sección Secretos de cliente, haz clic en el icono de descarga para guardar el archivo JSON. En un paso posterior, utilizarás los valores client_id y client_secret de este archivo.

Configurar tu aplicación de IA

A continuación, debes proporcionar a tu aplicación de IA los detalles de configuración del servidor. Aunque la secuencia exacta de pasos varía según la aplicación, puedes usar el siguiente ejemplo como plantilla.

Para configurar Antigravity para que use el servidor de MCP, sigue estos pasos:

  1. En Antigravity, haz clic en el menú Opciones adicionales del panel Agente > Servidores MCP > Gestionar servidores MCP.

  2. En el panel Gestionar MCPs que se abre, haz clic en Ver configuración sin formato para editar el archivo mcp_config.json:

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

  3. Vuelve a Gestionar servidores MCP y haz clic en Actualizar.

Añadir credenciales de OAuth

La primera vez que intentes usar el servidor de MCP de Developer Knowledge, tu asistente de IA te pedirá que completes la configuración:

  1. Pídele al agente que use el servidor de MCP de Developer Knowledge con una petición como la siguiente:

    How do I list Cloud Storage buckets?

  2. Si ves un mensaje en el que se te pide que registres uno o varios URIs de redirección, haz clic en la opción para continuar. Como has configurado el ID de cliente como una aplicación de escritorio, no es necesario que añadas estos URIs específicos en la plataforma Google Auth.

  3. Cuando tu asistente de IA te pida el ID de cliente y el secreto de cliente, pega cada clave correspondiente del archivo JSON de secreto de cliente que hayas guardado antes.

  4. Cuando se te solicite, elige una cuenta y haz clic en Continuar.

  5. Vuelve a tu asistente de IA. El agente procesará tu solicitud con el servidor recién autenticado.

Autenticarse con una clave de API

En esta sección se explica cómo autenticar tu aplicación de IA con el servidor MCP de Developer Knowledge mediante una clave de API.

Paso 1: Crea una clave de API

Puedes generar una clave de API de Developer Knowledge en tu proyecto de Google Cloud mediante la consola de Google Cloud o la gcloud CLI:

Consola de Google Cloud

Habilitar la API

  1. Abre la página de la API Developer Knowledge en la biblioteca de APIs de Google.
  2. Comprueba que hayas seleccionado el proyecto correcto en el que quieres usar la API.
  3. Haz clic en Habilitar. No se necesitan roles de gestión de identidades y accesos específicos para habilitar o usar la API.

Crear y proteger la clave de API

  1. En la consola de Google Cloud del proyecto en el que has habilitado la API, ve a la página Credenciales.
  2. Haz clic en Crear credenciales y, a continuación, selecciona Clave de API en el menú. En el cuadro de diálogo de la clave de API creada, se muestra la cadena de la clave que acabas de crear.
  3. Haz clic en Editar clave de API.
  4. En el campo Nombre, asigna un nombre a la clave.
  5. En Restricciones de API, selecciona Restringir clave.
  6. En la lista Seleccionar APIs, habilita API Developer Knowledge y haz clic en Aceptar.
    • Nota: Si acabas de habilitar la API Developer Knowledge, puede que tarde un poco en aparecer en la lista Seleccionar APIs.
  7. Haz clic en Guardar.

Una vez creada la clave, haz clic en Mostrar clave para verla. Apunta esta información para usarla cuando configures tu aplicación de IA.

CLI de gcloud

  1. Si aún no lo has hecho, descarga e instala la CLI de gcloud.

  2. Habilita la API Developer Knowledge y sustituye PROJECT_ID por el ID de tu proyecto de Google Cloud:

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

  3. Crea una clave de API con el mismo ID de proyecto de Google Cloud:

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

    Este comando devuelve una cadena de clave de API. Apunta esta información para usarla cuando configures tu aplicación de IA.

  4. Protege tu clave de API añadiendo restricciones a la clave de API. Para mejorar la seguridad, restringe la clave de API a la API Developer Knowledge.

Paso 2: Habilita el servidor de MCP de Developer Knowledge en un proyecto

Para habilitar el servidor de MCP de Developer Knowledge en tu proyecto de Google Cloud, descarga e instala la gcloud CLI y, a continuación, ejecuta el siguiente comando. Sustituye PROJECT_ID por el ID de tu proyecto de Google Cloud:

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

Si el servicio Developer Knowledge no está habilitado en tu proyecto de Google Cloud, se te pedirá que lo habilites antes de habilitar el servidor de MCP remoto.

Como práctica recomendada de seguridad, te recomendamos que habilites los servidores MCP solo para los servicios que necesite tu aplicación de IA para funcionar.

Paso 3: Configura tu aplicación de IA

Configura aplicaciones de IA populares siguiendo estas instrucciones. Sustituye YOUR_API_KEY por la clave de API Developer Knowledge que has generado en el paso anterior:

Gemini CLI

Para configurar Gemini CLI, ejecuta el siguiente comando:

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

También puedes editar o crear uno de los siguientes archivos de configuración:

  • En tu proyecto: .gemini/settings.json
  • En tu directorio principal: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Para configurar Gemini Code Assist, edita o crea uno de los siguientes archivos de configuración:

  • En tu proyecto: .gemini/settings.json
  • En tu directorio principal: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Firebase Studio

Para configurar Firebase Studio, edita o crea el archivo de configuración: .idx/mcp.json.

Nota: Si el archivo aún no existe, créalo haciendo clic con el botón derecho en el directorio principal y seleccionando Nuevo archivo.

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

Claude Code

Para configurar Claude Code, ejecuta el siguiente comando en la carpeta de tu aplicación.

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 (para un proyecto específico) o ~/.cursor/mcp.json (para todos los proyectos).

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

GitHub Copilot

Para configurar GitHub Copilot en VS Code para un solo proyecto, edita el archivo .vscode/mcp.json en tu espacio de trabajo.

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

Para que el servidor esté disponible en todos los proyectos, edita tu configuración de usuario. Haz clic en el botón Abrir configuración (JSON).

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

Windsurf

Para configurar Windsurf Editor, edita el archivo ~/.codeium/windsurf/mcp_config.json.

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

Verificar instalación

Una vez configurada, abre tu aplicación de IA e introduce una petición como la siguiente:

How do I list Cloud Storage buckets?

Si ves una llamada a la herramienta search_documents u otra herramienta del servidor de MCP de Developer Knowledge, significa que el servidor funciona correctamente.

Gestionar el uso de tokens

Recuperar el contenido de un documento, sobre todo cuando se usa batch_get_documents, consume tokens en la ventana de contexto de tu aplicación de IA. Como algunas páginas de la documentación para desarrolladores de Google son bastante grandes, obtener varios documentos puede provocar rápidamente un aumento de los costes, una ralentización de los tiempos de respuesta del modelo y un desbordamiento de la ventana de contexto.

Para optimizar el rendimiento y evitar que se te facture un importe inesperado, crea peticiones específicas que se centren únicamente en la información que necesitas. Evita las solicitudes generales (por ejemplo, "Compara todos los productos de Firebase") que obliguen al agente a ingerir grandes cantidades de datos a la vez.

Documentación incluida

Consulta la referencia de corpus para obtener información sobre los documentos en los que busca el servidor.

Limitaciones conocidas

  • Ámbito del contenido: solo se incluyen las páginas visibles públicamente en la referencia de corpus. No se incluye contenido de otras fuentes, como GitHub, sitios de software libre, blogs o YouTube.
  • Resultados solo en inglés: el servidor solo admite resultados en inglés.
  • Dependientes de la red: las herramientas del servidor dependen de los servicios de Google Cloud activos. Si sigues teniendo problemas, comprueba tu conexión a Internet y la configuración de la clave de API Developer Knowledge.

Solución de problemas

Si tienes algún problema, comprueba lo siguiente:

Model Armor

Si usas Model Armor para proteger tu aplicación, es posible que se produzcan errores 403 PERMISSION_DENIED en algunas consultas. Como el servidor MCP de Developer Knowledge solo devuelve documentación pública de fuentes de Google fiables, recomendamos definir los filtros de inyección de peticiones y jailbreak (PIJB) en niveles de confianza HIGH_AND_ABOVE para reducir los falsos positivos. Si tu caso práctico no implica el uso de otras herramientas que accedan a datos privados o sensibles, también puedes inhabilitar los filtros de PIJB.