Saltar al contenido principal
Logo de QuickBillingQuickBilling

Model Context Protocol

Documentación del servidor MCP

Conecta Claude Desktop, Cursor y otros clientes MCP con soporte para servidores remotos a QuickBilling. Añade una URL e inicia sesión con tu cuenta de QuickBilling.

¿Qué es el servidor MCP de QuickBilling?

Un servidor MCP remoto alojado que expone QuickBilling como herramientas tipadas para asistentes de IA.

El Model Context Protocol (MCP) permite a los asistentes de IA llamar a herramientas estructuradas en lugar de leer una interfaz.

QuickBilling ofrece un servidor MCP remoto alojado en https://mcp.quickbilling.io/mcp (HTTP en streaming). Lo añades a un cliente MCP con soporte para servidores remotos e inicias sesión con tu cuenta de QuickBilling.

En la práctica

  • Tu asistente puede crear facturas, registrar gastos, gestionar clientes y generar informes desde el chat
  • 129 herramientas para facturación y gastos
  • El inicio de sesión usa OAuth 2.1 con PKCE y tu cuenta de QuickBilling, no una clave de API
  • Cada llamada se ejecuta con los permisos de tu cuenta

Ideal para: autónomos y equipos que ya trabajan en Claude Desktop, Cursor u otro cliente MCP y quieren facturar sin pasar por un panel.

API para productos, MCP para asistentes

Los mismos datos, dos formas de acceder.

Usa la API REST cuando integres la facturación en tu propio producto o automatización. Las claves de API forman parte del plan Unlimited.

Usa el servidor MCP cuando una persona maneja un asistente de IA y quiere acceder a los mismos datos con lenguaje natural.

QuickBilling MCP está pensado para

  • Claude Desktop, añadido como conector remoto personalizado
  • Cursor y otros clientes con soporte para servidores MCP remotos
  • Cualquier cliente MCP que admita servidores remotos con inicio de sesión OAuth

Cada herramienta corresponde a una llamada real y autenticada con los permisos de la cuenta conectada.

Inicio rápido

Añade una URL e inicia sesión.

Requisitos: una cuenta de QuickBilling y un cliente MCP que admita servidores remotos con inicio de sesión OAuth.

Pasos

  1. Abre los ajustes de tu cliente MCP y añade un servidor MCP remoto
  2. Usa la URL https://mcp.quickbilling.io/mcp
  3. Inicia sesión con tu cuenta de QuickBilling cuando el cliente te pida autorizar la conexión
  4. Pregunta a tu asistente: “Lista mis espacios de QuickBilling” o “¿Qué facturas están vencidas?”

No necesitas una clave de API. Si tu cuenta tiene más de un espacio de trabajo, pide al asistente que los liste y elija uno.

Configuración para clientes que leen un archivo JSON (por ejemplo Cursor)

mcp.json
{
  "mcpServers": {
    "quickbilling": {
      "url": "https://mcp.quickbilling.io/mcp"
    }
  }
}

En Claude Desktop, añade la misma URL como conector personalizado (un servidor MCP remoto). Los nombres de los menús varían según el cliente, así que consulta la documentación de tu cliente para añadir un servidor remoto.

Datos de conexión

Lo que necesita tu cliente MCP.

  • URL del servidor: https://mcp.quickbilling.io/mcp
  • Transporte: HTTP en streaming, un servidor remoto sin nada que instalar
  • Autenticación: OAuth 2.1 con PKCE, inicio de sesión con tu cuenta de QuickBilling
  • Descubrimiento: los metadatos del recurso protegido OAuth se sirven en /.well-known/oauth-protected-resource en el mismo host

El servidor remoto no acepta claves de API. Las claves de API son para la API REST y forman parte del plan Unlimited: consulta https://quickbilling.io/docs/api

Espacios de trabajo

Cómo elige un asistente el espacio de trabajo en el que actúa.

Si tu cuenta tiene un espacio de trabajo, el asistente lo usa sin más configuración.

Si tienes varios, pide al asistente que liste tus espacios de trabajo y elija uno.

Herramientas de espacios de trabajo

  • list_workspaces, devuelve tus espacios de trabajo
  • get_active_workspace, muestra el espacio de trabajo en uso
  • set_active_workspace, selecciona un espacio de trabajo para las llamadas siguientes

Herramientas

Qué puede hacer un asistente una vez conectado.

El servidor expone 129 herramientas

  • Facturas y presupuestos (18): listar, obtener, crear, guardar, eliminar, duplicar, convertir un presupuesto en factura, estado, marcar como pagada, vista previa y envío del correo, enlaces compartidos, enlace al PDF, actividad, analíticas de visitas, recordatorios
  • Facturas recurrentes (7): listar, obtener, crear, actualizar, pausar, reanudar, eliminar
  • Clientes (8): listar, buscar, obtener, estado de cuenta, crear, creación rápida, actualizar, eliminar
  • Perfiles de facturación y biblioteca de artículos (7)
  • Plantillas (6): listar plantillas, plantillas incluidas, predeterminada, obtener, establecer la predeterminada, ajustes predefinidos
  • Gastos (21): crear (uno o varios), actualizar, eliminar, enviar, aprobar, rechazar, marcar como pagado, anular, acciones en bloque, gastos facturables, vincular a facturas, adjuntos, actividad
  • Informes de gastos (9): estadísticas, resumen, mensual, trimestral, anual, tendencias, análisis de costos, gasto, deducibles fiscalmente
  • Categorías, proveedores y etiquetas (12)
  • Presupuestos (5), gastos recurrentes (7) e ingresos (6)
  • Proyectos e hitos (10), incluida la facturación de un hito
  • Informes y paneles (7): cifras del resumen, informes del workspace, estado de resultados, flujo de caja, beneficio por cliente, rentabilidad de clientes, posición neta
  • Workspace y perfil (5): get_profile, list_workspaces, get_active_workspace, set_active_workspace y attach_receipt_to_expense
  • Uso del plan (1): get_subscription_usage

No disponible por MCP: miembros del equipo e invitaciones, exportación de la cuenta, planes de suscripción, diseño de plantillas, paletas de colores y subida de avatares o logotipos. Usa la aplicación web para eso.

Los mismos datos están disponibles mediante la API REST: https://quickbilling.io/docs/api

Flujos de ejemplo

Peticiones que encajan bien con las herramientas.

Crear y enviar una factura

“Crea una factura para Bluebird Café por 3 horas de diseño a 120 $ la hora y envíala.” El asistente busca o añade al cliente, monta la factura y la envía por correo.

Registrar un gasto con recibo

“Registra este recibo como gasto de Software.” El asistente crea el gasto en esa categoría y le adjunta el recibo.

Ver qué está vencido

“¿Qué facturas están vencidas?” El asistente lista las facturas sin pagar que han pasado su vencimiento.

Trabajar entre espacios de trabajo

“Lista mis espacios de trabajo y cambia a Northwind Studio.” Después sigue con peticiones de facturas o gastos.

Inicio de sesión y seguridad

Tu cuenta, tus permisos.

  • El inicio de sesión usa OAuth con tu cuenta de QuickBilling, y el servidor remoto no acepta claves de API
  • Cada llamada se ejecuta con los permisos de tu cuenta, incluidos modificar y eliminar registros
  • Revisa lo que propone tu asistente antes de confirmar un cambio
  • Elimina la conexión en tu cliente MCP para cortar el acceso
  • Lo que un asistente hace con los datos que recibe se rige por la política de su proveedor, consulta la sección sobre asistentes de IA de la política de privacidad

Solución de problemas

Problemas de configuración habituales.

El cliente no puede conectarse

Comprueba que tu cliente admita servidores MCP remotos con inicio de sesión OAuth y que la URL sea exactamente https://mcp.quickbilling.io/mcp.

El inicio de sesión no se completa

Elimina el servidor de tu cliente, añádelo de nuevo y sigue la solicitud de inicio de sesión con tu cuenta de QuickBilling.

Datos de un espacio de trabajo equivocado

Pregunta al asistente qué espacio de trabajo está activo, luego pídele que liste tus espacios de trabajo y elija el correcto.

Más ayuda: https://quickbilling.io/contact, info@quickbilling.io