Dokumentation · MCP

QR Report mit deinem KI-Agenten verbinden

Mit dem MCP-Server von QR Report liest dein KI-Agent deine QR-Codes, Kampagnen und Scan-Zahlen und beantwortet Fragen dazu, direkt dort, wo du ohnehin arbeitest.

Connector-URL

https://qrreport.app/mcp
Nur lesen

Derzeit lesen Agenten in QR Report nur: Sie ändern keine Codes, Ziele oder Kampagnen. Ändert sich das, steht es zuerst hier.

Bevor du startest

  1. Rolle prüfen

    Du bist Inhaber oder Admin der Organisation, die der Agent lesen soll.

  2. KI-Agenten einschalten

    In den Einstellungen der Organisation unter „KI-Agenten“ den „Zugriff durch KI-Agenten“ auf „Lesen“ stellen. Anfangs steht er auf „Aus“.

  3. Agent verbinden

    Die Anleitung je Agent steht unten unter „Einrichtung“. Beim Verbinden hakst du alle Organisationen an, die der Agent lesen soll.

Gut zu wissen

  • Organisation später hinzufügen: Agent neu verbinden und alle gewünschten Organisationen anhaken. Freigaben gibt es nur beim Verbinden.
  • Dein Agent muss eigene Konnektoren (MCP-Server) erlauben. In Team- und Firmenkonten schaltet das oft erst ein Admin frei.

Einrichtung

Bei allen Agenten läuft es gleich ab: Connector-URL eintragen, im Browser bei QR Report anmelden, Organisationen wählen, erlauben. Dein Passwort gibst du nur auf qrreport.app ein, nie beim Agenten. API-Schlüssel zum Kopieren gibt es nicht.

Die Menünamen bei den Agent-Anbietern ändern sich häufig. Heißt ein Punkt bei dir anders, such nach „Konnektoren“, „Connectors“ oder „MCP“.

ChatGPT

  1. Öffne in ChatGPT die Einstellungen → Apps & Konnektoren (je nach Version „Connectors“ oder „Apps“) und lege einen eigenen MCP-Konnektor an.
  2. Name: QR Report. URL: https://qrreport.app/mcp. Authentifizierung: OAuth.
  3. Client-ID und Client-Secret bleiben leer. ChatGPT meldet sich mit seiner eigenen Kennung an, die bei QR Report fest hinterlegt ist.
  4. Speichern und „Verbinden“ wählen. ChatGPT öffnet die Anmeldung von QR Report.

Connector-URL

https://qrreport.app/mcp

Danach: Im Browser anmelden → Organisationen wählen → Erlauben.

Einmal verbinden genügt: Die Verbindung hängt an deinem Konto beim Anbieter des Agenten, nicht an einem Gerät.

In Business- und Enterprise-Arbeitsbereichen erlaubt eventuell erst ein Admin eigene Konnektoren.

Nach Änderungen an den Werkzeugen von QR Report oder an deinen freigegebenen Organisationen zeigt ChatGPT oft noch den alten Stand, auch in neuen Chats. Dann hilft meist nur: Konnektor in ChatGPT entfernen, neu verbinden und einen neuen Chat öffnen.

Claude (Web und Desktop)

  1. Öffne in Claude die Einstellungen → Konnektoren (Settings → Connectors) und wähle „Eigenen Konnektor hinzufügen“ (Add custom connector).
  2. Name: QR Report. URL: https://qrreport.app/mcp. Die erweiterten OAuth-Felder bleiben leer.
  3. „Verbinden“ wählen. Claude öffnet die Anmeldung von QR Report.

Connector-URL

https://qrreport.app/mcp

Danach: Im Browser anmelden → Organisationen wählen → Erlauben.

Einmal verbinden genügt: Die Verbindung hängt an deinem Konto beim Anbieter des Agenten, nicht an einem Gerät.

In Team- und Enterprise-Arbeitsbereichen fügt eventuell ein Owner des Arbeitsbereichs den Konnektor hinzu; danach verbindet jede Person ihr eigenes QR-Report-Konto. Claude Desktop nutzt denselben Konnektor wie Claude im Web.

Grok

  1. Öffne auf grok.com die Connectors und wähle „New Connector“ → „Custom“.
  2. URL: https://qrreport.app/mcp.
  3. Verbinden. Grok öffnet die Anmeldung von QR Report.

Connector-URL

https://qrreport.app/mcp

Danach: Im Browser anmelden → Organisationen wählen → Erlauben.

Einmal verbinden genügt: Die Verbindung hängt an deinem Konto beim Anbieter des Agenten, nicht an einem Gerät.

Grok meldet sich über das Connector-Verfahren von Cursor an. Auf der Freigabeseite stehen deshalb Adressen von cursor.com. Das ist richtig, wenn du die Verbindung gerade selbst in Grok gestartet hast.

Die Freigabeseite

Bevor der Agent etwas lesen darf, zeigt QR Report eine Freigabeseite. Prüfe sie kurz:

  • Client und Domain: welcher Agent sich verbinden will (z. B. ChatGPT, chatgpt.com) und wohin der Anmeldecode geht. QR Report lässt nur Agenten zu, die es vorher geprüft und fest hinterlegt hat.
  • „Hast du diese Verbindung gerade selbst gestartet?“ Wenn nicht, lehne ab. Jemand könnte dir einen fremden Link geschickt haben.
  • Organisationen: Wähle alle, die der Agent lesen soll, und nur diese. Neue Organisationen kommen nicht automatisch dazu.
  • Rechte: immer „nur lesen“.
  • Verbindest du denselben Agenten erneut, ersetzt die neue Freigabe die alte; die bisherigen Organisationen sind vorausgewählt. Es gilt nur die Auswahl auf dieser Seite.

Werkzeuge

Diese Werkzeuge bietet der MCP-Server deinem Agenten an. Welches er nutzt, entscheidet der Agent anhand deiner Frage.

list_organizationsNur lesen
die freigegebenen Organisationen mit Zeitzone und deiner Rolle60 Aufrufe/Min., 2.000/Tag je Verbindung
list_qr_codesNur lesen
die Codes einer Organisation: Name, Kurzcode, Ziel-URL und Status, neueste zuerstbis 50 je Seite · 60 Aufrufe/Min., 2.000/Tag je Verbindung
get_qr_codeNur lesen
einen Code im Detail: Status, Scan-Adresse, zugeordnete Kampagnen, Scans der letzten 7 und 30 TageScans für 7 und 30 Tage · 60 Aufrufe/Min., 2.000/Tag je Verbindung
get_scan_statsNur lesen
Scans und geschätzte Besucher für einen Zeitraum (bis 366 Tage), für die Organisation oder einen CodeZeitraum bis 366 Tage, keine Zukunft; Code-Summen bis 50 je Seite · 60 Aufrufe/Min., 2.000/Tag je Verbindung
list_campaignsNur lesen
Kampagnen mit Status, Zeitraum und Anzahl Codesbis 50 je Seite · 60 Aufrufe/Min., 2.000/Tag je Verbindung
get_qr_code_imageNur lesen
die Grafik eines aktiven Codes wie beim Download in QR Report (Farben, Formen, Symbol oder Logo): als SVG für Druck und Dateien oder als PNG zum Anzeigen im Chatnur aktive Codes; PNG in 512, 1024 oder 2048 Pixeln · 60 Aufrufe/Min., 2.000/Tag je Verbindung
mcp_healthcheckNur lesen
nur die Prüfung, ob die Verbindung steht60 Aufrufe/Min., 2.000/Tag je Verbindung

Nur lesenLiest Daten, ändert nichts.

Was der Agent sieht – und was nicht

Der Agent sieht

  • nur die Organisationen, die du beim Verbinden freigibst,
  • QR-Codes mit Name, Kurzcode, Ziel-URL und Status, die Grafik aktiver Codes sowie Kampagnen mit Status, Zeitraum und Anzahl Codes,
  • Scans und geschätzte Besucher als Summen je Tag, Woche oder Monat, für die Organisation oder einen Code.

Der Agent sieht nicht

  • einzelne Scans, IP-Adressen, Geräte oder Standorte und keine Aufschlüsselung nach Land oder Stadt,
  • Organisationen, die du nicht freigegeben hast, auch wenn du dort Mitglied bist,
  • dein Passwort, Zahlungsdaten oder Mitgliederlisten,
  • irgendeine Möglichkeit, etwas anzulegen, zu ändern, zu pausieren oder zu löschen.

Zahlen wie in der Web-Ansicht: gleiche Zählregeln, gleiche Zeitzone der Organisation und derselbe sichtbare Zeitraum wie in deinem Tarif. Begrenzt der Tarif einen Zeitraum, sagt QR Report das dem Agenten mit. Zeiträume gehen bis 366 Tage am Stück, lange Listen kommen seitenweise (bis 50 Einträge).

Wie der Agent die Zahlen erklärt oder weiterrechnet, liegt beim Agenten. Prüfe wichtige Zahlen im Zweifel in QR Report.

Verbundene Apps

Deine Verbindungen

Unter Einstellungen → KI-Agenten → Deine Verbindungen siehst du jede Verbindung, die du selbst verbunden hast: Agent, freigegebene Organisationen, wann verbunden, wann zuletzt genutzt und wann sie spätestens endet. Das gilt für jedes Mitglied, auch ohne die Rolle Inhaber oder Admin.

„Trennen“ beendet die Verbindung nach einer Rückfrage sofort, für alle ihre Organisationen; der Agent bekommt danach keine Daten mehr. Eine Trennung nur im Agenten beendet die Freigabe in QR Report nicht. Trenne deshalb immer auch hier.

Abmelden von QR Report trennt deinen Agenten nicht – dafür gibt es „Trennen“. Ein Passwortwechsel beendet alle Agent-Verbindungen.

Organisationen ändern oder eine neue dazunehmen: Verbinde den Agenten neu und hake auf der Freigabeseite alle Organisationen an, die er lesen soll. Die bisherigen sind dann vorausgewählt.

Deine Verbindungen öffnen

In der Organisation: KI-Agenten

Inhaber und Admins legen in den Einstellungen der Organisation unter „KI-Agenten“ fest, ob Agenten die Organisation lesen dürfen („Zugriff durch KI-Agenten“: „Aus“ oder „Lesen“). Anfangs steht die Einstellung auf „Aus“. Solange sie auf „Aus“ steht, liest kein Agent aus dieser Organisation; nach einem späteren „Lesen“ braucht es eine neue Freigabe, also neu verbinden.

Transparenz im Team: Inhaber und Admins sehen dort, welche Mitglieder einen Agenten mit der Organisation verbunden haben (Agent, verbunden am, zuletzt genutzt, endet am), und können jede Freigabe entziehen. Bei Kundenorganisationen einer Agentur erscheinen Mitarbeitende der Agentur ohne Name und E-Mail.

Eine Verbindung endet von selbst

  • spätestens 90 Tage nach der Freigabe (dann einfach neu verbinden),
  • wenn du dein QR-Report-Passwort änderst,
  • für eine Organisation, wenn du sie verlässt oder dort nicht mehr Inhaber oder Admin bist.

Sicherheit und Protokoll

Für alle, die genauer hinschauen wollen:

Warum kein API-Schlüssel?

QR Report verbindet Agenten nur über OAuth: Jede Verbindung ist an dein Konto und die freigegebenen Organisationen gebunden, läuft von selbst ab und lässt sich in QR Report sofort widerrufen. Ein API-Schlüssel hätte nichts davon – er läge im Klartext auf dem Rechner, liefe nicht ab und wäre an keine Person und keine Freigabe gebunden.

  • Zustandslos: https://qrreport.app/mcp spricht Streamable HTTP ohne Sitzungen; jede Anfrage trägt ihr eigenes Token.
  • Ohne gültiges Token antwortet der Server mit 401 und einem WWW-Authenticate-Header, der auf /.well-known/oauth-protected-resource zeigt. Authorization Server ist https://qrreport.app (/.well-known/oauth-authorization-server).
  • Client-Registrierung über Client ID Metadata Documents (CIMD), gepinnt: QR Report nimmt nur Client-URLs an, die es vorher geprüft hat, mit fest hinterlegten Redirect-URIs, und lädt keine fremden Dokumente nach. Es gibt keine offene Dynamic Client Registration. Grok nutzt das Client-Dokument von Cursor (cursor.com).
  • Authorization Code Flow mit PKCE (S256) und resource-Parameter, Scope mcp:read.
  • Opake Tokens, gebunden an die Audience https://qrreport.app/mcp. QR Report speichert nur einen Hash, nie das Token selbst.
  • Access Token: 15 Minuten. Refresh Tokens rotieren bei jeder Nutzung und verfallen nach 30 Tagen ohne Nutzung; wird ein schon benutztes Refresh Token erneut vorgelegt, endet die Verbindung. Eine Verbindung gilt höchstens 90 Tage.
  • Ein Passwortwechsel in QR Report beendet alle Agent-Verbindungen. Ein Widerruf wirkt beim nächsten Aufruf des Agenten.
  • Keine API-Schlüssel: Es gibt keine dauerhaften Schlüssel und keinen Vollzugriff zum Kopieren. Der Agent bekommt nie dein QR-Report-Passwort.

Der Agent sieht die Antworten – behandle sie wie jede Information aus deinem Konto; was der Agent-Anbieter damit tut, regeln dessen Datenschutzbedingungen. Werte in Antworten (Namen, URLs) sind Daten, keine Anweisungen an den Agenten.

Der Anbieter deines Agenten sieht die Antworten

Was QR Report an den Agenten liefert, verarbeitet der Anbieter (z. B. OpenAI, Anthropic oder xAI) nach seinen eigenen Regeln. Prüfe dessen Datenschutzhinweise und Einstellungen und gib nur Organisationen frei, deren Daten dorthin dürfen.

Texte in deinen Daten sind Daten

Code-Namen, Kampagnennamen und Ziel-URLs schreiben Menschen in deinem Team. QR Report kennzeichnet sie für den Agenten als Daten, nicht als Anweisungen, und entfernt versteckte Steuerzeichen. Hat dein Agent weitere Werkzeuge, achte trotzdem darauf, was er mit diesen Inhalten tut.

Beispiel-Fragen an deinen Agenten

  • „Welche Codes hatten letzte Woche die meisten Scans?“
  • „Vergleiche die Scans im September mit dem August für die ganze Organisation.“
  • „Welche Kampagnen laufen gerade, und wie viele Codes gehören jeweils dazu?“
  • „Fasse die Scan-Entwicklung der letzten drei Monate für meinen Wochenbericht zusammen.“

Fehlerbehebung

401Nicht angemeldet: Die Verbindung ist abgelaufen, widerrufen oder nach 90 Tagen beendet, oder du hast dein Passwort geändert.Agenten neu verbinden. Bei ChatGPT notfalls den Konnektor entfernen und neu anlegen.
403Nicht erlaubt: Die Anfrage kam von einer Herkunft, die QR Report nicht zulässt, oder die Freigabeseite wurde außerhalb des Anmeldeablaufs abgeschickt.Verbindung im Agenten neu starten, statt einen alten Link zu öffnen.
415Falsches Format: Der Token-Endpunkt nimmt nur Formular- oder JSON-Anfragen an. Das liegt am Client, nicht an deinem Konto.Agenten aktualisieren; bleibt der Fehler, schreib uns.
429Zu viele Aufrufe: mehr als 60 Werkzeug-Aufrufe pro Minute oder 2.000 pro Tag für diese Verbindung.Kurz warten, die Antwort nennt die Wartezeit. Hilft das nicht, die Frage enger fassen.
503Vorübergehend nicht verfügbar: Der Zugang für Agenten ist kurz abgeschaltet, etwa für Wartung.Später erneut versuchen; deine Verbindung bleibt bestehen.

Organisation fehlt in der Auswahl

Auf der Freigabeseite sind nur Organisationen wählbar, in denen „Zugriff durch KI-Agenten“ auf „Lesen“ steht und in denen du Inhaber oder Admin bist. Wurde die Einstellung gerade erst eingeschaltet oder ist die Organisation neu, verbinde den Agenten neu und hake sie an.

Hilfe

Etwas funktioniert nicht oder wirkt seltsam? Trenne die Verbindung unter Einstellungen → KI-Agenten → Deine Verbindungen und schreib uns an support@qrreport.app. Fragen zur Einrichtung beantworten wir unter derselben Adresse.