Agentic Ventures Wiki

mcp-zettle

1 Min. Lesezeit

mcp-zettle (Repo)

Eigener MCP fuer Zettle-API. Erstellt als Standard-Stack-Layer fuer das KMU-Retail-Bundle (siehe produkt-bundle).

Status

  • v0.1 Skeleton fertig 2026-05-18 — 6 Read-Tools registriert, uv tool install --editable getestet, kein Import-Fehler
  • Live-Test ausstehend — benoetigt ZETTLE_CLIENT_ID + ZETTLE_API_KEY von Marvin’s Zettle-Account
  • GitHub-Repo: noch nicht angelegt (lokales Git-Repo TODO)

Struktur

mcp-zettle/
├── README.md
├── pyproject.toml
├── .env.local.example
├── .gitignore
└── src/mcp_zettle/
    ├── __init__.py
    └── server.py        # FastMCP + Auth-Layer + 6 Tools

Tools v0.1 (6, Read-Only)

list_products, get_product, get_inventory_balance, list_sales, get_daily_summary, get_bestseller_last_7_days. Details siehe Repo-README oder zettle.

Standard-Stack-Layer-Strategie

Dieser MCP entsteht primaer fuer Kunde Woehrle, ist aber als Standard-Layer fuer alle naechsten KMU-Retail-/Gastro-Kunden mit Zettle gedacht. Anschluss-Use-Cases:

  • Restaurants mit Zettle-Tablet-Kasse
  • Friseure / Salons (Companion zu mcp-calcom)
  • Galerien mit Verkaufsstaenden
  • Wochenmaerkte / Pop-ups mit Zettle Solo Reader

Nicht-Ziele (v0.1)

  • Write-Tools (kommen in v0.2 nach Notausgang-Bestaetigung)
  • Multi-Tenant-Architektur (kommt mit Kunde 2)
  • Cloud-Hosting (kommt in Phase 2 des Woehrle-Projekts)
  • zettle — Setup-Doku
  • plan — Implementierungs-Plan mit Unit 1.3 = mcp-zettle v0.1
  • mcp-best-practices — Pattern + Audit-Checkliste
  • SKILL — Skill der das Pattern definiert

Graphansicht

Backlinks