Cómo conectar MCP a Cursor: guía rápida paso a paso
Conectar MCP a Cursor te permite preguntarle al agente cosas como «¿qué URLs perdieron clics en GSC este mes?» sin salir del editor. MCP (Model Context Protocol) es el estándar que une Cursor con herramientas externas: APIs de Google, Semrush, Screaming Frog y docenas de servidores de la comunidad.
Esta guía es la base. Si ya sabes lo mínimo, en los siguientes posts conectamos herramientas concretas: Semrush y Screaming Frog (cuenta de pago) y GSC, GA4, PageSpeed y CrUX.
¿Qué necesitas antes de empezar?
| Requisito | Para qué sirve |
|---|---|
| Cursor actualizado | Soporte nativo de MCP en Settings → Tools & MCP |
| Cuenta en la herramienta | GSC, GA4, Semrush, licencia de Screaming Frog… |
| Google Cloud (solo APIs Google) | Proyecto, APIs activadas y cuenta de servicio |
| Rutas absolutas | En command y rutas a JSON de credenciales |
No hace falta ser desarrollador. Sí hace falta paciencia la primera vez: copiar JSON, reiniciar Cursor y comprobar que el punto verde aparece. En consultoría o en una agencia de marketing digital, el primer MCP que suele estandarizarse es GSC o GA4: menos exportar CSV y más preguntas directas al agente.
Paso 1: elige dónde guardar la configuración
Tienes dos sitios válidos:
- Global:
~/.cursor/mcp.json, el mismo setup en todos los proyectos. - Por proyecto:
.cursor/mcp.jsonen la raíz del repo, ideal si compartes config con el equipo (sin secretos en git).
Abre el archivo desde Cursor → Settings → Tools & MCP → Edit o créalo a mano.
Estructura mínima (vacía, lista para rellenar):
{
"mcpServers": {}
}
Cada servidor es una clave dentro de mcpServers. Si añades varios, separa con coma, un error típico es pegar dos JSON seguidos y romper la sintaxis.
Paso 2: dos formas de conectar un servidor
Opción A: Comando local (stdio)
Cursor ejecuta un binario y habla con él por stdin/stdout. Patrón habitual con npx:
{
"mcpServers": {
"gsc": {
"command": "npx", "args": ["-y", "mcp-server-google-search-console"], "env": {
"GSC_SERVICE_ACCOUNT_KEY_FILE": "/Users/tu-usuario/.config/gsc/service-account.json"
}
}
}
}
El flag -y en npx evita que se quede colgado pidiendo confirmación.
Opción B: URL remota (HTTP)
Sin instalar nada local. Ejemplo oficial de Semrush:
{
"mcpServers": {
"semrush": {
"url": "https://mcp.semrush.com/v2/mcp"
}
}
}
La primera vez, Cursor te redirige a login OAuth. Con API key, añades cabecera Authorization: Apikey TU_CLAVE.
Paso 3: Google Cloud Console (solo herramientas Google)
Para GSC, GA4 o PageSpeed el flujo es parecido:
- Entra en Google Cloud Console.
- Crea o elige un proyecto.
- APIs y servicios → Biblioteca → activa la API que toque:
- Search Console API
- Google Analytics Admin API + Analytics Data API
- PageSpeed Insights API
- Credenciales → Crear credenciales → Cuenta de servicio → descarga el JSON.
- En la herramienta (GSC o GA4), añade el email de la cuenta de servicio con permiso Lector o Ver.
Guarda el JSON fuera del repo. En mcp.json usa siempre ruta absoluta:
# macOS / Linux: ejemplo de ruta
/Users/marco/.config/google/service-account-seo.json
Paso 4: reinicia Cursor y verifica
- Guarda
mcp.json. - Cierra Cursor por completo (no basta recargar la ventana en muchos casos).
- Abre de nuevo → Settings → Tools & MCP.
- Debe verse el servidor en verde y un número de tools.
Prueba en el chat del agente:
Lista las herramientas del MCP de GSC y dime si tienes acceso a Search Console.
Si responde con datos o confirma herramientas, la conexión funciona.
Comandos útiles en terminal (antes de culpar a Cursor)
Comprueba que el servidor arranca fuera de Cursor:
# Ejemplo: GSC vía npx (sustituye la variable por tu ruta real)
export GSC_SERVICE_ACCOUNT_KEY_FILE="$HOME/.config/gsc/key.json"
npx -y mcp-server-google-search-console
Para Semrush no hace falta terminal: solo la URL en mcp.json y OAuth en el navegador.
Screaming Frog (v24+) expone MCP en local cuando el Spider está abierto:
# Comprueba que responde (con SF abierto y MCP activado)
curl -s http://127.0.0.1:11435/mcp
En Cursor, la clave del servidor conviene que sea corta ("sf") para no superar límites de nombre de herramienta.
Errores que verás una y otra vez
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| JSON syntax error | Coma de más, dos { seguidos | Valida en jsonlint.com |
| Servidor rojo / 0 tools | command no está en PATH | Ruta absoluta a node/npx |
| OAuth no abre | Popup bloqueado | Autoriza manualmente desde el enlace que muestra Cursor |
| GSC sin datos | Cuenta de servicio sin acceso a la propiedad | Añádela en GSC → Configuración → Usuarios |
| GA4 vacío | Property ID incorrecto | Usa el ID numérico de propiedad, no el Measurement ID (G-XXXX) |
Qué sigue: conectar herramientas reales
Esta guía es el esqueleto. Los pasos concretos por herramienta están en:
- Semrush y Screaming Frog en Cursor: cuentas de pago, OAuth y crawl local.
- GSC, GA4, PageSpeed y CrUX en Cursor: stack Google con Cloud Console y servidores gratuitos o de bajo coste.
La idea no es acumular MCPs por postureo. Empieza por uno (GSC o GA4 suele ser lo más útil), domínalo, y añade el siguiente cuando tengas un flujo claro de preguntas que quieres hacerle al agente.