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 conectar Hormi, tu asistente abre la app 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

  1. En Claude Code o en una terminal, añade el marketplace e instala el plugin:

Plugin (recomendado)

claude plugin marketplace add hormiapp/hormi-plugins
claude plugin install hormi@hormi

Solo el servidor, sin el plugin

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, o en Aplicaciones conectadas de la app (https://hormi.app/app/settings). Para revocar una conexión que no reconoces, escribe a support@hormi.app.

Permisos, datos y cómo desconectar

Conectar un asistente no le entrega tu cuenta. Inicias sesión una vez en Hormi y apruebas una lista concreta de permisos; a partir de ahí el asistente actúa en tu hogar activo con esos permisos y ninguno más. La conexión es entre tu asistente y tu cuenta: los demás miembros del hogar no quedan conectados ni ven la conversación.

  • Lo que puede hacer: registrar, corregir y borrar tus propios gastos e ingresos, consultar el gasto del hogar por categoría y por miembro, leer el reporte mensual y, si eres administrador, gestionar las categorías compartidas.
  • Lo que nunca puede hacer: no existe ningún permiso para tu cuenta, tu suscripción, ni para añadir o quitar miembros del hogar. Tampoco ve los gastos privados de otros miembros, ni puede editar o borrar registros que no sean tuyos.
  • Qué sale de Hormi: solo las respuestas a lo que el asistente consulta, y van únicamente al asistente que conectaste. El servidor no envía mensajes, correos ni notificaciones de ningún tipo.

Puedes cortar la conexión cuando quieras: desconecta Hormi desde la configuración de tu asistente, desde Aplicaciones conectadas en la app (https://hormi.app/app/settings), o escribe a support@hormi.app para revocar un acceso que no reconoces. Al revocarlo, el permiso deja de funcionar de inmediato y el asistente vuelve a no tener acceso; los gastos que ya registró siguen en tu hogar, como cualquier otro registro.

Nota técnica