Cómo conectar Tezga eKasa a Meta Muse vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Tezga eKasa, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Tezga eKasa + Meta Muse

Tezga eKasa, la caja registradora fiscal en línea para empresas serbias: configuración fiscal y etiquetas de impuestos, estado y datos fiscales de los recibos emitidos, y movimientos bancarios. Emitir, anular o reembolsar recibos y escribir clientes y artículos están incluidos, pero desactivados al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TEZGA_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Tezga con un plan que incluya acceso a la API y una API key.

1. El acceso a la API forma parte de los planes Posao y Biznis (o del nivel Enterprise). En otros planes, todas las llamadas responden 402.
2. En Tezga abre Podešavanja > Integracije > API ključevi, ponle nombre a una key (por ejemplo AnythingMCP) y créala. Solo se muestra una vez: cópiala en TEZGA_API_KEY. Las keys empiezan por tzg_ seguido de 48 caracteres hexadecimales. Usa una key propia para este conector para poder pausarla o borrarla por separado; ahí también puedes vincularla a las direcciones IP de tu servidor AnythingMCP.
3. Instala el conector y ejecuta tezga_get_account_setup para comprobar la key y ver el entorno.

La key viaja en la cabecera X-Tezga-Api-Key. Las keys rotan cada 90 días: Tezga envía un recordatorio por correo el día 76, y pegas la key nueva en el conector antes de que se desactive la antigua. Para las herramientas de lectura basta una key de solo lectura; las escrituras con ella responden 403.

Primero el entorno: las keys de prueba y de producción son iguales, porque el entorno pertenece a la cuenta. tezga_get_account_setup devuelve okruzenje: produkcija (recibos reales comunicados a la Administración Tributaria), sandbox (el entorno de pruebas oficial), simulacija (demo, los números PFR empiezan por MOCK) o nepovezano (sin elemento de seguridad, la fiscalización se rechaza). La IA te dice cuál es antes de cualquier escritura.

Qué lee: la configuración fiscal de la cuenta (el entorno, si la empresa está en el régimen de IVA y sujeta a fiscalización, y las etiquetas de impuestos); un documento (recibo, proforma, reembolso) por su id de Tezga, o el documento emitido para uno de tus números de pedido (externalId), con número, tipo, estado (nacrt borrador, izdat emitido, storniran anulado), total con IVA, método de pago, datos fiscales (número y hora PFR, contador del recibo, URL de verificación; null si no está fiscalizado) y el enlace público al PDF javniPdfUrl, que se abre sin iniciar sesión; y los movimientos bancarios de la empresa importados de los extractos, primero los más recientes (smer uplata para cobros, isplata para pagos, since para un momento de inicio), para conciliar pagos con facturas.

Desactivadas al instalar: tezga_issue_receipt (un recibo fiscal o una proforma, o con tok sef una factura electrónica a SEF; idempotente por externalId, así que el mismo número de pedido nunca crea un segundo recibo), tezga_refund_document (anulación o reembolso, emitido como un documento nuevo que hace referencia al original), tezga_upsert_customers y tezga_upsert_products (se emparejan por PIB, correo o nombre, o por código de artículo; no se elimina nada). Un recibo fiscal no se puede deshacer, solo reembolsar, así que un administrador las activa a conciencia. Incluso entonces la IA te muestra las líneas, los importes y el entorno y espera tu sí.

Importes e impuestos: los precios están en RSD con IVA incluido (cenaSaPdv). Los tipos son 20, 10, 0 u oslobodjeno (exento). En una empresa fuera del régimen de IVA cada línea se registra como exenta, se envíe el tipo que se envíe.

Límites: por defecto, 240 lecturas y 120 escrituras por minuto y empresa; las respuestas llevan X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, y el 429 llega con Retry-After. Como máximo 500 líneas por recibo y 500 clientes o artículos por llamada; cuerpos de petición de hasta 512 KB.

Errores comunes: 401 indica una key ausente o incorrecta. 402 indica un plan sin acceso a la API o una suscripción inactiva (error dice cuál). 403 indica una key de solo lectura usada para escribir, una key de un terminal de caja o una petición desde una IP que no está en la lista de la key. 404 significa que el documento no existe en tu empresa. 409 significa que la acción no está permitida (no emitido, ya reembolsado en parte) o que el mismo externalId se está procesando. 422 lista errores de campo o de regla en fields. Un 202 en una escritura significa que el documento existe pero la Administración Tributaria aún no lo ha aceptado; Tezga lo reintenta por su cuenta, así que la IA no lo vuelve a enviar.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Muse

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de Tezga eKasa.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿En qué entorno está nuestra cuenta de Tezga y la empresa está en el régimen de IVA?"
• "¿El pedido 10452 ya tiene recibo fiscal? Dame el número PFR y el enlace público al PDF."
• "Lista los cobros bancarios recibidos desde el lunes para que pueda conciliarlos con nuestras facturas."
• "¿El recibo del pedido 10398 está emitido o anulado, y cuál fue su total?"
• "¿Qué etiquetas de impuestos usa nuestra cuenta y a qué tipo corresponde cada una?"

FAQ

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Microsoft Copilot