Как подключить Tezga eKasa к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Tezga eKasa, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Tezga eKasa + Cursor

Tezga eKasa — онлайн-фискальная касса для компаний Сербии: фискальные настройки и налоговые метки, статус и фискальные данные выданных чеков, банковские операции. Выдача, аннулирование и возврат чеков, а также запись клиентов и товаров включены, но отключены при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TEZGA_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужен аккаунт Tezga на тарифе с доступом к API и API-ключ.

1. Доступ к API входит в тарифы Posao и Biznis (или в уровень Enterprise). На других тарифах каждый вызов отвечает 402.
2. В Tezga откройте Podešavanja > Integracije > API ključevi, задайте имя ключа (например, AnythingMCP) и создайте его. Он показывается только один раз: скопируйте его в TEZGA_API_KEY. Ключи начинаются с tzg_, за которым следуют 48 шестнадцатеричных символов. Используйте для этого коннектора отдельный ключ, чтобы приостанавливать или удалять его независимо; там же его можно привязать к IP-адресам вашего сервера AnythingMCP.
3. Установите коннектор и запустите tezga_get_account_setup, чтобы проверить ключ и увидеть среду.

Ключ передаётся в заголовке X-Tezga-Api-Key. Ключи меняются каждые 90 дней: на 76-й день Tezga присылает напоминание по e-mail, и вы вставляете новый ключ в коннектор до отключения старого. Для читающих инструментов достаточно ключа только для чтения; запись с ним отвечает 403.

Сначала среда: тестовые и рабочие ключи выглядят одинаково, потому что среда принадлежит аккаунту. tezga_get_account_setup возвращает okruzenje: produkcija (настоящие чеки, передаваемые в налоговую службу), sandbox (официальная тестовая среда), simulacija (демо, номера PFR начинаются с MOCK) или nepovezano (нет элемента безопасности, фискализация отклоняется). ИИ сообщает вам, какая это среда, перед любой записью.

Что он читает: фискальные настройки аккаунта (среда, является ли компания плательщиком НДС и подлежит ли фискализации, налоговые метки); документ (чек, проформа, возврат) по его ID в Tezga или документ, выданный по одному из ваших номеров заказа (externalId), с номером, типом, статусом (nacrt черновик, izdat выдан, storniran аннулирован), суммой с НДС, способом оплаты, фискальными данными (номер и время PFR, счётчик чеков, URL проверки; null, если чек не фискализирован) и публичной ссылкой на PDF javniPdfUrl, которая открывается без входа; и банковские операции компании, импортированные из выписок, начиная с новых (smer uplata для поступлений, isplata для списаний, since для начального момента), чтобы сопоставлять платежи со счетами.

Отключено при установке: tezga_issue_receipt (фискальный чек или проформа, а с tok sef — электронный счёт в SEF; идемпотентно по externalId, поэтому один и тот же номер заказа никогда не создаёт второй чек), tezga_refund_document (сторно или возврат, выдаётся как новый документ со ссылкой на исходный), tezga_upsert_customers и tezga_upsert_products (сопоставление по PIB, e-mail или названию либо по коду товара; ничего не удаляется). Фискальный чек нельзя отменить, только оформить возврат, поэтому администратор включает эти инструменты осознанно. Даже тогда ИИ показывает вам строки, суммы и среду и ждёт вашего «да».

Суммы и налоги: цены указаны в RSD с НДС (cenaSaPdv). Ставки налога — 20, 10, 0 или oslobodjeno (освобождено). У компании вне системы НДС каждая строка записывается как освобождённая, какую бы ставку ни прислали.

Ограничения: по умолчанию 240 чтений и 120 записей в минуту на компанию; ответы содержат X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, а 429 приходит с Retry-After. Не более 500 строк в чеке и 500 клиентов или товаров за вызов; тело запроса до 512 КБ.

Частые ошибки: 401 означает отсутствующий или неверный ключ. 402 означает тариф без доступа к API или неактивную подписку (error уточняет, что именно). 403 означает ключ только для чтения при записи, ключ кассового терминала или запрос с IP, которого нет в списке ключа. 404 означает, что документа нет в вашей компании. 409 означает, что действие не разрешено (чек не выдан, уже частично возвращён) или тот же externalId сейчас обрабатывается. 422 перечисляет ошибки полей или правил в fields. 202 при записи означает, что документ создан, но налоговая служба его ещё не приняла; Tezga повторяет отправку сама, поэтому ИИ не отправляет его заново.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Tezga eKasa.

Доступные инструменты

Примеры запросов

• «В какой среде работает наш аккаунт Tezga и является ли компания плательщиком НДС?»
• «Есть ли уже фискальный чек по заказу 10452? Дайте номер PFR и публичную ссылку на PDF.»
• «Перечислите входящие банковские платежи с понедельника, чтобы я сопоставил их с нашими счетами.»
• «Чек по заказу 10398 выдан или аннулирован и какая была сумма?»
• «Какие налоговые метки использует наш аккаунт и какой ставке соответствует каждая?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot