MCP: Fehlermeldungen, Grenzen und Fehlersuche

Diese Fehler treten auf, bevor ein Tool läuft.

401 Unauthorized (-32001)

Kein oder ungültiger Bearer-Token, widerrufener Schlüssel oder abgelaufenes OAuth-Token. Bei einem organisationsgebundenen Zugang auch: Die Organisation des Zugangs ist nicht mehr deine aktive Organisation. Der Antwort-Header verweist auf die Ressourcen-Metadaten für OAuth-Clients.

Parse error (-32700)

Der Anfragetext ist kein gültiges JSON.

Invalid Request (-32600)

Die Anfrage ist kein JSON-RPC 2.0.

Method not found (-32601)

Die Methode wird nicht unterstützt. Unterstützt sind initialize, ping, tools/list und tools/call.

Tool not found: <name> (-32601)

Ein Tool dieses Namens gibt es nicht. Rufe tools/list auf.

Internal error (-32603)

Serverfehler, häufig ein kurzzeitiges Datenbankproblem. Wiederhole die Anfrage.

Diese Meldungen betreffen Organisationskontext, Rolle, Scope und Module. Sie kommen als JSON-RPC-Fehler mit dem Code -32603 zurück.

Pass "organization" (name, slug, or ID) as an argument, or call list_organizations…

Kontoweiter Zugang ohne Organisations-Header: Gib das Argument organization an, setze einen Header (X-Organization-Slug) oder rufe zuerst list_organizations auf.

Organization "…" not found or you are not a member.

Die angegebene Organisation existiert nicht oder du dort kein aktives Mitglied bist.

Insufficient permissions for this tool

Rolle, Scope oder Modul reichen nicht. Prüfe den Tool-Katalog: Mindestrolle, Scope und Modul.

This tool requires an organization context.

find_team_free_slots braucht eine Organisation; gib sie an.

Diese Meldungen kommen aus den Tools selbst. Fehler in einem Tool werden als JSON-RPC-Fehler mit dem Code -32603 und der Meldung des Tools zurückgegeben.

… not found (z. B. Task not found, Project not found, Invoice not found)

Die ID existiert nicht, gehört zu einer anderen Organisation oder liegt außerhalb deiner Sichtbarkeit.

… does not belong to this organization

Ein Verweis (Projekt, Meilenstein, übergeordnete Aufgabe) oder ein Zuständiger gehört nicht zur Organisation.

A task cannot be its own parent

parentTaskId darf nicht die eigene ID sein.

Reserved or billed time entries cannot be edited / deleted

Der Zeiteintrag ist für eine Rechnung reserviert oder abgerechnet und damit gesperrt.

No running timer found

stop_timer findet keinen laufenden Timer für dich.

Only draft invoices can be deleted

delete_invoice löscht nur Entwürfe. Korrigiere ausgestellte Rechnungen mit create_invoice_correction.

Record a payment instead of setting an invoice to paid

Der Status paid lässt sich nicht direkt setzen.

Issued invoice content cannot be changed / Invoice cannot return to an editable state

Nach der Finalisierung ist nur der Status änderbar, ein Rückweg nach draft ist gesperrt.

Only a finalized invoice can be corrected

create_invoice_correction funktioniert nur für nicht-Entwurf-Rechnungen; einen Entwurf bearbeitest du direkt.

Time entry … (not completed and billable / must be approved / already assigned / belongs to another project)

Regeln für Positionen aus Zeiteinträgen in create_invoice: abgeschlossen, abrechenbar, freigegeben, im selben Projekt, noch nicht verwendet; EUR-Rechnung.

This receipt has a document under legal hold and cannot be deleted.

Konflikt 409 bei delete_accounting_receipt; der Versuch wird im Audit-Log protokolliert.

Consent basis missing (TKG § 174) …

Für kalte Outbound-Leads muss consentBasis dokumentiert sein (update_crm_lead), bevor ein Entwurf entsteht.

Produkt-Briefing missing …

Lege den Knowledgebase-Artikel mit dem konfigurierten Produkt-Briefing-Slug an.

Recipient is on the suppression list

Der Empfänger ist gesperrt; es entsteht kein Entwurf.

Draft is no longer open

Bereits gesendete oder verworfene Entwürfe lassen sich nicht mehr ändern.

Google Calendar not connected for this user.

Verbinde den Kalender in der Webapp; list_calendar_events meldet stattdessen connected=false.

No analytics integration configured.

Richte PostHog oder GA4 mit API-Key in den Organisationseinstellungen ein.

Budget is not in draft status

activate_budget funktioniert nur für Entwurfsbudgets.

Diese Obergrenzen gelten für Listen und Suchen.

Standard-Listen

limit: Standard 50, höchstens 200 (list_tasks, list_projects, list_time_entries, list_milestones, list_crm_leads, list_crm_email_drafts, list_invoices, list_kb_items, list_metrics, list_meetings, list_network_contacts, list_goals, list_notes, list_members, list_files, list_expenses, list_accounting_receipts).

Abweichende Grenzen

list_reviews: 20 / 100. search_kb: 5 / 20. search_network_contacts: 20 / 50. list_unscheduled_tasks: 30 / 100. find_similar_tasks: 6 / 20. list_calendar_events: 20 / 50. find_team_free_slots: maxResults 5 / 20, days 10 / 45. get_crm_weekly_briefing: weeks 1–12.

E-Mail-Entwürfe

Betreff höchstens 300 Zeichen, Text höchstens 20.000 Zeichen.

Rückgabeformat

Ergebnisse kommen als JSON-Text mit Einrückung. Große Listen werden durch limit begrenzt – frage bei Bedarf gezielt mit Filtern nach.