跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Tezga eKasa,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
摘要
Tezga eKasa 是面向塞尔维亚企业的在线税控收银机:税务设置和税率标签、已开具收据的状态和税控数据,以及银行交易。开具、作废或退还收据,以及写入客户和商品也已包含,但安装时处于关闭状态。
试试这样问
Tezga eKasa 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Tezga eKasa、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Tezga eKasa + Claude
Tezga eKasa 是面向塞尔维亚企业的在线税控收银机:税务设置和税率标签、已开具收据的状态和税控数据,以及银行交易。开具、作废或退还收据,以及写入客户和商品也已包含,但安装时处于关闭状态。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TEZGA_API_KEY
步骤 1 — 获取凭证
设置大约需要 3 分钟。你需要一个所在套餐包含 API 访问权限的 Tezga 账号,以及一个 API key。
- API 访问包含在 Posao 和 Biznis 套餐(或 Enterprise 级别)中。其他套餐下每次调用都会返回 402。
- 在 Tezga 中打开 Podešavanja > Integracije > API ključevi,为 key 命名(例如 AnythingMCP)并创建。它只显示一次:请复制到
TEZGA_API_KEY。key 以tzg_开头,后跟 48 个十六进制字符。为这个连接器单独使用一个 key,这样就能单独暂停或删除它;在同一页面还可以把它绑定到你的 AnythingMCP 服务器的 IP 地址。 - 安装连接器并运行
tezga_get_account_setup,检查 key 并查看环境。
key 通过 X-Tezga-Api-Key 请求头发送。key 每 90 天轮换一次:Tezga 会在第 76 天发邮件提醒,你需要在旧 key 停用前把新 key 粘贴到连接器中。只读 key 足以使用读取类工具;用它写入会返回 403。
先确认环境:测试 key 和生产 key 看起来一样,因为环境属于账号。tezga_get_account_setup 会返回 okruzenje:produkcija(真实收据,会上报税务机关)、sandbox(官方测试环境)、simulacija(演示,PFR 编号以 MOCK 开头)或 nepovezano(没有安全元件,税控会被拒绝)。在任何写入之前,AI 都会先告诉你当前是哪种环境。
可读取的内容:账号的税务设置(环境、公司是否在增值税体系内并须进行税控,以及税率标签);按 Tezga ID 查询的单据(收据、形式发票、退款),或按你的订单号(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、电子邮件或名称,或按商品编码匹配;不会删除任何内容)。税控收据无法撤销,只能退款,所以由管理员有意识地开启。即使开启后,AI 也会先给你看明细行、金额和环境,等你确认。
金额和税:价格为含增值税的 RSD(cenaSaPdv)。税率为 20、10、0 或 oslobodjeno(免税)。不在增值税体系内的公司,无论发送什么税率,每一行都记为免税。
限制:默认每家公司每分钟 240 次读取和 120 次写入;响应带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset,429 会附带 Retry-After。每张收据最多 500 行,每次调用最多 500 个客户或商品;请求体最大 512 KB。
常见错误:401 表示 key 缺失或错误。402 表示套餐不含 API 访问或订阅未激活(error 会说明是哪种)。403 表示用只读 key 写入、使用了收银终端的 key,或请求来自不在 key 列表中的 IP。404 表示该单据在你的公司中不存在。409 表示操作不被允许(未开具、已部分退款),或同一个 externalId 正在处理中。422 会在 fields 中列出字段或规则错误。写入时返回 202,表示单据已存在但税务机关尚未接受;Tezga 会自动重试,所以 AI 不会重复发送。
步骤 2 — 安装 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
步骤 3 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
Tezga eKasa)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
tezga_get_account_setup | Read the account's fiscal setup: the environment (produkcija = real receipts at the Tax Administration, sandbox = official test… |
tezga_get_document | Get a document (receipt, proforma, refund) by its Tezga id: number, type, status (nacrt draft, izdat issued, storniran cancelled), total… |
tezga_find_document | Find the document issued for one of your order numbers (externalId) and return its status, fiscal data (PFR number, verification URL) and… |
tezga_list_bank_transactions | List the company's bank transactions imported from statements (incoming payments and outgoing payments), newest first, for matching… |
tezga_issue_receipt | Issue and fiscalise a receipt (or a proforma) for an order: Tezga signs it at the Tax Administration (V-PFR) and returns the PFR number… |
tezga_refund_document | Cancel (storno) or refund an issued receipt |
tezga_upsert_customers | Create or update 1 to 500 customers in Tezga |
tezga_upsert_products | Create or update 1 to 500 catalogue items |
示例提示
- “我们的 Tezga 账号处于哪个环境?公司在增值税体系内吗?”
- “订单 10452 已经有税控收据了吗?给我 PFR 编号和公开 PDF 链接。”
- “列出周一以来收到的银行收款,方便我和发票对账。”
- “订单 10398 的收据是已开具还是已作废?总额是多少?”
- “我们的账号使用了哪些税率标签?每个分别对应什么税率?”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?