# Agenten & die API Ein Agent ist ein KI-Assistent, der in Ihrem Namen in LetsFindWhy arbeitet: Claude Code, eine geplante Claude-Routine, ein Editor-Assistent oder jedes andere Werkzeug, das das Model Context Protocol (MCP) spricht. Geben Sie ihm einen API-Schlüssel, und er kann aus einem Chat heraus Projekte anlegen, Leitfäden schreiben, Befragte einladen und Transkripte und Erkenntnisse lesen, mit genau den Zugriffsrechten, die Sie haben. Alles, was ein Agent kann, können Sie auch selbst mit einfachen HTTP-Aufrufen an die REST-API tun. Beide verwenden denselben Schlüssel. ## So erstellen Sie einen API-Schlüssel 1. Öffnen Sie [Einstellungen](https://letsfindwhy.com/settings) und suchen Sie die Karte **API-Schlüssel**. 2. Erstellen Sie einen Schlüssel und geben Sie ihm einen Namen, der sagt, welcher Agent ihn halten wird, etwa „Claude Code auf meinem Laptop“. Ein Schlüssel pro Agent macht es leicht, einen zu widerrufen, ohne die anderen zu stören. 3. Kopieren Sie den Schlüssel sofort. Er beginnt mit mtg_ und wird nur einmal angezeigt; wenn Sie ihn verlieren, löschen Sie ihn und erstellen Sie einen neuen. Ein Schlüssel gehört Ihnen, nicht einer Organisation. Ein Agent, der ihn hält, sieht jede Organisation, der Sie angehören, in der Rolle, die Sie dort haben, und alles, was er tut, wird als von Ihnen getan festgehalten. Behandeln Sie den Schlüssel wie ein Passwort und widerrufen Sie ihn, sobald Sie den Agenten nicht mehr nutzen. Eine per Anmeldung hergestellte Verbindung reicht genauso weit wie ein Schlüssel und übersteht wie ein Schlüssel das Abmelden und das Ändern Ihres Passworts. Sie zu trennen ist ein eigener Schritt, der unten beschrieben ist. ## So verbinden Sie claude.ai claude.ai verbindet sich über eine URL und eine Anmeldung, ohne dass ein Schlüssel eingefügt werden muss. Eine in claude.ai hergestellte Verbindung gilt auch für Claude Desktop und die Claude-Apps für Mobilgeräte. 1. Öffnen Sie in claude.ai **Einstellungen**, dann **Connectors**, und wählen Sie **Benutzerdefinierten Connector hinzufügen**. 2. Geben Sie `https://letsfindwhy.com/api/mcp` als URL ein, genau wie geschrieben und ohne abschließenden Schrägstrich, und lassen Sie Client-ID und Secret leer. 3. Wählen Sie **Verbinden**. LetsFindWhy bittet Sie um eine Anmeldung, falls Sie noch nicht angemeldet sind, und zeigt dann, was die Verbindung tun kann; wählen Sie **Erlauben**. Um eine Verbindung zu beenden, öffnen Sie in LetsFindWhy die [Einstellungen](https://letsfindwhy.com/settings) und wählen Sie in der Karte **Verbundene Agenten** **Trennen**. Das ist der einzige Weg, sie zu widerrufen: Den Connector in Claude zu entfernen hindert Claude daran, ihn zu nutzen, aber ein später erneut hinzugefügter Connector meldet sich sofort wieder an. Entfernen Sie ihn an beiden Stellen, damit Claude Sie nicht erneut zur Anmeldung auffordert. ## So verbinden Sie Claude Code Claude Code kann sich auf dieselbe Weise anmelden. Führen Sie dies einmal aus, tippen Sie dann `/mcp` in Claude Code und wählen Sie **Authenticate**; für die Anmeldung öffnet sich ein Browserfenster. Das ist eine eigene Verbindung, getrennt von der, die claude.ai hält, und sie erscheint separat in den Einstellungen. ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp ``` Für Skripte, den Einsatz ohne Oberfläche oder jeden Client, der einen Request-Header setzen lässt, fügen Sie stattdessen einen Schlüssel ein: ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp --header "Authorization: Bearer mtg_..." ``` Claude Code listet dann für alles, was Sie in LetsFindWhy tun können, ein Werkzeug auf, benannt nach dem, was es tut: create_project, create_discussion_guide_with_questions, invite_recruited_respondents_to_session, get_session_transcript und so weiter. Sagen Sie in einfachen Worten, was Sie möchten, und es wählt die Werkzeuge aus. Cursor, Skripte und andere Clients, die einen Request-Header setzen lassen, funktionieren genauso. Die Connector-Verzeichnisse von claude.ai und Claude Desktop können keinen Header senden; sie verbinden sich stattdessen über URL und Anmeldung, wie oben beschrieben. ## Was ein Agent kann und was nicht Ein Agent arbeitet als Sie. Er bereitet Forschung vor und liest sie; er führt keine Interviews und verwaltet nicht Ihr Team. **Er kann:** - Organisationen, Projekte, Prozesse, Leitfäden und Screener erstellen und aktualisieren. - Die Rekrutierung verwalten: Anmeldelinks öffnen und schließen, Befragte von Hand hinzufügen und sie zu Sitzungen einladen. - Sitzungen im Voraus vorbereiten: sie anlegen, ihre Einstellungen ändern, einen Leitfaden zuweisen und dessen Fragen bearbeiten. - Ergebnisse lesen: Aufzeichnungen, Transkripte, Antworten, KI-Erkenntnisse und Nutzung. **Er kann nicht:** - In ein laufendes Interview eingreifen. Starten, Beenden, Personen zulassen, sie entfernen sowie den KI-Moderator hinzurufen oder entlassen bleibt den Personen im Raum vorbehalten. - Ändern, wer zu Ihrer Organisation gehört: Er kann keine Rollen ändern, keine Mitglieder entfernen, die Inhaberschaft nicht übertragen, die Organisation nicht verlassen und nicht löschen. - Aufzeichnungen löschen. Mit einer Aufzeichnung wird auch ihr Transkript gelöscht, das bleibt also eine Entscheidung, die Sie in der App treffen. Die Grenze liegt dort, weil ein Agent liest, was Befragte gesagt haben, und eine befragte Person etwas sagen könnte, das ihn steuern soll. Was immer er liest, er kann Sie nicht aus Ihrer eigenen Organisation aussperren und Ihre Forschung nicht löschen. Das Löschen eines Projekts, einer Sitzung, eines Prozesses, eines Leitfadens oder eines Screeners ist erlaubt. Projekte und Sitzungen lassen sich 30 Tage lang wiederherstellen, und Ihr Agent fragt vor jedem Löschen um Bestätigung. ## So rufen Sie die REST-API direkt auf Jedes Werkzeug ist darunter ein REST-Endpunkt. Senden Sie Ihren Schlüssel als `Authorization: Bearer mtg_...` und blättern Sie nach der Anmeldung unter [/api/docs](https://letsfindwhy.com/api/docs) durch die vollständige Referenz mit jedem Endpunkt und seinen Parametern. Schlüssel sind auf kurze Schübe begrenzt: 60 Aufrufe in einer Sekunde über die REST-API und etwa 30 über MCP, wo jeder Werkzeugaufruf den Schlüssel zweimal prüft. Kein denkender Agent erreicht eines der beiden. Ein Aufruf darüber erhält eine 429-Antwort, die sagt, wie lange zu warten ist.