# Cómo conectar el servidor MCP de Hormi a tu asistente de IA

Guía paso a paso para conectar el servidor MCP de Hormi a Claude, Claude Desktop, Claude Code, Codex, Cursor o ChatGPT.

## Requisitos

- Hormi Plus o la prueba gratuita de 14 días activa.
- Una cuenta de Hormi (inicio de sesión con Google).
- La URL del servidor: https://api.hormi.app/mcp

## La primera conexión

Al añadir la URL, tu asistente abre Hormi en el navegador. Inicias sesión con Google si aún no lo has hecho, revisas la pantalla de permisos y apruebas. No hay claves que copiar. Desde ese momento el asistente usa Hormi en tu nombre hasta que lo desconectes.

## Instalación por cliente

### Claude y Claude Desktop

1. Abre Configuración y entra en Conectores.
2. Elige Añadir conector personalizado.
3. Pega la URL https://api.hormi.app/mcp y guarda.
4. La primera vez que lo uses, inicia sesión en Hormi y aprueba los permisos.

### Claude Code

```bash
claude mcp add --transport http --scope user hormi https://api.hormi.app/mcp
```

La primera herramienta que uses abre el inicio de sesión. Si no aparece, ejecuta /mcp dentro de Claude Code y autoriza Hormi desde ahí.

### Codex CLI

```bash
codex mcp add hormi --url https://api.hormi.app/mcp
```

Si te pide autorizar, sigue el enlace que abre en el navegador.

### Codex (app de escritorio)

1. Abre Settings y entra en Integrations & MCP.
2. Elige Add your own.
3. Pega la URL https://api.hormi.app/mcp y guarda.

### Cursor

1. Abre Settings, luego Tools & Integrations y MCP Tools.
2. Elige New MCP Server y añade esta configuración:

```json
{
  "mcpServers": {
    "hormi": {
      "url": "https://api.hormi.app/mcp"
    }
  }
}
```

### ChatGPT

1. Si tu plan permite conectores personalizados, añade la URL desde la configuración de conectores.
2. URL del servidor: https://api.hormi.app/mcp

La disponibilidad de conectores personalizados depende de OpenAI y del plan que tengas.

### Otros clientes

1. Cualquier cliente MCP que soporte el transporte Streamable HTTP con inicio de sesión (OAuth) puede usar la misma URL: https://api.hormi.app/mcp

## Frases de ejemplo

- "Registra 12.500 de supermercado"
- "¿Cuánto gastamos este mes?"
- "¿Qué gastamos en transporte en agosto?"
- "Corrige el gasto de ayer de la farmacia a 3.200"
- "Revisa agosto vs julio. ¿En qué gastamos de más? ¿Cómo ahorramos 200 mil para el viaje?"
- "Registra estos 12 gastos del finde en Córdoba, categoría Viaje, y avisame si alguno ya está."

## Solución de problemas

**La conexión se rechaza y menciona Hormi Plus.** Tu hogar no tiene un plan activo ni una prueba vigente. Activa Hormi Plus desde hormi.app y vuelve a intentarlo.

**No aparece la pantalla de permisos.** Inicia sesión en hormi.app en el mismo navegador y repite la conexión desde el asistente.

**El asistente no encuentra una categoría.** Pídele que liste las categorías del hogar y usa el nombre exacto. Si eres administrador, también puede crearla.

**Quiero dejar de compartir.** Desconecta Hormi desde la configuración de tu asistente. Para revocar una conexión que no reconoces, escribe a support@hormi.app.

## Nota técnica

- Servidor MCP: https://api.hormi.app/mcp
- OAuth 2.1 con PKCE. El token queda ligado a tu cuenta y al cliente que lo pidió; no sirve para nada más.
- Instrucciones para agentes (auth.md): https://hormi.app/auth.md
- Metadatos del recurso protegido: https://api.hormi.app/.well-known/oauth-protected-resource
- Tarjeta del servidor MCP: https://api.hormi.app/mcp/server-card

Más información: https://hormi.app/mcp
Esta guía en Markdown: https://hormi.app/docs/mcp.md