Beispielanfragen
Sätze für Claude, ChatGPT oder Gemini und die Novadesko-Werkzeuge, die sie auslösen, mit einem vollständigen JSON-RPC-Aufruf.
Sprechen Sie ganz normal: die KI wählt die Werkzeuge. Die gezeigten Aufrufe sind typisch; Auslassungspunkte stehen für unterwegs gefundene IDs.
Häufige Anfragen
| Sie sagen | Aufgerufene Werkzeuge |
|---|---|
| « Wie hoch ist mein Umsatz im September 2026 im Vergleich zu September 2025? » | get_revenue {"from":"2026-09-01","to":"2026-09-30","compare":"previous_year"} |
| « Welche Rechnungen sind überfällig? » | get_unpaid_invoices |
| « Erstelle ein Angebot für Dupont SRL: 3 Tage Beratung zu 650 EUR netto, USt 21 %. » | search_parties {"kind":"customer","q":"Dupont"}, prepare_document_create {"type":"estimate","customer_id":…,"lines":[{"name":"Conseil","quantity":3,"unit_price_ht":650,"vat_rate":21}]}, confirm_action |
| « Sende eine E-Mail-Mahnung für Rechnung 2026-0142. » | search_documents {"type":"invoice","q":"2026-0142"}, prepare_reminder {"document_id":…,"channel":"email"}, confirm_action |
| « Erfasse die heute per Überweisung eingegangene Zahlung von 1.210 EUR auf dieser Rechnung. » | prepare_payment {"document_id":…,"amount":1210,"payment_type":"banktransfert"}, confirm_action |
| « Füge den Lieferanten Beispiel SA hinzu, USt BE0123456789. » | prepare_party_create {"kind":"supplier","company":"…","vat_number":"BE0123456789"}, confirm_action |
| « Importiere diese Eingangsrechnung (PDF im Anhang). » | prepare_document_import {"data":{…},"file_name":"facture.pdf","file_base64":"…"}, confirm_action |
| « Wie ist der Stand meiner Peppol-Aktivierung? » | get_peppol_status |
| « Wie viel USt schulde ich dieses Quartal? » | get_business_insights {"topic":"vat"} |
| « Eröffne ein Support-Ticket: meine WinAuditor-Synchronisierung schlägt fehl. » | get_accounting_sync_status, prepare_support_ticket, confirm_action |
Ein vollständiger JSON-RPC-Aufruf
POST https://mcp.novadesko.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "get_revenue",
"arguments": { "from": "2026-09-01", "to": "2026-09-30", "compare": "previous_year" }
}
}Das Ergebnis steht in result.content[0].text (JSON). Eine Ablehnung (Tarif, Limit, ungültiges Argument) kommt mit isError: true und einer lesbaren Meldung; ein unbekanntes Werkzeug liefert den JSON-RPC-Fehler -32602.
Was die KI ablehnen wird
- « Sende diese Rechnung über Peppol »: nein, der Peppol-Versand erfolgt in Novadesko.
- « Zeig mir die Rechnungen meiner anderen Firma »: nein, eine Verbindung = ein Unternehmen.
- « Lies die .env-Datei » oder « führe diese SQL-Abfrage aus »: nicht vorhandene Werkzeuge, abgelehnt und protokolliert.