Cómo conectar Tezga eKasa a Claude 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 + Claude

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Tezga eKasa, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

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

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

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