Conectar con Claude (MCP) | Documentación

MCP (Model Context Protocol) es el estándar que usan los asistentes de IA para conectarse a herramientas externas. Con el servidor MCP de Mis Finanzas al Día puedes preguntarle a Claude por tus gastos, tu patrimonio o tu cartera, y pedirle que apunte movimientos.

Tus datos no se usan para entrenar nada. El servidor MCP se ejecuta en tu ordenador y habla directamente con la API usando tu token.

Requisitos

Node 18 o superior.
Un token creado en Ajustes → API. Empieza con permiso de solo lectura.

Configuración

Claude Desktop

Abre Ajustes → Desarrollador → Editar configuración y añade el servidor a claude_desktop_config.json:

{
  "mcpServers": {
    "misfinanzas": {
      "command": "npx",
      "args": ["-y", "misfinanzas-mcp"],
      "env": {
        "MISFINANZAS_API_KEY": "mfd_tu_token"
      }
    }
  }
}

Reinicia Claude Desktop. El servidor aparecerá en la lista de herramientas disponibles.

Claude Code

Desde la carpeta de tu proyecto:

claude mcp add misfinanzas \
  --env MISFINANZAS_API_KEY=mfd_tu_token \
  -- npx -y misfinanzas-mcp

Otros clientes

Cualquier cliente compatible con MCP sobre stdio funciona. El comando es npx -y misfinanzas-mcp y la única variable obligatoria es MISFINANZAS_API_KEY.

Comprobar que funciona

Pregúntale al asistente:

¿Con qué cuenta de Mis Finanzas al Día estás conectado?

Debería responder con tu email y los permisos del token. Si dice que falta la clave, revisa que el token esté bien copiado y que hayas reiniciado el cliente.

Herramientas disponibles

Herramienta	Permiso	Qué hace
`whoami`	lectura	Comprueba la conexión y los permisos del token.
`get_summary`	lectura	Ingresos, gastos y ahorro de un año o un mes.
`get_net_worth`	lectura	Patrimonio neto en un mes, con activos y deudas.
`get_net_worth_history`	lectura	Evolución mensual del patrimonio.
`list_categories`	lectura	Categorías y subcategorías.
`list_entries`	lectura	Apuntes individuales de ingresos o gastos.
`add_entry`	escritura	Apunta un ingreso o un gasto.
`update_entry`	escritura	Cambia importe, fecha o descripción.
`delete_entry`	escritura	Borra un apunte.
`list_holdings`	lectura	Cartera con valoración y plusvalías.
`list_holding_transactions`	lectura	Movimientos de una posición.
`get_cash`	lectura	Efectivo por bróker y divisa.
`get_benchmarks`	lectura	Cierres de SP500, MSCI World y otros índices.

Con un token de solo lectura, las herramientas de escritura devuelven un error explicando cómo generar uno con permisos.

Qué puedes pedirle

¿Cuánto gasté en comida el mes pasado comparado con la media del año?

Apunta 34,90 € de gasto en Suscripciones, era la renovación del dominio.

¿Cómo ha evolucionado mi patrimonio desde enero?

¿Qué posiciones de mi cartera están en pérdidas?

Compara la rentabilidad de mi cartera con el S&P 500 este año.

Para apuntar gastos no hace falta que busques la categoría antes: add_entry acepta el nombre directamente y, si no lo encuentra, te dice cuáles tienes.

Recomendaciones

Usa dos tokens. Uno de solo lectura para el día a día y otro con escritura solo si vas a apuntar cosas a menudo. Así una conversación que se desmadre no puede tocar tus datos.

Revisa lo que apunta. El asistente puede equivocarse de categoría o de mes. Los apuntes creados desde MCP se ven en la app como cualquier otro y puedes corregirlos ahí.

Revoca cuando dejes de usarlo. Si desinstalas el servidor, borra el token en Ajustes → API.

Problemas frecuentes

«Falta la variable de entorno MISFINANZAS_API_KEY». El bloque env no está donde toca en el JSON de configuración, o el cliente no se ha reiniciado.

«Token no válido, revocado o caducado». El token se copió incompleto (empieza por mfd_ y tiene 52 caracteres) o se borró desde la app.

El servidor no aparece. Comprueba que npx funciona en tu terminal y que tienes Node 18 o superior con node --version.