Moneybird MCP Server

Conecta asistentes de IA con el software de contabilidad Moneybird a través de su API.

Documentación

Servidor MCP de Moneybird

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

Características

Gestión de contactos: Listar, recuperar, filtrar, crear y actualizar contactos
- Filtrado avanzado por fecha de creación, fecha de actualización, nombre y más
Datos financieros: Acceso a facturas de venta, cuentas financieras y pagos
Operaciones comerciales: Gestionar productos, proyectos y registros de tiempo
Solicitudes personalizadas: Realizar solicitudes de API personalizadas a los endpoints de Moneybird
Asistente interactivo: Prompt preconfigurado para un asistente de Moneybird

Novedades

Filtrado mejorado de contactos: Filtrar contactos usando 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 conjuntos de datos grandes
Integración con TypeScript: Seguridad total de tipos con validación de esquemas Zod

Instrucciones de configuración

Configuración básica

Instala el paquete:
```
npm install -g moneybird-mcp-server
```

Crea un archivo .env con tus credenciales de Moneybird:

MONEYBIRD_API_TOKEN=your_api_token
MONEYBIRD_ADMINISTRATION_ID=your_administration_id

Ejecuta el servidor:
```
npx moneybird-mcp-server
```

Configuración con Claude Desktop

Para configurar este servidor MCP en Claude Desktop:

Instala el paquete globalmente si aún no lo has hecho:
```
npm install -g moneybird-mcp-server
```

Crea o edita el archivo de configuración de Claude Desktop (normalmente 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"
      }
    }
  }
}

Reinicia Claude Desktop para aplicar los cambios
Conéctate al servidor MCP escribiendo /mcp moneybird en la entrada de chat de Claude

Ejemplos de uso

Listado básico de contactos

Resumen

Este servidor permite a los asistentes de IA interactuar con tus datos contables de Moneybird utilizando el Protocolo de Contexto de Modelo. Proporciona varias herramientas para:

Listar y recuperar contactos
Ver facturas de venta
Consultar cuentas financieras
Acceder a productos y proyectos
Ver registros de tiempo
Realizar solicitudes personalizadas a la API de Moneybird

Requisitos previos

Node.js (v18 o superior recomendado)
Una cuenta de Moneybird con acceso a la API
Un token de API de Moneybird

Configuración

Clona este repositorio:

git clone https://github.com/vanderheijden86/moneybird-mcp-server.git
cd moneybird-mcp-server

Instala las dependencias:
```
npm install
```
Crea el archivo .env a partir del ejemplo:
```
cp .env.example .env
```
Edita el archivo .env con tus credenciales de la API de Moneybird:
- MONEYBIRD_API_TOKEN: Tu token de API de Moneybird (genéralo en https://moneybird.com/user/applications)
- MONEYBIRD_ADMINISTRATION_ID: Tu ID de administración de Moneybird (se encuentra en la URL cuando inicias sesión)
- MCP_SERVER_PORT: El puerto para ejecutar el servidor MCP (predeterminado: 3000)

Ejecutar el servidor

Para desarrollo:

npm run dev

Para producción:

npm run build
npm start

Uso con asistentes de IA

Este servidor MCP es compatible con cualquier asistente de IA que admita el Protocolo de Contexto de Modelo. Una vez en ejecución, puedes conectarlo a tu asistente de IA proporcionando la URL del servidor:

http://your-server-address:3000

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

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

Seguridad

Este servidor debe implementarse con las medidas de seguridad adecuadas, ya que proporciona acceso a tus datos de Moneybird. Considera:

Ejecutarlo detrás de un proxy seguro
Implementar autenticación para el servidor MCP
Usar HTTPS
Restringir el acceso a la red

Licencia

MIT