Moss über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Moss klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Moss + Gemini

Moss Ausgabenmanagement (Deutschland und Europa): Ausgaben aus Karten, Rechnungen und Erstattungen mit Positionen und Belegen, Wallet-Salden und Banktransaktionen, Lieferanten, Aufwandskonten, Steuersätze und Kostenstellen. Legt Lieferanten und Dimensionswerte an; bezahlen oder freigeben kann er nichts.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

MOSS_KEY_ID, MOSS_SECRET_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst einen Moss-Admin und die Moss-App auf dem Handy, um den neuen Key zu bestätigen.

1. Melde dich als Admin bei Moss an und öffne Settings, Company Settings, API Keys (auch als Settings, Platform, API Keys angezeigt).
2. Klicke auf Generate API Key und bestätige in der Moss-App.
3. Kopiere die Key ID (beginnt mit kid_) in MOSS_KEY_ID und den Secret Key (beginnt mit sk_) in MOSS_SECRET_KEY. Der Secret wird nur einmal angezeigt; ist er verloren, erzeuge einen neuen Key.
4. Installiere den Connector und rufe moss_list_expenses auf: Es liefert deine neuesten Ausgaben und bestätigt den Key.

Der Connector tauscht den Key an Moss' /oauth2/token (Client Credentials) gegen ein Token mit einer Stunde Laufzeit und erneuert es selbst. Er fordert den Scope write an, der read einschließt, weil die Tools zum Anlegen und Ändern ihn brauchen. Soll die KI nur lesen, schalte diese Tools ab.

Was er liest: Ausgaben (Kartentransaktionen, Rechnungen und Erstattungen) mit ihren Positionen, Netto-, Steuer- und Bruttobeträgen, Aufwandskonto und Steuersatz pro Position, Status, Exportstatus und Lieferant; die an Ausgaben hängenden Dateien (Belege, Rechnungs-PDFs), die moss_search_files listet und moss_download_file als Anhang übergibt; die Moss-Bankkonten (Wallets) mit Finanzierungsart, Währung und Status, Saldo und verfügbarer Saldo jedes Kontos und Banktransaktionen in einem Buchungszeitraum (Kartenzahlungen und Gutschriften, Auszahlungen, Abhebungen, Aufladungen, Rückzahlungen, mit Buchungs- und Valutadatum, Gegenpartei und Gebühren); Lieferanten mit Bankverbindung, USt-IdNr., Zahlungsbedingung und Standard-Kontierung; Aufwandskonten mit Kontonummern; Steuersätze; Zahlungsbedingungen mit Fälligkeits- und Skontoregeln; Buchhaltungsdimensionen wie Kostenstellen, Kostenträger und Projekte mit ihren Werten; Benutzer mit Team, Vorgesetztem und Rollen; Teams und Abteilungen.

Filter: Ausgaben lassen sich nach Typ (CARD_TRANSACTION, INVOICE, REIMBURSEMENT), Status (z. B. SUBMITTED, APPROVED, FLAGGED, REJECTED, REVIEWED, VERIFIED, COMPLETED), Exportstatus (NOT_EXPORTED, READY_FOR_EXPORT, EXPORT_PENDING, EXPORTED, EXPORT_FAILED), Erstellungsdatum, Ausgabedatum oder letzter Änderung filtern und nach Status, Erstellungszeit, Betrag in Hauswährung oder Ausgabezeit sortieren. Banktransaktionen brauchen immer einen Buchungszeitraum. Dateien einzelner Positionen werden nur gelistet, wenn auch die Positions-IDs übergeben werden.

Was er schreibt: moss_create_supplier, moss_create_dimension, moss_update_dimension, moss_create_dimension_item (z. B. eine neue Kostenstelle) und moss_update_dimension_item ändern Stammdaten, die zum Buchen dienen. Sie sind bei der Installation aktiv; die KI zeigt dir, was sie anlegen oder ändern will, und wartet auf dein Ja, und sie übergibt external_user_id (die Person, die gefragt hat), damit Moss die Änderung nachvollziehen kann. Lieferanten und Dimensionswerte lassen sich auf ACTIVE oder DEACTIVATED setzen; Löschen ist nicht vorgesehen. Ein Update eines Dimensionswerts braucht immer Name und Status, deshalb sendet die KI für alles, was bleiben soll, die aktuellen Werte. Mehr als die Standard-Dimensionen anzulegen erfordert das Moss-Modul Multiple Dimensions.

Bei der Installation deaktiviert: moss_update_supplier, weil es die IBAN ersetzen kann, auf die Moss die Rechnungen des Lieferanten bezahlt. Ein Administrator schaltet es bewusst ein, und die KI zeigt dann alte und neue Werte, bevor sie es aufruft.

Beträge und Datum: Beträge sind Objekte mit einem Dezimal-String amount und einer currency; homeAmount steht in der Hauswährung des Unternehmens. Datumsangaben sind YYYY-MM-DD, Zeitstempel ISO 8601 in UTC. IDs sind UUIDs.

Limits: Listen liefern bis zu 100 Einträge pro Seite (Standard 50); die KI ruft die nächste page ab, solange meta.pagination.hasMore true ist. ID-Filter nehmen bis zu 100 IDs. Moss erlaubt 180 Lese- und 20 Schreibzugriffe pro Minute und Organisation.

Häufige Fehler: 401 heißt, der Key wurde widerrufen oder das Token konnte nicht ausgestellt werden: Prüfe MOSS_KEY_ID und MOSS_SECRET_KEY. 402 heißt, ein Moss-Modul ist nicht gebucht, z. B. Multiple Dimensions. 403 heißt, dem Token fehlt der Scope. 409 heißt, der Datensatz wird von einer aktiven Buchhaltungsintegration verwaltet. 422 heißt, eine referenzierte ID (Aufwandskonto, Steuersatz, Zahlungsbedingung, Team) existiert nicht oder ist inaktiv. 429 heißt, das Rate-Limit ist aufgebraucht: Warte auf Retry-After.

Der Connector kann nichts bezahlen, freigeben, exportieren oder löschen, und er legt keine Ausgaben an und lädt keine Belege hoch: Die Moss Public API bietet dafür keinen Aufruf.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Moss-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Liste die Kartentransaktionen des letzten Monats, die noch NOT_EXPORTED sind, mit Betrag, Lieferant und Aufwandskonto.“
• „Wie hoch ist gerade der verfügbare Saldo jeder unserer Moss-Wallets?“
• „Zeig mir den Beleg zur Moss-Ausgabe über 249,90 EUR vom 14. Oktober.“
• „Summiere unsere Rechnungen des dritten Quartals nach Lieferant und Steuersatz.“
• „Leg in unserer Kostenstellen-Dimension die Kostenstelle 4300 Marketing Events an. Zeig mir vorher, was du anlegst.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden