Integración del asistente y MCP

El servidor MCP de LUMA da a herramientas de IA como Claude, Cursor, ChatGPT y Raycast acceso completo a los datos de tu negocio — no solo lectura, sino también creación de facturas, gestión de transacciones, control de tiempo y exportación para tu asesoría.

#¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto para conectar asistentes de IA con fuentes de datos externas. En lugar de copiar y pegar datos, MCP permite que las herramientas de IA trabajen directamente y de forma segura con tu cuenta de LUMA.

#Herramientas compatibles

MCP de LUMA funciona con:

• Claude Desktop - la app de escritorio de Anthropic
• Cursor - editor de código con IA integrada
• ChatGPT - mediante plugins/acciones
• Raycast - lanzador de productividad para Mac
• Cualquier cliente compatible con MCP

#Primeros pasos

#Paso 1: Obtén tu clave de API

1. Ve a Ajustes → Desarrollador
2. Haz clic en Crear clave de API
3. Dale un nombre descriptivo (por ejemplo, "Claude Desktop")
4. Selecciona los scopes que necesites (solo lectura por defecto; activa los scopes de escritura para tener todas las funciones)
5. Copia la clave inmediatamente (no podrás volver a verla)

#Paso 2: Configura tu cliente

Elige tu herramienta a continuación para ver las instrucciones de configuración específicas.

---

#Configuración de Claude Desktop

Añade LUMA a la configuración de Claude Desktop.

#Encuentra tu archivo de configuración

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

#Añade la configuración de LUMA

Añade o actualiza la sección mcpServers:

{
  "mcpServers": {
    "midday": {
      "command": "npx",
      "args": ["-y", "@midday-ai/mcp"],
      "env": {
        "MIDDAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

#Reinicia Claude Desktop

Después de guardar, reinicia Claude Desktop. Deberías ver LUMA entre tus herramientas disponibles.

#Pruébalo

Pídele a Claude algo como:

• "¿Cuál fue mi facturación el mes pasado?"
• "Crea una factura para Acme Corp"
• "Exporta las transacciones del Q1 para mi asesoría"

---

#Configuración de Cursor

Usa los datos de LUMA mientras programas en Cursor.

#Abre los ajustes de Cursor

1. Abre Cursor
2. Ve a Ajustes (Cmd/Ctrl + ,)
3. Busca la sección de configuración de MCP

#Añade LUMA

Añade a tus servidores MCP:

{
  "midday": {
    "command": "npx",
    "args": ["-y", "@midday-ai/mcp"],
    "env": {
      "MIDDAY_API_KEY": "your-api-key-here"
    }
  }
}

#Úsalo en las conversaciones

En el chat de IA de Cursor ya puedes preguntar por tus datos financieros mientras trabajas en tus proyectos.

---

#Configuración de ChatGPT

Usa LUMA con ChatGPT a través de GPTs personalizados o plugins.

#Enfoque con GPT personalizado

1. Crea un GPT personalizado en ChatGPT
2. Añade acciones que llamen a la API de LUMA
3. Configura la autenticación con tu clave de API

#Configuración

Usa los endpoints de la API de LUMA con tu clave de API en la cabecera Authorization:

Authorization: Bearer your-api-key-here

Consulta la referencia de la API para ver los endpoints disponibles.

---

#Configuración de Raycast

Accede a LUMA desde Raycast en Mac.

#Instala la extensión

1. Abre Raycast
2. Busca "LUMA" en la Store
3. Instala la extensión

#Configúrala

1. Abre las preferencias de Raycast
2. Busca la extensión de LUMA
3. Introduce tu clave de API

#Úsala

Activa Raycast y usa los comandos de LUMA para consultar tus datos financieros.

---

#Herramientas disponibles

El servidor MCP expone 107 herramientas que cubren todo el flujo de trabajo de tu negocio.

#Transacciones

Ejemplos de consultas:

• "Muéstrame las transacciones del mes pasado"
• "¿Cuánto gasté en software este trimestre?"
• "Categoriza todas mis transacciones de Stripe como ingresos"
• "Etiqueta estas transacciones como deducibles"

#Exportación y contabilidad

Ejemplos de consultas:

• "Exporta mis transacciones de enero a mi asesoría, a lisa@accounting.com"
• "Envía los gastos del mes pasado a QuickBooks"
• "¿Qué software contable tengo conectado?"
• "Descarga todas las transacciones del Q1 en CSV"

#Facturas

Ejemplos de consultas:

• "Crea una factura para Acme Corp por 10 horas de consultoría a 150 $/h"
• "Envía la factura en borrador a Acme Corp"
• "Recuerda a Beta Inc su factura vencida"
• "Marca la factura INV-0042 como pagada"
• "¿Qué facturas están vencidas?"
• "Factura el tiempo que registré en el Proyecto X este mes"

#Plantillas de factura

#Productos de factura

#Facturas recurrentes

#Clientes

Ejemplos de consultas:

• "Lista todos mis clientes"
• "Añade un nuevo cliente: Acme Corp, acme@example.com"
• "Actualiza la dirección de facturación de Acme Corp"

#Control de tiempo

Ejemplos de consultas:

• "¿Cuántas horas he registrado esta semana?"
• "Inicia un cronómetro en el Proyecto X"
• "Registra 2 horas por la reunión de ayer con el cliente"
• "¿Qué queda por facturar en el Proyecto X?"

#Informes y analítica

Ejemplos de consultas:

• "¿Cuál es mi facturación este trimestre?"
• "Calcula mi runway"
• "Muéstrame el gasto por categoría del mes pasado"
• "¿Cuál es mi tasa de crecimiento comparada con el trimestre anterior?"
• "Dame un balance de situación a fecha de hoy"

#Categorías

#Etiquetas

#Cuentas bancarias

Ejemplos de consultas:

• "¿Cuál es mi saldo de caja actual?"
• "Muéstrame todas las cuentas conectadas"
• "¿Qué monedas usan mis cuentas?"

#Documentos

#Bandeja de entrada

Ejemplos de consultas:

• "Muéstrame mis recibos sin procesar"
• "Vincula este recibo con la transacción de Stripe"

#Búsqueda y equipo

---

#Ejemplos de conversaciones

#Visión financiera general

Tú: ¿Cómo está mi salud financiera?

Asistente: Según tus datos de LUMA:

• Saldo de caja: 45.230 $
• Tasa de consumo mensual: 8.500 $
• Runway: 5,3 meses
• Facturación este mes: 12.400 $
• Margen de beneficio: 31%

#Crear y enviar una factura

Tú: Crea una factura para Acme Corp por el rediseño de la web: 40 horas a 125 $/h

Asistente: He creado la factura en borrador INV-0051 para Acme Corp:

• Rediseño de la web: 40 × 125,00 $ = 5.000,00 $
• Total: 5.000,00 $

¿Quieres que la envíe?

Tú: Sí, envíala

Asistente: La factura INV-0051 se ha enviado a billing@acmecorp.com.

#Exportar a la asesoría

Tú: Exporta mis transacciones de enero a mi asesoría, a lisa@accounting.com

Asistente: He iniciado la exportación de 142 transacciones de enero. Tu asesoría (lisa@accounting.com) recibirá un enlace de descarga con el CSV, el XLSX y los recibos adjuntos en cuanto esté listo.

#Enviar a un software contable

Tú: Envía los gastos del mes pasado a QuickBooks

Asistente: Tienes QuickBooks conectado (Acme Corp LLC). Voy a exportar 87 transacciones de gasto del mes pasado. La sincronización está en curso: las transacciones y sus recibos se están enviando a QuickBooks ahora mismo.

#Control de tiempo

Tú: ¿Cuántas horas he trabajado en la app móvil esta semana?

Asistente: Has registrado 18,5 horas en "Rediseño de la app móvil" esta semana:

• Lunes: 4h (diseño de UI)
• Martes: 3,5h (integración de API)
• Miércoles: 5h (pruebas)
• Jueves: 3h (corrección de errores)
• Viernes: 3h (documentación)

---

#Scopes y permisos

Cada herramienta está protegida por scopes. Cuando creas una clave de API o autorizas mediante OAuth, eliges exactamente qué datos y acciones son accesibles. Por ejemplo, transactions.read permite listar y buscar transacciones, mientras que transactions.write además permite crearlas, actualizarlas y eliminarlas.

Consulta la referencia completa de scopes OAuth para ver la lista completa de scopes disponibles.

---

#Seguridad

#Permisos de las claves de API

• Las claves de API tienen scopes configurables — elige exactamente a qué puede acceder cada clave
• Los scopes de lectura permiten consultar datos; los de escritura permiten crear, modificar y exportar
• Las claves nunca exponen credenciales sensibles, contraseñas ni datos de tarjetas de pago

#Gestión de claves

1. Ve a Ajustes → Desarrollador
2. Consulta todas las claves de API activas
3. Comprueba la fecha de último uso de cada clave
4. Revoca las claves que ya no necesites

#Buenas prácticas

• Crea claves distintas para cada herramienta
• Usa nombres descriptivos para las claves
• Concede solo los scopes que cada herramienta necesita realmente
• Revoca las claves que no uses
• No compartas las claves públicamente

---

#Solución de problemas

#Errores de "herramienta no encontrada"

• Asegúrate de haber reiniciado tu cliente tras la configuración
• Comprueba que la clave de API es válida y tiene los scopes necesarios
• Verifica la sintaxis de la configuración

#No se devuelven datos

• Comprueba que tu clave de API tiene acceso al equipo
• Verifica que existen transacciones/facturas para el periodo consultado
• Prueba con una consulta más amplia

#Fallan las operaciones de escritura

• Asegúrate de que tu clave de API tiene habilitados los scopes de escritura adecuados
• Comprueba que se proporcionan los campos obligatorios (por ejemplo, el ID de cliente para facturas)

#Problemas de conexión

• Asegúrate de tener acceso a internet
• Comprueba que npx está disponible en tu PATH
• Prueba a ejecutar npx @midday-ai/mcp manualmente para comprobarlo

---

#Consejos para obtener mejores resultados

1. Sé específico: "Facturación el mes pasado" funciona mejor que "¿Cómo me va?"
2. Incluye fechas: "Gastos en el Q1 de 2025" ayuda a acotar los resultados
3. Usa el contexto de la conversación: el asistente recuerda el contexto dentro de una misma conversación
4. Combina acciones: "Crea una factura para Acme Corp y envíala" funciona en un solo paso
5. Pregunta antes por las conexiones: "¿Qué software contable tengo conectado?" antes de exportar

Descubre el asistente integrado en la app → Referencia de la API →