# Habla con tus finanzas desde *tu asistente de IA*

> Fuente canónica: https://mcp.frenzeo.com/docs · Actualizado: 12 de octubre de 2026 · Versión del servidor: 2.0.0 · English: https://mcp.frenzeo.com/docs.en.md

El servidor MCP de Frenzeo conecta tu cuenta con Claude, ChatGPT, Codex, Gemini y Grok. Consulta tus cuentas y gastos, analiza tus presupuestos y deudas, y registra movimientos, listas y borradores de factura conversando.

## Requisitos

- Una cuenta de [Frenzeo](https://frenzeo.com). Funciona desde el plan Free.
- La **sincronización en la nube** activada en los espacios que quieras usar. Para crear o editar, el espacio debe sincronizar y tu rol debe ser Propietario o Editor.
- Un asistente compatible con servidores MCP remotos y OAuth: Claude, ChatGPT, Codex, Claude Code, Gemini o Grok.

## Conectar tu asistente

Esta es la dirección del servidor; es la misma para todos los usuarios y asistentes:

```
https://mcp.frenzeo.com/mcp
```

### Claude  _(Web · Escritorio · Móvil)_

1. Abre **Configuración → Conectores**.
2. Busca **Frenzeo** en el [directorio de conectores de Claude](https://claude.ai/directory/connectors/frenzeo), o elige **Añadir conector personalizado** y pega la dirección del servidor.
3. Pulsa **Conectar**.
4. Inicia sesión con tu cuenta de Frenzeo, elige los espacios que compartirás, decide si permites crear y editar, y pulsa **Conectar Frenzeo**.
5. En una conversación, activa Frenzeo desde el menú de herramientas.

### ChatGPT  _(Web · Escritorio · Móvil)_

1. Abre **Configuración → Aplicaciones**.
2. Busca **Frenzeo** o, si aún no aparece, activa el **modo desarrollador** en *Avanzado* y crea una app con la dirección del servidor y autenticación **OAuth**.
3. Inicia sesión con tu cuenta de Frenzeo, elige espacios y permisos, y pulsa **Conectar Frenzeo**.
4. En el chat, elige Frenzeo desde el botón **+** o menciónalo en tu mensaje.

### Codex  _(CLI · IDE)_

Añade el servidor e inicia sesión:

```
codex mcp add frenzeo --url https://mcp.frenzeo.com/mcp
codex mcp login frenzeo
```

O edita `~/.codex/config.toml`:

```
[mcp_servers.frenzeo]
url = "https://mcp.frenzeo.com/mcp"
```

Comprueba la conexión con `codex mcp list` o `/mcp` dentro de Codex.

### Claude Code  _(CLI)_

```
claude mcp add --transport http frenzeo https://mcp.frenzeo.com/mcp
```

Luego ejecuta `/mcp`, elige **frenzeo** y selecciona **Authenticate**.

### Gemini  _(CLI)_

Añade el servidor en `~/.gemini/settings.json`:

```
{
  "mcpServers": {
    "frenzeo": { "httpUrl": "https://mcp.frenzeo.com/mcp" }
  }
}
```

Abre Gemini CLI y ejecuta `/mcp auth frenzeo` para iniciar sesión. Con `/mcp` ves las herramientas disponibles.

### Grok  _(Web)_

1. Ve a **grok.com** → **Configuración → Conectores**.
2. Pulsa **Nuevo conector → Personalizado** y pega la dirección del servidor.
3. Inicia sesión con tu cuenta de Frenzeo, elige espacios y permisos, y pulsa **Conectar Frenzeo**.

## Permisos al conectar

En la pantalla de conexión decides, para cada asistente:

- **Qué espacios comparte.** El asistente solo ve los espacios que marques, con tu mismo rol.
- **Si puede crear y editar.** Está **apagado** por defecto: sin este permiso, el asistente solo consulta. Actívalo para registrar movimientos, crear listas o preparar borradores de factura.

Para cambiar tu elección, desconecta Frenzeo en el asistente y vuelve a conectarlo.

## Qué puedes pedir

### Consultar

- “¿Cuánto dinero tengo en cada una de mis cuentas?”
- “¿En qué categorías gasté más este mes?”
- “¿Cuánto pagué de luz en los últimos tres meses?”
- “¿Qué pagos vencen esta semana?”
- “Muéstrame mi lista del súper y lo que me falta.”

### Analizar  _(Student+)_

- “¿Cómo voy con mis presupuestos? ¿Me puedo dar un gusto de $40?”
- “¿Gasté más que el mes pasado? ¿En qué subió?”
- “¿Cuánto debo en total y cuánto uso de mis tarjetas?”
- “¿Cuál es mi patrimonio neto?”
- “¿Cuáles son los servicios que más facturo?”

### Crear y editar  _(Con permiso)_

- “Gasté $12.50 en almuerzo con la tarjeta de Banco General.”
- “Pasa $200 de Banco General a Ahorros.”
- “Crea una lista para una fiesta de 20 personas con precios estimados.”
- “Divide la compra de $86.40 del Súper 99 en sus productos.”
- “Cámbiale la nota al último gasto: ‘Regalo de mamá’.”
- “Prepárame un borrador de factura para Café Luna por 10 horas de diseño a $35.”

## Herramientas

El asistente elige la herramienta adecuada según lo que pidas. Hay 22 herramientas en tres grupos.

### Consulta  _(Todos los planes)_

- **Mi plan y cupo** — `mi_plan` · Tu plan, consultas y escrituras disponibles, espacios compartidos y si el asistente puede crear. No consume cupo.
- **Mis espacios** — `mis_espacios` · Espacios compartidos con el asistente, tu rol y si puedes editar.
- **Mis cuentas y saldos** — `mis_cuentas` · Cuentas con tipo, saldo y moneda.
- **Mis categorías** — `mis_categorias` · Categorías del sistema y personalizadas, por grupo.
- **Buscar movimientos** — `buscar_movimientos` · Por fechas, tipo, cuenta, categoría, monto o nota. Indica si un movimiento se creó desde un asistente.
- **Resumen de gastos e ingresos** — `resumen_financiero` · Totales de un periodo por grupo, categoría o cuenta, separados por moneda.
- **Mis presupuestos** — `mis_presupuestos` · Presupuestos activos con límite, periodo y alerta.
- **Mis metas de ahorro** — `mis_metas` · Objetivo, ahorrado, lo que falta y fecha.
- **Próximos pagos** — `proximos_pagos` · Suscripciones, servicios, cuotas e ingresos recurrentes.
- **Mis listas** — `mis_listas` · Listas con artículos, cantidades, precios, marcados y proveedor (nombre, enlace e imagen).

### Análisis avanzado  _(Student, Pro y Ultra Pro)_

- **Progreso de presupuestos** — `progreso_presupuestos` · Gastado, disponible y estado de cada presupuesto en su periodo vigente.
- **Comparar periodos** — `comparar_periodos` · Este mes contra el anterior (u otros periodos) y los grupos que más cambiaron.
- **Mis deudas** — `mis_deudas` · Tarjetas, préstamos y cuentas por pagar o cobrar, con uso de crédito y fecha de pago.
- **Patrimonio neto** — `patrimonio_neto` · Activos, pasivos y patrimonio por moneda.
- **Estadísticas de facturación** — `estadisticas_facturas` · Facturado, cobrado y pendiente por mes, y artículos más vendidos. Solo datos agregados.

### Crear y editar  _(Requiere permiso al conectar)_

- **Registrar movimiento** — `registrar_movimiento` · Gasto, ingreso o transferencia entre tus cuentas del mismo espacio. Categoría obligatoria; avisa si parece duplicado.
- **Editar nota o fecha** — `editar_movimiento` · Cambia solo la nota o la fecha. Nunca montos, cuentas ni categorías.
- **Dividir en artículos** — `dividir_movimiento` · Desglosa un gasto o ingreso en artículos. La suma debe igualar el total, así que el saldo no cambia.
- **Crear lista** — `crear_lista` · Compras, regalos, hogar, viaje, proyecto o personalizada, con artículos y proveedor de cada uno.
- **Agregar a una lista** — `agregar_articulos_lista` · Añade artículos con cantidad, precio, proveedor, enlace e imagen.
- **Marcar artículos** — `marcar_articulos` · Marca o desmarca artículos como comprados o listos.
- **Borrador de factura** — `crear_borrador_factura` · Prepara un borrador con cliente, artículos, descuentos e ITBMS. Tú lo revisas y emites en la app.

## Lo que el asistente nunca hace

- **No borra** movimientos, cuentas ni ningún otro dato.
- **No cambia montos, cuentas ni categorías** de un movimiento ya registrado.
- **No emite ni envía facturas**, solo prepara borradores. Tampoco exporta facturas individuales ni datos de tus clientes.
- **No crea espacios ni invita personas.**
- **No firma ni acepta acuerdos entre personas** (préstamos o deudas P2P) en tu nombre.
- **No usa funciones de un plan superior**: impuestos, varias monedas y análisis avanzado siguen las reglas de tu plan.

Lo que crea un asistente aparece en la app marcado con su origen (Claude, ChatGPT, etc.).

## Límites por plan

Los cupos son **por cuenta de usuario** y se comparten entre todos tus asistentes y espacios, propios o compartidos contigo. Una consulta es cada vez que el asistente usa una herramienta; una pregunta puede usar varias.

|  | Free | Student | Pro | Ultra Pro |
| --- | --- | --- | --- | --- |
| Consultas al día | 50 | 250 | 1.000 | Uso justo |
| Escrituras al mes | 20 | 300 | 1.500 | Ilimitadas |
| Análisis avanzado | — | ✓ | ✓ | ✓ |

- **Cada acción cuenta como 1 escritura**, sin importar cuántos artículos tenga: registrar un movimiento, crear una lista con 30 artículos, marcar artículos o crear un borrador de factura.
- Las consultas se renuevan cada día y las escrituras el día 1 de cada mes, a las 00:00 UTC.
- Si una acción falla o el servidor te avisa de un posible duplicado, no se descuenta cupo.
- Los límites de la app siguen aplicando: por ejemplo, cuántas listas o artículos permite el plan del dueño del espacio.
- Las funciones premium dependen del plan del **dueño del espacio**, como en la app: impuestos y varias monedas.

[Ver planes](https://frenzeo.com/planes)

## Seguridad y privacidad

- Inicias sesión con tu propia cuenta mediante **OAuth 2.1** y apruebas el acceso de forma explícita.
- Solo se aceptan conexiones de Claude, ChatGPT, Codex, Gemini y Grok. Cualquier otra aplicación se bloquea en la página de conexión y en el servidor.
- El asistente ve únicamente los espacios que compartiste, con tu mismo rol. Las reglas de seguridad de la base de datos impiden acceder a datos de otras personas.
- Frenzeo no guarda copias de lo que consulta el asistente. Solo registra el uso (herramienta, plataforma y fecha) para los cupos, durante 30 días.

**Importante:** lo que el asistente consulta se envía al proveedor de IA que elegiste (Anthropic, OpenAI, Google o xAI) y se rige por su política de privacidad. Los asistentes pueden equivocarse; Frenzeo no ofrece asesoría financiera, fiscal ni de inversión.

Más detalles en la [política de privacidad del conector](https://mcp.frenzeo.com/policy-privacity).

## Desconectar o revocar el acceso

- **Desde la app de Frenzeo:** Configuración → Asistentes conectados → elige el asistente → Desconectar.
- **Claude:** Configuración → Conectores → Frenzeo → Desconectar.
- **ChatGPT:** Configuración → Aplicaciones → Frenzeo → Desconectar.
- **Codex:** `codex mcp logout frenzeo` · **Claude Code:** `claude mcp remove frenzeo`
- **Gemini CLI:** `/mcp auth` para cerrar sesión o elimina el servidor de `settings.json` · **Grok:** elimina el conector desde su configuración.

## Preguntas frecuentes

**No veo mis movimientos.**

Activa la sincronización en la nube del espacio en la app y espera a que termine. Comprueba también que compartiste ese espacio al conectar.

**El asistente dice que solo tiene acceso de lectura.**

Al conectar no activaste **Permitir crear y editar**. Desconecta Frenzeo en tu asistente y vuelve a conectarlo con el permiso activado.

**¿Por qué me pregunta la categoría?**

La categoría es obligatoria para que tus reportes y presupuestos sean exactos. El asistente te propone las más parecidas.

**Los saldos no reflejan un movimiento recién creado.**

La app recalcula los saldos al sincronizar. Abre Frenzeo y el saldo se actualizará al instante.

**Llegué a mi límite.**

Las consultas se renuevan cada día y las escrituras cada mes. Si necesitas más, [eleva tu nivel](https://frenzeo.com/planes).

**La página de conexión dice que la solicitud expiró.**

Vuelve a pulsar **Conectar** en tu asistente; cada intento genera un enlace nuevo.

## Registro de cambios

- **2.0.0 · oct 2026**: elección de espacios y permiso de escritura al conectar; cupos por plan; análisis avanzado; registrar, editar nota o fecha y dividir movimientos; listas con proveedor; borradores de factura; estadísticas de facturación; plataformas verificadas; disponible en el directorio de conectores de Claude.
- **1.3.0 · 11 oct 2026**: dirección propia `mcp.frenzeo.com/mcp`; tipos de cuenta con nombre legible.
- **1.0.0 · 10 oct 2026**: lanzamiento con 7 herramientas de consulta.

## Soporte

Escríbenos a [soporte@frenzeo.com](mailto:soporte@frenzeo.com). Respondemos en español e inglés, normalmente en 1 a 2 días hábiles.