Loading repository data…
Loading repository data…
Dattics / repository
Un servidor MCP (Model-Context Protocol) escrito en TypeScript para actuar como intermediario con la API de contabilidad de Alegra. El propósito es permitir que modelos de lenguaje grandes (LLMs) puedan interactuar y consultar información de facturas, contactos y artículos de forma segura.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Este proyecto implementa un servidor compatible con el Protocolo de Contexto de Modelo (MCP) que actúa como un puente hacia la API de contabilidad de Alegra. Permite que los Modelos de Lenguaje Grandes (LLMs) interactúen de forma segura con una amplia gama de recursos de Alegra, como facturas, contactos, ítems, pagos y más.
Elaborado por Juan Sánchez.
AlegraAPI) para realizar operaciones CRUD (GET, POST, PUT, PATCH, DELETE) en la mayoría de los endpoints de la API de Alegra.invoices, contacts, items, credit-notes, purchase-orders, bills, warehouses, bank-accounts, taxes, entre muchos otros.PATCH) o completa (PUT) y la eliminación de los existentes.GET.queryParams para enviar el cuerpo (body) de las solicitudes POST, PUT y PATCH.alegra-mcp.log para facilitar la depuración y el seguimiento.fetch nativo de Node.js 18+, sin librerías adicionales de HTTP.Sus credenciales de Alegra nunca salen de su máquina.
Este servidor está diseñado con la seguridad como prioridad. La autenticación con la API de Alegra se gestiona de la siguiente manera:
ALEGRA_USER) y token (ALEGRA_TOKEN) directamente desde variables de entorno en su máquina..gitignore está configurado para excluir explícitamente cualquier archivo .env, evitando que sus credenciales sean enviadas accidentalmente a un repositorio de código.Usted puede utilizar su LLM de confianza para validar el código y confirmar que sus credenciales no son almacenadas ni transmitidas a terceros. El archivo clave para revisar es
src/auth.ts, donde se leen las variables de entorno para generar los headers de autorización.
Si no necesita modificar el código y solo desea utilizar la herramienta con su LLM, puede configurar su cliente MCP (por ejemplo, en el settings.json de VS Code) para que descargue y ejecute el servidor automáticamente.
Agregue la siguiente configuración a su cliente MCP:
{
"mcpservers": {
"Alegra-MCP-Public": {
"command": "npx",
"args": [
"-y",
"@juancsanchez/alegra-mcp"
],
"env": {
"ALEGRA_USER": "su_email@dominio.com",
"ALEGRA_TOKEN": "su_token_de_api_aqui"
}
}
}
}
Esta configuración le indica a su cliente que use npx para ejecutar la última versión del paquete, pasando sus credenciales de forma segura a través de variables de entorno, sin necesidad de clonar o instalar el proyecto manualmente.
Siga estos pasos si desea modificar o examinar el código.
fetch nativo).Clonar el Repositorio
git clone https://github.com/juancsanchez/Alegra-MCP
cd alegra-mcp
Instalar Dependencias
npm install
Configurar las Credenciales
Cree un archivo llamado .env en la raíz del proyecto.
touch .env
Añada sus credenciales de Alegra al archivo .env:
# Archivo .env
ALEGRA_USER="su-correo@ejemplo.com"
ALEGRA_TOKEN="su_token_secreto_de_la_api"
Compilar el Código
npm run build
Iniciar el Servidor
npm start