Volver

Guía

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

Pasos para usar Hormi desde Claude, Claude Desktop, Claude Code, Codex, Cursor, ChatGPT u otro cliente MCP. Si aún no sabes qué es esto, empieza por qué es MCP y para qué sirve.

Pega la guía en la conversación con tu asistente y pídele que conecte Hormi por ti.

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

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

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:
{
  "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