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.

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 Bearer con validación en tiempo real

🚀 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": "Bearer TU_TOKEN_AQUI",
        "mcp-groups": "income,items"
      }
    }
  }
}

Claude Desktop

Edita el archivo de configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "alegra": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "FETCH_MCP_SERVER_URL": "https://mcp.alegra.com/mcp",
        "FETCH_MCP_SERVER_HEADERS": "{\"Authorization\": \"Bearer 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: Bearer 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: Bearer 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: Bearer TOKEN
mcp-session-id: ID_DE_SESION
Accept: text/event-stream

`DELETE /mcp`

Termina una sesión MCP activa.

Headers:

Authorization: Bearer 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