# Configuración de Cursor IDE

> Conectar Cursor IDE a graph8 mediante MCP usando el conector remoto por OAuth

Source: https://docs.graph8.com/es/developers/cursor-setup/

Conecte Cursor IDE a graph8 para prospectar contactos, ejecutar campañas y consultar sus cuentas e inteligencia mientras escribe código.

> **Tip:**
> graph8 se conecta a Cursor como un **servidor MCP remoto por OAuth** — solo una URL. No hay `session_id` que copiar ni clave de API requerida para el flujo remoto. Cursor le pedirá iniciar sesión la primera vez que lo use.

## Requisitos previos

- Cursor IDE instalado ([descargar](https://cursor.com)) con soporte MCP (versiones recientes)
- Una cuenta de graph8 ([empiece gratis](https://auth.graph8.com/en/signup) — 1000 créditos, sin tarjeta)

## Configuración (OAuth remoto — recomendado)

1. **Agregue graph8 a su configuración MCP**

   Cree o edite `.cursor/mcp.json` en la raíz de su proyecto (o `~/.cursor/mcp.json` para todos los proyectos):

```json
   {
     "mcpServers": {
       "graph8": {
         "url": "https://be.graph8.com/mcp/"
       }
     }
   }
```

2. **Recargue Cursor**

   Cierre y vuelva a abrir Cursor, o recargue la ventana, para que detecte el nuevo servidor.

3. **Autorice (una sola vez)**

   La primera vez que se use una herramienta de graph8, Cursor abrirá una pestaña del navegador. Inicie sesión en graph8 y apruebe la conexión — sin clave de API ni ID de sesión. La concesión se vincula a su cuenta y a la organización que tenga activa al autorizar.

4. **Verifique**

   Abra el chat de IA de Cursor y pregunte: *"¿Qué campañas tengo en graph8?"*

> **Note:**
> También puede agregar servidores MCP desde la interfaz de Cursor: **Configuración → MCP → Add new global MCP server**, y pegue la misma `url`. El archivo `.cursor/mcp.json` anterior es la configuración equivalente que escribe.

## Autohospedado (stdio)

Para entornos headless, CI o si prefiere una clave de API personal en vez de OAuth, ejecute el servidor localmente:

```json
{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "g8_...",
        "G8_MCP_MODE": "all"
      }
    }
  }
}
```

Cree una clave de API personal en **Perfil → Developer**. Consulte [Descripción general de MCP → Modos](https://docs.graph8.com/developers/mcp/#modes) para las opciones de `G8_MCP_MODE` (`dev`, `gtm`, `all`).

## Preguntas de ejemplo

Una vez conectado, pruebe estas consultas en Cursor:

```
Muéstrame mis campañas activas en graph8
```

```
¿Qué cuentas hay en el sector salud?
```

```
Dame el informe de inteligencia de [nombre de cuenta]
```

```
Busca en graph8 contenido sobre precios enterprise
```

## Múltiples organizaciones

La conexión usa la organización que tenía activa al autorizar. Para cambiar: cambie de organización en graph8 y vuelva a autorizar el servidor de graph8 en Cursor (elimínelo y vuelva a agregarlo, o dispare una nueva solicitud OAuth).

## Solución de problemas

Aquí se cubren los aspectos específicos de Cursor. Los problemas genéricos de MCP (autenticación, permisos, análisis de JSON, "herramienta no encontrada") se tratan en las [Preguntas frecuentes sobre MCP](https://docs.graph8.com/developers/mcp-faq/).

### "MCP server not found" o sin herramientas de graph8

- Confirme que `mcp.json` es JSON válido y está en la ubicación correcta (`.cursor/mcp.json` en la raíz del proyecto, o `~/.cursor/mcp.json`).
- Recargue Cursor después de editar — el cliente MCP solo detecta cambios al recargar.

### Otros problemas

- Sesión expirada o fallo de autenticación → [FAQ](https://docs.graph8.com/developers/mcp-faq/#authentication-failed-or-401)
- Permiso denegado → [FAQ](https://docs.graph8.com/developers/mcp-faq/#permission-denied)
- Herramienta no encontrada → [FAQ](https://docs.graph8.com/developers/mcp-faq/#tool-not-found)
- Bucle de redirección OAuth → [FAQ](https://docs.graph8.com/developers/mcp-faq/#oauth-redirect-loop)

## Gestión de la conexión

- **Desconectar**: elimine la entrada `graph8` de `mcp.json` y recargue Cursor. También puede revocar la concesión OAuth desde su Perfil de graph8.
- **Reautorizar**: si Cursor informa un error de autenticación, vuelva a invocar una herramienta de graph8 para reabrir la solicitud OAuth.

## Preguntas frecuentes

### ¿Funciona MCP en el chat y el composer de Cursor?

Las herramientas de graph8 están disponibles en el panel de chat de IA de Cursor. Cuando consulte datos de graph8, Cursor invoca automáticamente las herramientas MCP correspondientes.

### ¿Pueden varios miembros del equipo compartir una conexión?

No. Cada concesión OAuth (o clave de API personal) está vinculada a una cuenta individual de graph8 y a sus permisos. Cada miembro del equipo se conecta con su propia cuenta.

### ¿Cómo desconecto Cursor de graph8?

Elimine la entrada `graph8` de `mcp.json` y recargue Cursor, o revoque la sesión desde su Perfil de graph8.

## Relacionado

- [Descripción general de MCP](https://docs.graph8.com/developers/mcp)
- [Configuración de Claude Code](https://docs.graph8.com/developers/claude-code-setup/)
- [Configuración de Claude Desktop](https://docs.graph8.com/developers/claude-desktop-setup/)