Skip to main content

​
Unternehmen & Scoping

Viele MCP-Tools arbeiten mit Daten eines bestimmten Unternehmens. list_companies ist deshalb meist der erste Aufruf in einem neuen Client-Flow.

​
Tool

  • list_companies - listet die Unternehmen der Organisation aus dem Bearer-Token

​
Wofür du list_companies brauchst

Der Aufruf liefert die companyUuid-Werte, die viele weitere Tools benötigen, zum Beispiel:
  • list_accounts
  • create_account
  • update_account
  • list_account_transactions
  • list_categories
  • bulk_create_categories
  • change_category
  • delete_category
  • list_mapping_transactions
  • set_booking_category
  • list_manual_uploads
  • create_manual_upload
  • list_manual_transactions
  • append_manual_transactions
  • patch_manual_transactions
  • remove_manual_transactions
  • list_open_items
  • get_open_item
  • list_open_item_lines
  • list_open_item_statuses

​
Was das Tool liefert

Das Tool gibt die rechtlichen Einheiten der Organisation zurück. Für die meisten Flows sind Name, company_uuid, Währung und Onboarding-Status relevant. mappingIgnoreEnabled zeigt, ob ignore_bookings für dieses Unternehmen erlaubt ist. Wenn der MCP-Nutzer Offene Posten sehen darf, enthält jede Gesellschaft zusätzlich:
  • openItemsReceivablesEnabled / openItemsPayablesEnabled — Module aktiv
  • openItemsConnectAvailable — DATEV Connect für Offene Posten nutzbar
  • openItemsEligible — Connect und mindestens ein Modul aktiv
Ohne Berechtigung sind diese Felder null. Details zu den Open-Items-Tools: Offene Posten.

​
Typischer Ablauf

  1. list_companies aufrufen
  2. passendes Unternehmen auswählen
  3. companyUuid in den folgenden unternehmensbezogenen Aufrufen verwenden

​
Hinweis

Die Organisation wird nicht als Parameter übergeben. Sie ist bereits durch den MCP-Bearer-Token festgelegt.