Moneybird MCP Server

Servidor MCP de Moneybird

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta asistentes de IA como Claude con el software de contabilidad Moneybird a través de API.

Características

• Gestión de contactos : enumerar, recuperar, filtrar, crear y actualizar contactos
  • Filtrado avanzado por fecha de creación, fecha de actualización, nombre y más
• Datos financieros : acceda a facturas de ventas, cuentas financieras y pagos
• Operaciones comerciales : gestionar productos, proyectos y entradas de tiempo
• Solicitudes personalizadas : realice solicitudes de API personalizadas a los puntos finales de Moneybird
• Asistente interactivo : mensaje preconfigurado para un asistente de Moneybird

Nuevos desarrollos

• Filtrado de contactos mejorado : filtre contactos utilizando la sintaxis de consulta avanzada de Moneybird
  • Filtrar por fecha de creación: created_after:2023-01-01 00:00:00 UTC
  • Filtrar por fecha de actualización: updated_after:2023-01-01 10:45:35 UTC
  • Filtrar por propiedades: first_name:value , etc.
• Manejo de errores mejorado : mejores mensajes de error y recuperación
• Optimizaciones de rendimiento : fragmentación de respuestas para grandes conjuntos de datos
• Integración con TypeScript : seguridad de tipos completa con validación de esquemas Zod

Instrucciones de configuración

Configuración básica

1. Instalar el paquete :
   npm install -g moneybird-mcp-server
2. Crea un archivo .env con tus credenciales de Moneybird:
   MONEYBIRD_API_TOKEN=your_api_token MONEYBIRD_ADMINISTRATION_ID=your_administration_id
3. Ejecutar el servidor :
   npx moneybird-mcp-server

Configuración del escritorio de Claude

Para configurar este servidor MCP en Claude Desktop:

1. Instale el paquete globalmente si aún no lo ha hecho:
   npm install -g moneybird-mcp-server
2. Cree o edite el archivo de configuración de Claude Desktop (generalmente en ~/Library/Application Support/Claude/claude_desktop_config.json ) para incluir la configuración del servidor MCP:
   { "mcpServers": { "moneybird": { "command": "npx", "args": [ "-y", "moneybird-mcp-server" ], "env": { "MONEYBIRD_API_TOKEN": "your_api_token_here", "MONEYBIRD_ADMINISTRATION_ID": "your_administration_id_here" } } } }
3. Reinicie Claude Desktop para aplicar los cambios
4. Conéctese al servidor MCP escribiendo /mcp moneybird en la entrada de chat de Claude

Ejemplos de uso

Listado básico de contactos

Descripción general

Este servidor permite que los asistentes de IA interactúen con sus datos contables de Moneybird mediante el Protocolo de Contexto de Modelo. Proporciona diversas herramientas para:

• Listar y recuperar contactos
• Ver facturas de ventas
• Consultar cuentas financieras
• Acceda a productos y proyectos
• Ver entradas de tiempo
• Realizar solicitudes API personalizadas de Moneybird

Prerrequisitos

• Node.js (se recomienda v18 o superior)
• Una cuenta Moneybird con acceso API
• Un token de API de Moneybird

Configuración

1. Clonar este repositorio:
   git clone https://github.com/vanderheijden86/moneybird-mcp-server.git cd moneybird-mcp-server
2. Instalar dependencias:
   npm install
3. Cree un archivo .env a partir del ejemplo:
   cp .env.example .env
4. Edite el archivo .env con sus credenciales de API de Moneybird:
   • MONEYBIRD_API_TOKEN : Su token API de Moneybird (generado en https://moneybird.com/user/applications )
   • MONEYBIRD_ADMINISTRATION_ID : Su ID de administración de Moneybird (que se encuentra en la URL cuando inicia sesión)
   • MCP_SERVER_PORT : El puerto donde se ejecutará el servidor MCP (predeterminado: 3000)

Ejecución del servidor

Para desarrollo:

Para producción:

Uso con asistentes de IA

Este servidor MCP es compatible con cualquier asistente de IA compatible con el Protocolo de Contexto de Modelo. Una vez en funcionamiento, puede conectarlo a su asistente de IA proporcionando la URL del servidor:

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

• list_contacts : Lista todos los contactos en Moneybird
• get_contact : Obtener detalles de un contacto específico por ID
• list_sales_invoices : Lista todas las facturas de venta
• get_sales_invoice : Obtener detalles de una factura de venta específica por ID
• list_financial_accounts : Lista todas las cuentas financieras
• list_products : Lista todos los productos
• list_projects : Lista todos los proyectos
• list_time_entries : Lista todas las entradas de tiempo
• moneybird_request : Realiza una solicitud personalizada a la API de Moneybird

Seguridad

Este servidor debe implementarse con las medidas de seguridad adecuadas, ya que proporciona acceso a sus datos de Moneybird. Considere lo siguiente:

• Ejecutándose detrás de un proxy seguro
• Implementación de la autenticación para el servidor MCP
• Usando HTTPS
• Restringir el acceso a la red

Licencia

Instituto Tecnológico de Massachusetts (MIT)