Conéctate al servidor de MCP de Developer Knowledge

El servidor de MCP de Google Developer Knowledge permite que las herramientas de desarrollo potenciadas por IA busquen la documentación oficial para desarrolladores de Google y recuperen información sobre los productos de Google, como Firebase, Google Cloud, Android, Maps y muchos más. Si conectas tu aplicación de IA directamente a nuestra biblioteca oficial de documentación, te aseguras de que el código y la orientación que recibas estén actualizados y se basen en un contexto autorizado.

Después de configurar el servidor, las herramientas integradas pueden ayudar con solicitudes como las siguientes:

  • Asesoramiento para la implementación

    • Por ejemplo: ¿Cuál es la mejor manera de implementar notificaciones push con Firebase Cloud Messaging en una app para 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 buckets de un proyecto de Cloud Storage.

  • Detección y solución de problemas y depuración

    • Por ejemplo: ¿Por qué mi clave de API de Google Maps muestra una marca de agua que dice "Solo para fines de desarrollo"?

  • Análisis comparativo y resumen

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

Funciones del servidor de MCP

El servidor de MCP de Google Developer Knowledge 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 mucho más) para encontrar páginas y fragmentos relevantes para tu consulta. Usa get_documents con el parent de los resultados de la búsqueda para obtener el contenido completo de la página.
get_documents Obtiene el contenido completo de varios documentos con 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 potenciadas por IA. Cuando buscas, la herramienta muestra uno o más fragmentos de documentos que son relevantes para tu consulta. Si necesitas ver el contenido completo de la página que rodea un fragmento, usa get_documents con el parent que se proporciona en los resultados de la búsqueda para recuperar el contenido completo de la página.

Instalación

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

Autentica mediante OAuth

En esta sección, se te guiará a través del proceso de autenticación de tu aplicación de IA con el servidor de MCP de Developer Knowledge mediante OAuth.

Requisito previo: Configura la CLI de Google Cloud

Antes de continuar, asegúrate de tener lo siguiente:

Paso 1: Habilita la API de Developer Knowledge en un proyecto

  1. Abre la página de la API de Developer Knowledge en la biblioteca de APIs de Google.
  2. Verifica que tengas seleccionado el proyecto correcto en el que deseas usar la API.
  3. Haz clic en Habilitar. No se requieren roles específicos de IAM para habilitar o usar la API.

Paso 2: Elige un método de autenticación

El método de autenticación que elijas depende de si tu asistente de IA admite las credenciales predeterminadas de la aplicación (ADC) con la CLI de gcloud o requiere un ID de cliente de OAuth independiente. Los asistentes como Gemini CLI pueden usar tu acceso existente a Google Cloud para una configuración sin problemas, mientras que otros, como Antigravity, requieren que crees y proporciones tus propias credenciales de forma manual para establecer una conexión segura.

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

ADC

Conectar la cuenta

  1. Para otorgar al servidor de MCP la capacidad de actuar en tu nombre, ejecuta el siguiente comando y reemplaza 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, luego, haz clic en Continuar.

Configura tu aplicación de IA

Una vez autenticado, el paso final es proporcionar a tu aplicación de IA los detalles de configuración del servidor. Si bien la estructura JSON exacta varía según 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 verificar si el servidor de MCP funciona como se espera, continúa para verificar la instalación.

Credenciales manuales

Cómo configurar la pantalla de consentimiento de OAuth

Configura la pantalla de consentimiento de OAuth del proyecto y agrégate como usuario de prueba. Si ya completaste este paso para tu proyecto de Google Cloud, ve al siguiente paso.

  1. Abre la página de descripción general de Auth de la consola de Google Cloud, y haz clic en Comenzar.
  2. Ingresa un Nombre de la app, selecciona tu Correo electrónico de asistencia y haz clic Siguiente.
  3. En Público, selecciona Externo y haz clic en Siguiente.
  4. Ingresa tu dirección de correo electrónico en Información de contacto y haz clic en Siguiente.
  5. Revisa y acepta la Política de Datos del Usuario de los Servicios de las APIs de Google y, luego, haz clic en Continuar.
  6. Haz clic en Crear.

Agrega usuarios de prueba

  1. En Google Auth Platform, haz clic en Público.
  2. En Usuarios de prueba, haz clic en Agregar usuarios.
  3. Ingresa tu dirección de correo electrónico y los demás usuarios de prueba autorizados, y haz clic en Guardar.

Crea un cliente de OAuth

Para autenticarte como usuario final y acceder a los datos del usuario en tu app, debes crear IDs de cliente de OAuth 2.0. Un ID de cliente se usa con el fin de identificar una sola app para los servidores de OAuth de Google.

  1. En Google Auth Platform, haz clic en Clientes.
  2. Haz clic en Crear cliente.
  3. En el selector Tipo de aplicación, elige App 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 Se creó el cliente de OAuth, que muestra tu nuevo ID de cliente y el Secreto del cliente.
  6. Haz clic en OK. La credencial recién creada aparece en IDs de cliente de OAuth 2.0.
  7. Haz clic en el ID de cliente que acabas de crear. En la sección Secretos del cliente , haz clic en el ícono de descarga para guardar el archivo JSON. Usarás los client_id y client_secret valores de este archivo en un paso posterior.

Configura tu aplicación de IA

A continuación, debes proporcionar a tu aplicación de IA los detalles de configuración del servidor. Si bien 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, haz lo siguiente:

  1. En Antigravity, haz clic en el menú Opciones adicionales en el panel Agent > Servidores de MCP > Administrar servidores de MCP.

  2. En la parte superior del panel Administrar servidores de MCP que se abre, haz clic en Ver configuración sin procesar para editar el archivo mcp_config.json:

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

  3. Regresa a Administrar servidores de MCP y haz clic en Actualizar.

Agrega 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 un mensaje como el siguiente:

    How do I list Cloud Storage buckets?

  2. Si ves un mensaje en el que se te pide que registres una o más URIs de redireccionamiento, haz clic en la opción para continuar. Como configuraste el ID de cliente como una app de escritorio, no es necesario agregar estas URIs específicas en Google Auth Platform.

  3. Cuando tu asistente de IA te solicite el ID de cliente y Secreto del cliente, pega cada clave correspondiente del archivo JSON de secreto del cliente que guardaste antes.

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

  5. Regresa a tu asistente de IA. Ahora, el agente procesará tu solicitud con el servidor recién autenticado.

Autentica mediante una clave de API

En esta sección, se te guiará a través del proceso de autenticación de tu aplicación de IA con el servidor de 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 con la consola de Google Cloud o la CLI de gcloud:

Consola de Google Cloud

Habilita la API

  1. Abre la página de la API de Developer Knowledge en la biblioteca de APIs de Google.
  2. Verifica que tengas seleccionado el proyecto correcto en el que deseas usar la API.
  3. Haz clic en Habilitar. No se requieren roles específicos de IAM para habilitar o usar la API.

Crea y protege la clave de API

  1. En la consola de Google Cloud del proyecto en el que habilitaste la API, ve a la página Credenciales.
  2. Haz clic en Crear credenciales y, luego, selecciona Clave de API en el menú. Se mostrará la cadena a la clave recién creada en el cuadro de diálogo Se creó la clave de API.
  3. Haz clic en Editar clave de API.
  4. En el campo Nombre, proporciona un nombre para la clave.
  5. En API restrictions, selecciona Restrict key.
  6. En la lista Seleccionar APIs, habilita API de Developer Knowledge y haz clic en Aceptar.
    • Nota: Si acabas de habilitar la API de Developer Knowledge, es posible que haya una demora antes de que aparezca en la lista Seleccionar APIs.
  7. Haz clic en Guardar.

Después de crear la clave, haz clic en Mostrar clave para verla. Toma nota de ella para usarla cuando configures tu aplicación de IA.

gcloud CLI

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

  2. Habilita la API de Developer Knowledge y reemplaza 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 muestra una cadena de clave de API. Toma nota de ella para usarla cuando configures tu aplicación de IA.

  4. Protege tu clave de API agregando restricciones de clave de API. Para mejorar la seguridad, restringe la clave de API a la API de 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 CLI de gcloud, y, luego, ejecuta el siguiente comando, reemplazando 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 de Developer Knowledge no está habilitado para 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 de MCP solo para los servicios que necesita tu aplicación de IA para funcionar.

Paso 3: Configura tu aplicación de IA

Configura las aplicaciones de IA populares con estas instrucciones. Reemplaza YOUR_API_KEY por la clave de API de Developer Knowledge que generaste 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

Como alternativa, 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"
      }
    }
  }
}

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

Claude Code

Para configurar Claude Code, ejecuta el siguiente comando en la carpeta de tu app.

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 la configuración del 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"
      }
    }
  }
}

Verifica la instalación

Una vez configurada, abre tu aplicación de IA y escribe un mensaje como el siguiente:

How do I list Cloud Storage buckets?

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

Administra el uso de tokens

La recuperación del contenido del documento, en especial cuando se usa batch_get_documents, consume tokens dentro de la ventana de contexto de tu aplicación de IA. Debido a que algunas páginas de documentación para desarrolladores de Google son bastante grandes, la recuperación de varios documentos puede generar rápidamente costos más altos, tiempos de respuesta del modelo más lentos y desbordamiento de la ventana de contexto.

Para optimizar el rendimiento y evitar una factura inesperada, crea mensajes específicos que se orienten solo a la información que necesitas. Evita las solicitudes amplias (por ejemplo, "Compara todos los productos de Firebase") que obligan 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 que busca el servidor.

Limitaciones conocidas

  • Alcance del contenido: Solo se incluyen las páginas visibles públicamente en la referencia de Corpus. No se incluye el contenido de otras fuentes, como GitHub, sitios de OSS, blogs o YouTube.
  • Resultados solo en inglés: El servidor solo admite resultados en inglés.
  • Dependiente de la red: Las herramientas del servidor dependen de los servicios activos de Google Cloud. Si tienes errores persistentes, verifica tu conexión a Internet y la configuración de la clave de API de Developer Knowledge.

Solución de problemas

Si tienes problemas, verifica lo siguiente:

Model Armor

Si usas Model Armor para proteger tu aplicación, es posible que encuentres errores 403 PERMISSION_DENIED para algunas consultas. Como el servidor de MCP de Developer Knowledge solo muestra documentación pública de fuentes confiables de Google, te recomendamos que configures 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 incluye otras herramientas que accedan a datos privados o sensibles, también puedes inhabilitar los filtros de PIJB.