# Conectar tu agente

> Cómo añadir Dilohost a Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, OpenCode u otro cliente MCP, cómo se autoriza el acceso y cómo retirarlo.

Dilohost es un servidor MCP (Model Context Protocol) remoto. Lo añades una vez a tu agente, autorizas el acceso en dilohost.es y a partir de ahí tu agente puede publicar, consultar y cambiar cosas en tu cuenta cuando se lo pidas.

La dirección del servidor es la misma para todos los agentes:

```text
https://mcp.dilohost.es/mcp
```

## Antes de empezar

- Una cuenta de Dilohost con el **correo confirmado**. Si aún no tienes, créala en [dilohost.es/register](https://dilohost.es/register).
- Un agente compatible con servidores MCP remotos (transporte Streamable HTTP). Los de esta página lo están.

## Cómo funciona el inicio de sesión

Dilohost usa **OAuth 2.1**, el mismo sistema que «Iniciar sesión con Google»: tu agente nunca ve tu contraseña.

1. Añades el servidor a tu agente (los pasos de cada uno, más abajo).
2. Al conectarse por primera vez, el agente abre **dilohost.es** en tu navegador. Si no tienes la sesión iniciada, entras con tu correo y contraseña (y tu segundo factor, si lo usas) o con Google.
3. Ves una pantalla de autorización con:
   - el nombre del agente que pide acceso («Claude Code quiere usar tu cuenta de Dilohost»);
   - con qué correo has iniciado sesión;
   - qué podrá hacer: usar tu cuenta para ver y gestionar tus proyectos, webs, bases de datos y dominios;
   - quién verifica la identidad del agente y a dónde volverá el acceso (por ejemplo, «esta misma máquina» si el agente corre en tu ordenador).
4. Pulsas **Autorizar** y vuelves a tu agente, ya conectado.

La pantalla sale **siempre**, también si ya autorizaste a ese agente antes: así ningún programa puede conectarse a tu cuenta sin que tú lo veas.

> [!WARNING]
> Autoriza solo si acabas de pedir la conexión tú. Si la pantalla dice que el acceso irá a un dominio que no reconoces, pulsa **Cancelar**.

El acceso dura una hora y el agente lo renueva solo mientras lo uses. Si pasas 30 días sin usarlo, te pedirá autorizarlo otra vez.

### Si perteneces a varias cuentas

Si alguien te ha invitado a su cuenta además de tener la tuya, no tienes que conectar el agente dos veces. Por defecto el agente trabaja en tu cuenta; para la otra, díselo:

<p class="prompt">En la cuenta de mi socia, lista los proyectos.</p>

El agente pasa el identificador de esa cuenta en cada llamada (el parámetro `account`). Si no sabe cuál es, pregúntale qué cuentas tienes: te las enseña con `account.info`. Ver [Equipo](/docs/cuenta/equipo).

## Pasos para cada agente

### Claude Code

1. Añade el servidor:

   ```bash
   claude mcp add --transport http dilohost https://mcp.dilohost.es/mcp
   ```

2. Dentro de Claude Code escribe /mcp y elige Dilohost para iniciar sesión.

### Codex

1. Añade el servidor e inicia sesión:

   ```bash
   codex mcp add dilohost --url https://mcp.dilohost.es/mcp
   codex mcp login dilohost
   ```


### OpenCode

1. En opencode.json (del proyecto o ~/.config/opencode/):

   ```json
   {
       "$schema": "https://opencode.ai/config.json",
       "mcp": {
           "dilohost": {
               "type": "remote",
               "url": "https://mcp.dilohost.es/mcp"
           }
       }
   }
   ```

2. Inicia sesión:

   ```bash
   opencode mcp auth dilohost
   ```


### Gemini CLI

1. Añade el servidor:

   ```bash
   gemini mcp add --transport http dilohost https://mcp.dilohost.es/mcp
   ```

2. Dentro de Gemini CLI escribe /mcp auth dilohost para iniciar sesión.

### Cursor

1. En ~/.cursor/mcp.json (o .cursor/mcp.json del proyecto):

   ```json
   {
       "mcpServers": {
           "dilohost": {
               "url": "https://mcp.dilohost.es/mcp"
           }
       }
   }
   ```

2. Cursor te pedirá iniciar sesión en Dilohost la primera vez.

### VS Code · GitHub Copilot

1. En .vscode/mcp.json:

   ```json
   {
       "servers": {
           "dilohost": {
               "type": "http",
               "url": "https://mcp.dilohost.es/mcp"
           }
       }
   }
   ```

2. Pulsa «Iniciar» sobre el servidor y autoriza el acceso.

### claude.ai · Claude Desktop

1. Ajustes → Conectores → Añadir conector personalizado, con esta dirección:

   ```text
   https://mcp.dilohost.es/mcp
   ```


### ChatGPT

1. Ajustes → Aplicaciones y conectores → modo desarrollador → Crear, con esta dirección y autenticación OAuth:

   ```text
   https://mcp.dilohost.es/mcp
   ```


### Otros agentes

1. Cualquier cliente MCP con Streamable HTTP y OAuth 2.1 (PKCE). Dirección del servidor:

   ```text
   https://mcp.dilohost.es/mcp
   ```

2. Si tu agente o tu CI no admite OAuth, crea un token de servicio en el panel y mándalo como cabecera:

   ```text
   Authorization: Bearer dhs_…
   ```


## Comprueba la conexión

Pídele a tu agente:

<p class="prompt">¿Con qué cuenta de Dilohost estás conectado y qué plan tengo?</p>

Te contestará con tu correo, tu plan y lo que tienes en uso (`account.info`). Si en lugar de eso dice que no encuentra Dilohost, revisa que el servidor esté añadido y activo en tu agente.

## Desconectar un agente

Para retirar el acceso a un agente:

1. Entra en tu panel de [dilohost.es](https://dilohost.es/panel/ajustes) → **Ajustes**.
2. En **Agentes conectados**, pulsa **Desconectar** junto al agente.

Deja de poder usar tu cuenta en el acto. Para volver a usarlo tendrás que autorizarlo de nuevo. En **Ajustes** también ves el **registro de los agentes**: cada operación que han hecho en tu cuenta.

Quitar el servidor de la configuración de tu agente no retira el acceso en Dilohost: para eso, desconéctalo desde el panel.

## Agentes sin OAuth e integración continua

Si tu programa o tu sistema de integración continua no puede iniciar sesión en el navegador, usa un **token de servicio**: lo creas en el panel y se envía como cabecera `Authorization: Bearer dhs_…`. Ver [Tokens de servicio](/docs/cuenta/tokens).

## Problemas frecuentes

| Qué pasa | Qué hacer |
|---|---|
| Al autorizar me pide confirmar el correo | Abre el enlace del correo de bienvenida (o pide otro desde dilohost.es) y vuelve a conectar. |
| El agente dice que no tiene acceso o que la sesión caducó | Vuelve a iniciar sesión desde tu agente (en Claude Code, `/mcp`). Si lo desconectaste en el panel, hay que autorizarlo de nuevo. |
| El agente no ve las herramientas de Dilohost | Comprueba que la dirección es exactamente `https://mcp.dilohost.es/mcp` y que el servidor está activado en tu agente. |
| Trabaja en la cuenta equivocada | Dile en qué cuenta quieres trabajar; ver «Si perteneces a varias cuentas». |

Más casos en [Solución de problemas](/docs/ayuda/problemas).

## Relacionado

- [Inicio rápido](/docs/inicio-rapido)
- [Ejemplos de peticiones](/docs/ejemplos)
- [Servidor MCP: detalles técnicos](/docs/referencia/servidor-mcp)
- [Seguridad](/docs/seguridad)