Docs/Integrationen/KI-Agent (MCP) verbinden
Integrationen

KI-Agent (MCP) verbinden

Verbinde Claude per MCP mit Pfeffersack, wähle, was der Agent tun und lesen darf, und schränke seine Rechte jederzeit ein.

Worum es geht

Ein KI-Agent wie Claude kann über MCP (Model Context Protocol) auf deine Pfeffersack-Buchhaltung zugreifen. Du fragst im Chat nach deinen Zahlen, und der Agent holt die Antwort aus Pfeffersack. Summen, MWST und Berichte rechnet Pfeffersack, nicht das Sprachmodell: Es sind dieselben Werte wie in der App.

Was der Agent darf, bestimmst du beim Verbinden. Er liest nur, legt Vorschläge an oder bucht zusätzlich sichere Fälle direkt. Und du wählst, ob er einzelne Buchungen und Namen sieht oder nur Kennzahlen. Einschränken kannst du die Rechte jederzeit.

Lesen funktioniert für Einzelfirma und GmbH. Vorschläge und direkte Buchungen gibt es nur in der GmbH. Der Zugang ist im Pfeffersack-Abo enthalten, auch in der Testphase. Für Claude brauchst du ein Konto bei Anthropic; welche Claude-Pläne eigene Connectoren erlauben, legt Anthropic fest. ChatGPT kann sich derzeit noch nicht mit Pfeffersack verbinden.

  1. Schritt 1: Adresse in Pfeffersack kopieren

    Öffne Profil bearbeiten → Integrationen → KI-Agenten und kopiere die Adresse des MCP-Servers.

  2. Schritt 2: In Claude als eigenen Connector hinzufügen

    Füge in Claude bei den Connectoren in den Einstellungen einen eigenen Connector hinzu und setze die kopierte Adresse ein. Den Namen wählst du frei, zum Beispiel «Pfeffersack».

  3. Schritt 3: Bei Pfeffersack anmelden

    Claude öffnet die Anmeldung von Pfeffersack. Melde dich dort mit deinem Pfeffersack-Konto an. Die Anmeldung läuft über OAuth: Claude erhält dein Passwort nicht.

  4. Schritt 4: Rechte wählen und erlauben

    Auf der Zustimmungsseite wählst du, was der Agent tun darf (nur lesen, Vorschläge anlegen oder zusätzlich sichere Fälle direkt buchen) und ob er Details lesen darf. Prüfe Name und Adresse des Agenten, dann erlaubst du den Zugriff.

  5. Schritt 5: E-Mail prüfen

    Pfeffersack schickt dir bei jeder Verbindung eine E-Mail. Warst du es nicht, trennst du die Verbindung sofort unter KI-Agenten.

  6. Schritt 6: Erste Frage stellen

    Frag zum Beispiel «Was ist bei mir noch offen?» oder wähle in Claude einen der fertigen Abläufe von Pfeffersack, etwa «Monatsrückblick».

Was darf der Agent tun? Die drei Stufen

Du wählst beim Verbinden eine Stufe. «Nur lesen» ist vorausgewählt. Die beiden anderen Stufen gibt es nur in der GmbH, und sie brauchen das Häkchen für Details.

Die drei Stufen eines KI-Agenten in Pfeffersack
StufeWas der Agent tutWas er nicht tutVerfügbar
Nur lesen (Standard)Beantwortet Fragen zu Kennzahlen, Berichten, MWST und Offenem.Ändert nichts und legt keine Vorschläge an.Einzelfirma und GmbH
Vorschläge anlegenBereitet die offenen Bankbewegungen eines Monats als Buchungsvorschläge vor und schlägt Regeln für den Bankimport vor.Bucht nichts. Gebucht wird, wenn du oder deine Treuhänderin den Vorschlag unter «Vorschläge» freigibt.Nur GmbH
Vorschläge anlegen und sichere Fälle direkt buchenWie «Vorschläge anlegen», dazu bucht er Bankbewegungen direkt, die eine deiner Regeln für den Bankimport mit «Automatisch buchen» zuordnet und die alle Prüfungen bestehen. Nur für überprüfte Agenten wie Claude.Bucht nichts, was vom Vorschlag von Pfeffersack abweicht: Das bleibt ein Vorschlag. Regeln gibst du immer einzeln frei.Nur GmbH

Auf keiner Stufe kann der Agent etwas versenden (Rechnungen, E-Mails), bezahlen, löschen, eine Periode abschliessen oder die MWST einreichen. Zahlungen für deine Rechnungen bucht der Agent nicht, die ordnest du in der App der Rechnung zu.

Was darf der Agent lesen?

Kennzahlen, Berichte und die MWST liest der Agent immer. Alles mit Namen und Angaben Dritter liest er nur mit dem Häkchen für Details. Das Häkchen ist standardmässig aus (Datenschutz durch Voreinstellung).

Datenumfang mit und ohne Häkchen für Details
DatenNur Kennzahlen (ohne Häkchen)Mit Häkchen für Details
KennzahlenJaJa
Berichte mit VorjahresvergleichJa, Summen je Konto oder Kategorie mit deren NamenJa
MWST einer PeriodeJaJa
Was offen istNur als AnzahlMit den einzelnen offenen Posten
Einzelne Buchungen und BuchungstexteNeinJa
Kunden und LieferantenNeinJa
Vorschläge und direkte BuchungenNicht möglichMöglich (nur GmbH)

Wann bucht der Agent direkt?

Nur auf der Stufe «Vorschläge anlegen und sichere Fälle direkt buchen» und nur, wenn alle Bedingungen erfüllt sind:

  • Eine deiner aktiven Regeln für den Bankimport mit «Automatisch buchen» ordnet die Bankbewegung zu, und die Regel ist seit dem Import unverändert.
  • Du hast diese Bankbewegung nie abgelehnt und keine Buchung davon rückgängig gemacht. Dein Entscheid gilt ohne Zeitgrenze.
  • Das Konto ist kein Sammelkonto wie Debitoren, Kreditoren oder MWST.
  • Es gibt keinen Hinweis auf eine mögliche Doppelbuchung oder eine Teilzahlung.
  • Der MWST-Code passt zu Konto und MWST-Methode.
  • Periode und Geschäftsjahr sind offen.
  • Die MWST-Periode ist in Pfeffersack weder als abgerechnet erfasst noch ist ihre Frist abgelaufen. Ist eine Periode ausserhalb von Pfeffersack abgerechnet, erfasse das, sonst erkennt Pfeffersack es nicht.

Das entspricht der automatischen Verbuchung im Bankimport: Auch sie bucht Regel-Treffer nur mit «Automatisch buchen». Was du bei einer Regel einschaltest, bestimmst du im Regel-Editor des Bankimports.

Jede direkte Buchung erscheint unter «Vorschläge → Erledigt» als «Direkt gebucht von» mit dem Namen des Agenten. Rückgängig machst du sie dort, solange seither nichts geändert wurde und die Periode offen ist, sonst mit einem Storno. Im Buchungsprotokoll steht, welcher Agent über welche Verbindung gebucht hat.

Fertige Abläufe in Claude

Pfeffersack bringt fertige Abläufe mit, die du in Claude auswählst, statt die Frage selbst zu formulieren:

  • «Was ist offen?»: zeigt, was noch zu erledigen ist, etwa unverbuchte Belege oder überfällige Rechnungen.
  • «Monatsrückblick»: fasst einen Monat mit den Zahlen aus Pfeffersack zusammen.
  • «MWST-Check»: geht die MWST einer Periode durch.
  • «Wer schuldet mir Geld?»: zeigt offene Kundenrechnungen mit Namen, wenn der Agent Details lesen darf; sonst nur, wie viele offen sind.
  • «Monat verbuchen» (nur GmbH, nur mit Vorschlägen): geht die offenen Bankbewegungen eines Monats durch, legt Vorschläge an und bucht auf der höchsten Stufe sichere Fälle direkt. Unklares klärt der Agent mit dir.

Beispielfragen

Frag so, wie du eine Treuhänderin fragen würdest. Fragen mit Namen oder einzelnen Buchungen brauchen das Häkchen für Details, Fragen zur Vorbereitung erlaubte Vorschläge.

  • «Wie viel MWST schulde ich für das laufende Quartal, und bis wann muss ich abrechnen?»
  • «Wie hoch ist mein Umsatz in diesem Jahr im Vergleich zum Vorjahr?»
  • «Welche Ausgaben sind gegenüber dem Vorjahr am stärksten gestiegen?»
  • «Wie viel habe ich dieses Jahr für Software ausgegeben?»
  • «Was ist bei mir noch offen?»
  • «Wie viele Belege sind noch nicht verbucht?»
  • «Wie sieht meine Erfolgsrechnung für das erste Halbjahr aus?» (GmbH)
  • «Welche Kundenrechnungen sind überfällig, und von wem?» (mit Details)
  • «Wer schuldet mir am meisten Geld?» (mit Details)
  • «Welche Lieferantenrechnungen sind noch offen?» (GmbH, mit Details)
  • «Liste die Buchungen vom September auf.» (mit Details)
  • «Bereite den Oktober vor: Was kannst du verbuchen, und was ist unklar?» (GmbH, mit Vorschlägen)
  • «Welche Regel für den Bankimport würdest du für meine Zahlungen an Swisscom vorschlagen?» (GmbH, mit Vorschlägen)

Rechte einschränken oder Agent trennen

Unter Profil bearbeiten → Integrationen → KI-Agenten siehst du jede Verbindung mit ihren Rechten.

  • Einschränken: zum Beispiel von «sichere Fälle direkt buchen» zurück auf «Vorschläge anlegen» oder «Nur lesen», oder du nimmst dem Agenten die Details weg. Das wirkt sofort, auch in einem laufenden Chat.
  • Mehr Rechte: Verbinde den Agenten neu und erteile die Rechte auf der Zustimmungsseite. Auch dafür bekommst du eine E-Mail.
  • Trennen: Mit «Trennen» sind die Zugangsschlüssel sofort ungültig.
  • Automatisch getrennt wird eine Verbindung spätestens nach 180 Tagen, bei einem Passwortwechsel und bei «Alle Geräte abmelden».

Sicherheit und Datenschutz

  • Claude erhält dein Passwort nicht, sondern einen Zugangsschlüssel. Pfeffersack speichert ihn nur als Hash.
  • Was der Agent liest, geht an den Anbieter des Agenten, bei Claude an Anthropic, oft ins Ausland, etwa in die USA. Prüfe, ob der Anbieter deine Daten für eigene Zwecke wie das Training verwendet.
  • Die Inhalte deiner Abfragen speichert Pfeffersack nicht. Gespeichert werden der Name des Agenten, seine Rechte, die Zeitpunkte von Zustimmung und letzter Nutzung, seine Vorschläge und bei direkten Buchungen Agent und Verbindung.
  • Buchungstexte und Belege stammen teils von Dritten und können versteckte Anweisungen an den Agenten enthalten. Auch ein getäuschter Agent kann höchstens buchen, was Pfeffersack selbst sicher zuordnet, und nichts senden, bezahlen oder löschen. Lass ihn in Claude nichts selbständig versenden, etwa per E-Mail, ohne dass du es bestätigst.
  • Berufsgeheimnis: Als Anwältin, Notar oder Ärztin verbindest du den Agenten ohne das Häkchen für Details. Dann gehen keine einzelnen Buchungen, Buchungstexte oder Namen von Kundschaft und Lieferanten an den Anbieter, nur Kennzahlen und Summen. Berichte zeigen die Namen deiner Konten und Kategorien, benenne sie deshalb nicht nach Klientinnen oder Klienten. Für Details klärst du vorher, ob du diese Daten dem Anbieter anvertrauen darfst (Art. 321 StGB).

Wenn etwas nicht klappt

Häufige Meldungen und was du tust
Was du siehstWas du tust
Der Agent meldet «Diese Verbindung darf … nicht».Der Verbindung fehlt dieses Recht. Für mehr Rechte verbindest du den Agenten neu und wählst sie auf der Zustimmungsseite.
Der Agent nennt keine Namen und keine einzelnen Buchungen.Die Verbindung liest nur Kennzahlen. Für Details verbindest du den Agenten neu und setzt das Häkchen für Details.
Der Agent kann keine Vorschläge anlegen.Vorschläge gibt es nur in der GmbH, mit Details und auf einer der beiden Stufen mit Vorschlägen. Für eine höhere Stufe verbindest du den Agenten neu.
Der Agent hat eine Bankbewegung nicht direkt gebucht.Dann war mindestens eine Bedingung für sichere Fälle nicht erfüllt. Schau unter «Vorschläge», ob sie dort zur Freigabe liegt; sonst buchst du sie im Bankimport.
Claude kann sich nicht verbinden, oder die Anmeldung bricht ab.Prüfe, ob du die Adresse vollständig kopiert hast und ob dein Abo oder deine Testphase läuft. Ohne aktives Abo sind verbundene Agenten gesperrt.
Du bekommst eine E-Mail zu einer Verbindung, die du nicht kennst.Trenne sie sofort unter KI-Agenten und ändere dein Passwort. Ein Passwortwechsel trennt alle Agenten.
ChatGPT lässt sich nicht verbinden.ChatGPT kann sich derzeit noch nicht mit Pfeffersack verbinden. Verwende Claude.

Tipps

  • Starte mit «Nur lesen». Mehr Rechte gibst du später mit einer neuen Verbindung.
  • Verbinde nur Agenten, denen du vertraust. Die Zustimmungsseite zeigt die Adresse, an die die Verbindung geht.
  • Der Zugang ist im Abo enthalten, auch in der Testphase, ohne Aufpreis.

Häufige Fragen

Wo finde ich die Adresse des MCP-Servers?

In Pfeffersack unter Profil bearbeiten → Integrationen → KI-Agenten. Dort kopierst du die Adresse und fügst sie in Claude als eigenen Connector hinzu.

Kann ich die Rechte eines KI-Agenten später ändern?

Ja. Einschränken kannst du jederzeit unter KI-Agenten, etwa von direkten Buchungen zurück auf Vorschläge oder auf nur lesen, oder du nimmst die Details weg. Das wirkt sofort, auch in laufenden Sitzungen. Für mehr Rechte verbindest du den Agenten neu und bestätigst sie auf der Zustimmungsseite.

Kann der KI-Agent selbst buchen?

Nur wenn du die Stufe «Vorschläge anlegen und sichere Fälle direkt buchen» wählst, nur in der GmbH und nur Bankbewegungen, die eine deiner Regeln mit «Automatisch buchen» zuordnet und die alle Prüfungen bestehen. Alles andere bleibt ein Vorschlag oder wird nicht gebucht.

Was passiert nach 180 Tagen?

Die Verbindung endet. Du verbindest den Agenten neu und bestätigst die Rechte erneut auf der Zustimmungsseite.

Funktioniert der KI-Agent auch für die Einzelfirma?

Ja, zum Lesen: Kennzahlen, Berichte mit Vorjahresvergleich, MWST, Offenes sowie mit Details Buchungen, offene Posten und Kontakte. Vorschläge und direkte Buchungen gibt es nur in der GmbH.