X3 meldet „Keine Berechtigung“ oder ein Tool ist verboten

Bereich: Konto und Zugang · Stand: 31.10.2026 · In English · Alle Artikel

Symptome

  • Ein Formular meldet „Keine Berechtigung (conversions:write).“
  • Claude bekommt „Forbidden: conversions_targets_list needs scope project:admin (insufficient_scope)“.
  • Die API antwortet 403 insufficient_scope: „missing scope: project:admin“, mit required.
  • Die X3 App zeigt „Nicht freigegeben · Dieser Bereich ist für Deine Rolle nicht freigegeben. Frag Deine Admins.“
  • Unter Einstellungen fehlen Seiten wie Meldungen oder Werbekonten & Budget.

Ursache

  • Deine Rolle reicht nicht: Analyst und Betrachter dürfen lesen, aber keine Einstellungen, Schlüssel, Meldungen oder Werbekonten ändern. Inhaber und Admin dürfen alles im Projekt.
  • Der API-Schlüssel wurde mit weniger Rechten angelegt oder nur für einzelne Projekte.
  • Die Claude-Verbindung wurde mit weniger Rechten freigegeben, oder es ist der öffentliche Doku-Server (/mcp/public) ohne Anmeldung.
  • Kontaktdaten von Leads brauchen zusätzlich das Recht auf Kontaktdaten (leads:read).

So löst Du das

1. Fehlendes Recht ablesen

  • Im Dashboard: Fehlermeldung › Text in Klammern, z. B. „(project:admin)“
  • Mit Claude (MCP): kb_search {"query":"insufficient_scope project:admin"}

Die Meldung nennt das fehlende Recht. project:admin heißt Inhaber oder Admin im Projekt, ads:write Schreibrecht für Werbekonten, conversions:write Meldungen senden.

2. Eigene Rolle ansehen

  • Im Dashboard: Team › Team & Rollen
  • Mit Claude (MCP): auth_whoami {"project":"mein-shop"}
  • Das MCP-Tool gibt es seit dem Update vom 31.10.2026; vorher zeigte project_list nur, welche Projekte die Verbindung erreicht.

auth_whoami zeigt je Organisation Deine Rolle, die Rechte, die diese Verbindung wirklich hat, und unter missingFromRole die Rechte, die Deine Rolle erlauben würde, die der Verbindung aber fehlen: dann reicht es, Claude neu zu verbinden und die Häkchen zu setzen (Schritt 4). Mit project auch die Rechte in diesem Projekt. Die Rollen aller Personen zeigt members_list (nur Inhaber und Admins).

3. Rolle erhöhen lassen

  • Im Dashboard: Team › Team & Rollen › Person › Rolle › Admin
  • Mit Claude (MCP): Kein MCP-Tool (Rollen ändern Inhaber und Admins der Organisation im Dashboard)

4. Schlüssel oder Claude-Verbindung mit passenden Rechten neu anlegen

  • Im Dashboard: Kunden & Team › Schlüssel › Neuer Schlüssel (oder Kunden & Team › KI-Apps › Verbindung trennen und neu verbinden)
  • Mit Claude (MCP): keys_create {"org":"meine-firma","name":"server","scopes":["analytics:read","conversions:write"]}

Geheime Schlüssel nur in Server-Umgebungsvariablen speichern, nie in Code oder Chat.

Woran Du siehst, dass es geklappt hat

  • Die Seite oder das Tool funktioniert ohne „Keine Berechtigung“.
  • Claude bekommt bei dem Tool kein insufficient_scope mehr.

Verwandte Artikel