# Configuración de Claude Desktop

> Conectar Claude Desktop (y Claude.ai) a graph8 mediante MCP usando el conector remoto por OAuth

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

Conecte Claude a graph8 para preguntar sobre sus campañas, cuentas, contactos e inteligencia —y ejecutar herramientas de graph8— directamente en una conversación.

> **Tip:**
> Ahora Claude se conecta a graph8 como un **conector remoto por OAuth**. No hay archivo de configuración que editar, ni `session_id` que copiar, ni comando `npx` que ejecutar. Agrega la URL del servidor de graph8 una sola vez en la interfaz de Claude e inicia sesión cuando se te solicite.

## La interfaz cambió — dónde agregar graph8 ahora

Anthropic reemplazó el antiguo flujo de edición de `claude_desktop_config.json` por una interfaz de **Conectores** dentro de la aplicación. Si busca el archivo de configuración o un paso de "pegar este JSON", ese flujo ya no existe para servidores remotos. Agregue graph8 aquí:

| Cliente | Dónde agregar un conector personalizado |
|--------|---------------------------------|
| **Claude.ai** (web) | **Configuración → Conectores → Agregar conector personalizado** |
| **Claude Desktop** (app) | **Configuración → Conectores → Agregar conector personalizado** (en versiones antiguas se llama **Servidores MCP → Agregar**) |

Si su menú muestra **Extensiones** o **Complementos** en lugar de **Conectores**, use **Agregar conector personalizado** / **Agregar** en ese panel — es el mismo punto de entrada de MCP remoto con otra etiqueta según su versión de Claude.

## Requisitos previos

- Claude Desktop instalado ([descargar](https://claude.ai/download)) o una cuenta de [Claude.ai](https://claude.ai)
- Una cuenta de graph8 ([empiece gratis](https://auth.graph8.com/en/signup) — 1000 créditos, sin tarjeta)

## Configuración

1. **Abra la configuración de conectores**

   En Claude.ai vaya a **Configuración → Conectores → Agregar conector personalizado**. En Claude Desktop vaya a **Configuración → Conectores → Agregar conector personalizado** (o **Servidores MCP → Agregar** en versiones antiguas).

2. **Pegue la URL del servidor de graph8**

```
   https://be.graph8.com/mcp/
```

3. **Agregue y conecte**

   Haga clic en **Agregar** y luego en **Conectar**. Claude abrirá una pestaña del navegador hacia graph8.

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

   Inicie sesión en graph8 y apruebe la conexión. Regresará a Claude automáticamente. No se requiere clave de API ni ID de sesión — la concesión OAuth queda ligada a su cuenta de graph8 y a la organización que tenga activa al conectarse.

5. **Verifique**

   Inicie una conversación nueva y pregunte: *"¿Qué campañas tengo en graph8?"*

> **Note:**
> ¿Prefiere ejecutar el servidor localmente (entornos headless, CI o trabajo aislado)? Use la opción stdio con una clave de API personal — consulte [Configuración de Claude Code → MCP autohospedado (stdio)](https://docs.graph8.com/developers/claude-code-setup/#self-hosted-mcp-stdio) para el comando `g8-mcp-server`.

## Preguntas de ejemplo

Una vez conectado, pruebe a preguntarle a Claude:

```
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 posicionamiento competitivo
```

```
¿Qué oportunidades tengo en mi pipeline?
```

## Cómo funciona

Claude usa MCP (Model Context Protocol) para conectarse a graph8:

1. Cuando usted menciona datos de graph8, Claude reconoce que necesita información externa.
2. Claude invoca la herramienta de graph8 correspondiente (como `g8_list_campaigns` o `g8_search_contacts`).
3. El servidor MCP de graph8 se autentica con su concesión OAuth y obtiene los datos.
4. Claude da formato a los resultados y los presenta en la conversación.

## Múltiples organizaciones

La conexión usa la organización que tenía activa en graph8 al autorizar. Para cambiar:

1. Cambie de organización en graph8.
2. En Claude, elimine el conector de graph8 y vuelva a agregarlo (**Configuración → Conectores**).
3. Vuelva a autorizar; la nueva concesión se vincula a la organización recién activada.

## Gestión de la conexión

- **Desconectar**: elimine el conector de graph8 en **Configuración → Conectores** de Claude o revoque la concesión desde su Perfil de graph8.
- **Reautorizar**: si Claude informa un error de autenticación, abra el conector y haga clic en **Conectar** de nuevo para renovar la concesión OAuth.

## Solución de problemas

Aquí se cubren los detalles específicos de Claude. Los problemas genéricos de MCP (autenticación, permisos, "herramienta no encontrada") se resuelven en las [Preguntas frecuentes de MCP](https://docs.graph8.com/developers/mcp-faq/).

### No encuentro "Conectores" en el menú

Según su versión de Claude, la entrada puede llamarse **Conectores**, **Servidores MCP**, **Extensiones** o **Complementos**. En todos los casos, busque **Agregar conector personalizado** / **Agregar** y pegue `https://be.graph8.com/mcp/`. Actualice Claude a la última versión si no ve ninguna de estas opciones.

### Claude no reconoce los comandos de graph8

- Confirme que el conector de graph8 aparece como **Conectado** en **Configuración → Conectores**.
- Inicie una conversación nueva después de conectar.
- Si sigue fallando, elimine y vuelva a agregar el conector, luego reautorice.

### Otros problemas

- Sesión expirada o error 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)

## Privacidad y seguridad

- Sus datos de graph8 se obtienen en tiempo real y Claude no los almacena.
- Todas las solicitudes usan su concesión OAuth autenticada, limitada a su cuenta y organización activa.
- Puede revocar el acceso en cualquier momento desde su Perfil de graph8 o eliminando el conector en Claude.
- Las llamadas a la API se registran con fines de auditoría.

## 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 Cursor IDE](https://docs.graph8.com/developers/cursor-setup/)