Guía paso a paso: Cómo configurar credenciales OAuth2 para Blogger MCP Server
Configurar OAuth2 para el servidor MCP de Blogger te permite administrar tu blog de forma completa (crear, actualizar y eliminar entradas) directamente desde asistentes de IA como Claude, Cursor u OpenCode.
Dado que la interfaz de Google Cloud cambia con frecuencia, aquí tienes la guía definitiva paso a paso y comprobada.
Paso 1: Configurar la Pantalla de Consentimiento (OAuth Consent Screen)
- Ve a la Consola de Google Cloud.
- Navega a Google Auth Platform > Overview (Plataforma de autenticación de Google).
- En la pestaña Audience (Audiencia), asegúrate de añadir tu propia cuenta de Google como Test User (Usuario de prueba).
- En la pestaña Data Access (Acceso a datos / Scopes), añade el scope de la API de Blogger:
https://www.googleapis.com/auth/blogger
Paso 2: Crear Credenciales de Aplicación Web
⚠️ Importante: NO selecciones "Desktop app" (Aplicación de escritorio), ya que no funcionará correctamente con el OAuth Playground para generar el token.
- Ve a Credentials > Create Credentials > OAuth client ID (Credenciales > Crear credenciales > ID de cliente de OAuth).
- En "Application type" (Tipo de aplicación), selecciona Web application (Aplicación web).
- Ponle un nombre, por ejemplo: "Blogger MCP Server".
- En Authorized redirect URIs (URI de redireccionamiento autorizados), añade EXACTAMENTE esta URL:
https://developers.google.com/oauthplayground - Haz clic en Crear. Copia tu Client ID (ID de cliente) y tu Client Secret (Secreto de cliente).
Paso 3: Generar el Refresh Token en OAuth Playground
- Abre el Google OAuth 2.0 Playground en una nueva pestaña.
- Haz clic en el icono de engranaje (⚙️) en la esquina superior derecha (OAuth 2.0 configuration).
- Marca la casilla que dice Use your own OAuth credentials (Usar tus propias credenciales OAuth).
- Pega tu OAuth Client ID y tu OAuth Client secret en los campos correspondientes, luego cierra ese panel de configuración.
- En el "Step 1" del panel izquierdo, baja hasta encontrar Blogger API v3, selecciona la opción
https://www.googleapis.com/auth/blogger, y haz clic en el botón azul Authorize APIs. - Inicia sesión con tu cuenta de Google (la misma que pusiste como Test User). Es normal si Google lanza una advertencia de "aplicación no verificada"; simplemente haz clic en "Continuar" o "Avanzado > Ir a la app".
- En el "Step 2", haz clic en el botón azul Exchange authorization code for tokens.
- Copia el valor que aparece en Refresh token (Suele empezar por
1//...).
Paso 4: Configurar el Servidor MCP
Ahora que tienes tus tres datos clave, configúralos como variables de entorno (en tu archivo opencode.json o claude_desktop_config.json):
"env": {
"GOOGLE_CLIENT_ID": "tu_client_id_aqui",
"GOOGLE_CLIENT_SECRET": "tu_client_secret_aqui",
"GOOGLE_REFRESH_TOKEN": "1//tu_refresh_token_aqui"
}
Evitar que el Refresh Token expire cada 7 días
Si tu app OAuth está en modo "Testing" (que es el modo por defecto), Google expira el refresh token automáticamente cada 7 días, obligándote a repetir el Paso 3 constantemente.
Para evitarlo, publica tu app:
- Ve a Google Cloud Console > APIs & Services > OAuth consent screen.
- Haz clic en "PUBLISH APP" (Publicar aplicación).
- El estado cambiará de "Testing" a "In production".
- Repite el Paso 3 una última vez para generar un nuevo refresh token.
- Actualiza el valor de
GOOGLE_REFRESH_TOKENen tu configuración.
Con la app en producción, el token no expirará mientras lo uses al menos una vez cada 6 meses. No necesitas pasar por la verificación de Google para uso personal.
Si el token expira (error invalid_grant)
Si en algún momento recibes el error invalid_grant, solo necesitas repetir el Paso 3 para generar un nuevo refresh token y actualizar la configuración.
Comentarios