MCP Alegra

📋 Índice

Descripción General
Inicio Rápido
Configuración de Clientes MCP
Herramientas Disponibles
API HTTP
Autenticación

🎯 Descripción General

Alegra MCP Public es un servidor orquestador que implementa el Model Context Protocol (MCP) para unificar múltiples servidores MCP privados de Alegra en un único punto de acceso público. Permite a los clientes MCP acceder a herramientas de gestión empresarial como inventarios, contactos e ingresos a través de una interfaz estandarizada.

Importante: La funcionalidad aún se encuentra en modo beta por lo que su uso debe ser prudente.

Características Principales

✅ Orquestación por Grupo: Puedes seleccionar uno o varios grupos de herramientas
✅ Transporte via servidor: Soporta HTTP/SSE
✅ Autenticación Segura: Sistema de tokens Basic

🚀 Inicio Rápido

Para Usuarios (Configuración de Cliente)

El servidor MCP de Alegra está disponible públicamente en:

Producción: https://mcp.alegra.com/mcp

Requisitos

Token de Autenticación: Necesitas un token válido de Alegra
Cliente MCP Compatible: Como Cursor IDE, Claude Desktop, etc.

🔧 Configuración de Clientes MCP

Cursor IDE

Crea o edita el archivo .cursor/mcp_settings.json en tu proyecto:

{
  "mcpServers": {
    "alegra-mcp": {
      "type": "streamable-http",
      "streamable": true,
      "url": "https://mcp.alegra.com/mcp",
      "headers": {
        "Authorization": "Basic TU_TOKEN_AQUI",
        "mcp-groups": "income,items"
      }
    }
  }
}

Otros Clientes MCP

Para cualquier cliente que soporte HTTP/SSE:

URL: https://mcp.alegra.com/mcp
Method: POST (para llamadas) / GET (para SSE)
Headers:
  Authorization: Basic TU_TOKEN_AQUI
  Content-Type: application/json

🛠️ Herramientas Disponibles

El servidor orquesta las siguientes herramientas MCP:

📦 Items Management

Gestión de inventario y productos.

Herramientas:

items__getItems: Listar elementos del inventario
items__getItemsByName: Listar elementos del inventario por nombre

👥 Contactos Management

Gestión de contactos y clientes.

Herramientas:

contacts__getContacts: Listar contactos
contacts__getContactsByName: Listar contactos por nombre

💰 Factura de venta

Gestión de ingresos y facturación.

Herramientas:

income__getIncomes: Listar facturas
income__createIncome: Crear nueva factura

🌐 API HTTP

Endpoints Principales

`POST /mcp`

Ejecuta herramientas MCP o inicializa sesiones.

Headers:

Authorization: Basic TOKEN
Content-Type: application/json
mcp-session-id: [opcional] ID_DE_SESION

Ejemplo - Listar Herramientas:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Ejemplo - Ejecutar Herramienta:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "items-get_items",
    "arguments": {
      "limit": 10,
      "offset": 0
    }
  }
}

`GET /mcp`

Establece conexión SSE para streaming.

Headers:

Authorization: Basic TOKEN
mcp-session-id: ID_DE_SESION
Accept: text/event-stream

`DELETE /mcp`

Termina una sesión MCP activa.

Headers:

Authorization: Basic TOKEN
mcp-session-id: ID_DE_SESION

`GET /health`

Endpoint de salud del servidor.

Respuesta:

{
  "success": true,
  "message": "OK"
}

🔐 Autenticación

Autenticación

📚 Recursos Adicionales

Documentación de MCP

Última actualización: Septiembre 2025
Versión: 1.0.0