跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Tezga eKasa，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
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 + Microsoft Copilot
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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Tezga eKasa的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。
可用工具
| 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
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?