Alegra

Alegra es la plataforma en la nube con la que administras tu negocio: facturación electrónica, contactos, inventario, cuentas bancarias y contabilidad en un solo lugar. El conector oficial de Alegra es un server MCP hospedado (https://mcp.alegra.com/mcp), publicado por Alegra en su portal de desarrolladores, que conecta a tu agente con la operación de tu empresa — en palabras de la documentación oficial, "permite acceso a herramientas de gestión empresarial como inventarios, contactos, facturas, bancos, pagos, retenciones, entre otros".

Le preguntas "¿Cuánto facturé este mes y a qué clientes?" y el agente consulta tus facturas y te arma el resumen. "¿Qué stock tengo de cada producto?" sale del inventario, sin recorrer pantallas. También trabaja por ti: "Actualiza el teléfono de Ana Gómez en sus datos de contacto" o "Registra el pago recibido de la factura 245". Todo queda registrado en tu cuenta de Alegra, con la misma credencial con la que tú accedes al API.

Qué le puedes pedir

• "¿Cuánto facturé este mes y a qué clientes?"
• "Muéstrame el stock disponible de cada producto."
• "Lista mis contactos y actualiza el teléfono de Ana Gómez."
• "¿Cuánto debo y cuánto me deben?"
• "Muéstrame el estado de resultados de este mes."
• "Registra el pago recibido de la factura 245."

Qué token necesitas

Necesitas el token del API de tu usuario de Alegra, convertido a Base64 — el mismo token del API de Alegra, en el formato que el servidor MCP espera.

1. Entra a app.alegra.com con tu cuenta. Arriba a la derecha, haz clic en Configuración y abre la sección API - Integraciones con otros sistemas. Ahí aparecen el correo con el que accedes al API y tu token; si todavía no tienes token, puedes generarlo en esa misma pantalla.
2. El servidor espera la credencial como correo:token codificada en Base64. El ejemplo de la propia documentación: Authorization: Basic ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1, donde esa cadena es base64('<ejemploapi@alegra.com>:tokenejemploapi12345').
3. Codifica tu propio correo:token en tu computadora — nunca uses páginas web de "codificador Base64" con tus credenciales de acceso. En la Terminal de macOS o Linux: printf 'correo:token' | base64. En Windows (PowerShell): [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('correo:token')).
4. Pega la cadena resultante cuando TerminalSync te pida ALEGRA_API_TOKEN_BASE64. Se guarda cifrada en los Secretos de la app y se envía al servidor como el header Authorization: Basic … que Alegra espera.

Aviso honesto: es un server hospedado por Alegra (https://mcp.alegra.com), no algo que corre en tu computadora: tus pedidos viajan al servidor de Alegra, que responde con los datos de tu cuenta. Lee y escribe: puede crear y actualizar facturas, contactos, productos y pagos, y el catálogo documentado también incluye herramientas para borrar (por ejemplo, eliminar una factura o un contacto). Lo que el agente puede hacer queda acotado por tu token — el mismo acceso que tiene tu usuario en el API de Alegra — y la documentación del MCP no describe un mecanismo de confirmación previa del lado del servidor. El API de Alegra documenta un límite de uso de 150 solicitudes por minuto por usuario; si se supera, responde con un error 429 hasta que termine el minuto. Los datos salen de tu cuenta, y verificarlos es tu responsabilidad.