§00FNZ_MCP/IA.V1 · LA VERSIÓN SIN SIMPLIFICAR

Para tu agente, Finanzy es una API.

Un servidor MCP remoto delante de tus finanzas: herramientas tipadas, permisos por llave y cada llamada registrada. Así se ve la conversación desde el otro lado.

Diagrama: tu agente (un cliente MCP como Claude, ChatGPT, Copilot o Cursor) envía una pregunta al servidor MCP de Finanzy en api.finanzy.app/mcp, que expone 15 herramientas; el servidor consulta tus datos (movimientos, metas, cifrado) y devuelve la respuesta en unos 84 milisegundos. El agente nunca toca la base: solo herramientas, solo con tu llave.

FNZ_TRACE · ÚLTIMA LLAMADAEN VIVO
POST /mcp · tools/call · get_monthly_report 200 · 84 ms
args: { "month": 7, "year": 2026 }scope: read
{ "totalIncome": "5650.00", "totalExpense": "3180.00", … } 1.2 KB
llave fz_7Kd2mQ84… · tls 1.3 · lima-01
§01EL PROTOCOLO

MCP, sin marketing.

Model Context Protocol es el estándar abierto que define cómo un agente descubre y llama herramientas externas: un contrato JSON-RPC con esquemas tipados, permisos y streaming. Finanzy expone un servidor MCP remoto: tu agente lo descubre, lee el esquema de cada herramienta y llama únicamente lo que tu llave permite.

¿Por qué importa? Porque el estándar es del ecosistema, no nuestro. Si mañana cambias de agente, tu capa financiera se muda contigo — sin migrar nada.

SIN LOCK-IN

El protocolo es abierto; tu agente es intercambiable.

EL AGENTE DECIDE CUÁNDO

Elige la herramienta según tu pregunta. Nada corre solo.

TÚ DECIDES QUÉ

Los scopes de tu llave son el límite duro, del lado del servidor.

§02CONEXIÓN

Un endpoint, una llave.

ENDPOINT · HTTP STREAMABLE · JSON-RPC 2.0 · MCP 2025-11-25

https://api.finanzy.app/mcp

Authorization: Bearer fz_7Kd2mQ84…

Una llave por agente · TLS 1.3 · revocación inmediata

CONFIG · CUALQUIER CLIENTE MCP

{
  "mcpServers": {
    "finanzy": {
      "url": "https://api.finanzy.app/mcp",
      "headers": { "Authorization": "Bearer fz_7Kd2mQ84…" }
    }
  }
}

OAUTH 2.1 PARA CONECTORES

En claude.ai y ChatGPT no necesitas llave: pegas la URL y el flujo OAuth pide tu consentimiento.

PKCE + REGISTRO DINÁMICO DE CLIENTESDISCOVERY · /.well-known/oauth-protected-resourceLLAVE fz_ · VÍA DIRECTA PARA CLIENTS, SCRIPTS Y SELF-HOSTED

SCOPE · LEER

Resúmenes, movimientos, metas, presupuestos, categorías. Solo consulta.

SCOPE · REGISTRAR

Crear movimientos, presupuestos, metas, insights y aportes.

§03TOOLS · V1

Las 15 herramientas.

Las 15 herramientas del servidor MCP de Finanzy: nombre, qué hace y scope requerido.
NOMBREQUÉ HACESCOPE
get_accountsCuentas y balances por moneda, con metas vinculadas LEER
get_transactionsMovimientos por rango de fechas, tipo, categoría y cuenta LEER
create_transactionRegistra un gasto o ingreso; con goalId, aporta a una meta REGISTRAR
get_financial_summaryPanorama completo: balances, mes actual, metas y presupuestos LEER
get_monthly_reportReporte mensual con desglose por categoría, uno por moneda LEER
analyze_spendingPatrones de gasto por período, con comparación y tendencias LEER
get_goalsMetas con progreso, aportes recientes y milestones LEER
get_goal_progressDetalle de una meta: avance, ritmo y proyección de término LEER
create_goalCrea una meta con monto objetivo y fecha límite REGISTRAR
get_budgetsPresupuestos con gasto del periodo, porcentaje y alertas LEER
get_budget_progressDetalle de un presupuesto: gastado vs límite y alerta LEER
create_budgetCrea un presupuesto por categoría o global de la moneda REGISTRAR
get_insightsAlertas, recomendaciones y predicciones generadas por IA LEER
create_insightRegistra una alerta, recomendación o predicción REGISTRAR
get_categoriesCategorías del sistema y personalizadas, con id y tipo LEER

CADA TOOL DECLARA SU ESQUEMA; TU AGENTE LO LEE SOLO. LOS SCOPES SE VALIDAN DEL LADO DEL SERVIDOR.

§04AUDITORÍA

Cada llamada queda escrita.

FNZ_ACCESS_LOG · HOYINMUTABLE
09:41claudeget_monthly_report · read200 · 84 ms
09:41claudecreate_transaction · write200 · 96 ms
14:02copilotget_goal_progress · read200 · 61 ms
23:57desconocidocreate_budget · scope insuficiente200 · isError
REVOCACIÓN EN < 1 S LOG EXPORTABLE DENEGACIÓN POR SCOPE, DEL LADO DEL SERVIDOR
§05CHANGELOG · EL TICKER HONESTO

Changelog

V1JUL 2026 Servidor MCP público: 15 herramientas, scopes por llave, OAuth 2.1 y registro de accesos.
EN CAMINO Publicación en el directorio de conectores de Claude y el registro MCP oficial.
EN CAMINO Exportación CSV/PDF y panel de conexiones en Mi Finanzy.

¿Dos minutos libres?
Conéctalo ahora.

La guía no tiene un solo comando. El JSON solo aparece si tú quieres.