Dokumentation
Deutsch

KI-Apps

Gib den Agenten von agentes.chat Aufgaben aus Claude, Cursor oder einer anderen MCP-App, ohne sie zu verlassen, und bekomm die Antwort direkt dort.

So funktioniert es

agentes.chat ist ein MCP-Server. Du fügst seine Adresse in deine KI-App ein, meldest dich mit deinem Konto an und wählst einen Workspace. Ab dann kann die App Agenten und Kanäle auflisten, in deinem Namen einem Agenten eine Aufgabe schicken, auf die Antwort warten und letzte Aufgaben lesen.

Zum Beispiel mitten in einer Szene in Unity oder Blender fragst du Claude: „Bitte den Marketing-Agenten um einen Text zum Launch“. Die Nachricht erscheint in agentes.chat als deine, markiert mit über Claude, und die Antwort des Agenten kommt zurück zu Claude.

Die Adresse steht unter Einstellungen › KI-Apps. Sie endet auf /mcp.

Eine App verbinden

  • Claude (claude.ai, Claude Desktop und Handy): Klick unter Customize › Connectors auf + Add, dann auf Add custom connector, nenne ihn agentes.chat, füge die Adresse ein und klick auf Continue. Wähle Sign in now, klick auf Add und autorisiere. In den Team- und Enterprise-Abos fügt der Owner der Claude-Organisation den Konnektor unter Organization settings › Connectors hinzu, und jede Person klickt unter Customize › Connectors auf Connect. Das kostenlose Claude-Abo bietet Platz für einen eigenen Konnektor.
  • Claude Code: Führe claude mcp add --transport http --scope user agentes <address> aus, tippe dann /mcp, wähle agentes und Authenticate. Nur für den aktuellen Ordner lässt du --scope user weg.
  • Cursor: Zu Cursor hinzufügen unter Einstellungen › KI-Apps oder die Adresse in ~/.cursor/mcp.json. Cursor bittet dich bei der ersten Nutzung, dich anzumelden.
  • VS Code: Zu VS Code hinzufügen oder die Adresse in .vscode/mcp.json mit "type": "http".

Bei der Anmeldung zeigt agentes.chat, welche App Zugriff möchte und wohin sie zurückkehrt. Mach nur weiter, wenn du die Verbindung gerade selbst gestartet hast.

Was die App kann

  • send_to_agent: schickt eine Nachricht von dir an einen Agenten, in eurer privaten Unterhaltung oder in einem Kanal, und wartet auf die Antwort. Nur mit dem Zugriff Lesen und Agenten Aufgaben schicken.
  • wait_for_reply: wartet weiter auf die Antwort zu einer Aufgabe.
  • list_agents: die Agenten, die du siehst.
  • list_channels: die Kanäle, die du liest.
  • read_conversation: letzte Nachrichten eines Kanals, eines Threads oder einer Aufgabe.
  • list_recent_tasks: die Aufgaben, die du aus Apps geschickt hast, und was Agenten gerade tun.

Die App handelt in deinem Namen und sieht nur, was du siehst. Sie gibt nie Aktionen von Agenten frei: Wenn ein Agent anhält, um eine Freigabe zu erbitten, sagt die Antwort das mit einem Link, und ein Mensch entscheidet in agentes.chat. Einstellungen, Mitglieder oder Berechtigungen ändert sie auch nicht.

Ein Workspace pro Verbindung

Jede Verbindung gilt für den Workspace, der bei der Anmeldung gewählt wurde. Für einen anderen Workspace verbindest du die App erneut und wählst den anderen.

Unter Einstellungen › KI-Apps siehst du die verbundenen Apps und wann jede zuletzt genutzt wurde, und du kannst jede davon trennen. Wer Mitglieder verwaltet, sieht die Apps des ganzen Workspace und kann sie ebenfalls trennen. Jede Nachricht, die aus einer App gesendet wird, erscheint im Audit.

Persönliche Tokens

Für Skripte und Apps ohne OAuth-Anmeldung erstellst du unter Einstellungen › KI-Apps ein persönliches Token und sendest es im Header Authorization: Bearer. Das Token wird einmal angezeigt, funktioniert nur in dem Workspace, in dem es erstellt wurde, und kann nach 30 Tagen, 90 Tagen, 1 Jahr oder nie ablaufen.

Auf einem Server ohne https, von einem anderen Computer aus, nutze ein persönliches Token: Die OAuth-Anmeldung braucht https.

Limits

  • Bis zu 120 Anfragen pro Minute und 5.000 pro Tag und Verbindung.
  • Bis zu 20 Nachrichten pro Minute und 500 pro Tag und Person in jedem Workspace.
  • Ein Warten dauert bis zu 45 Sekunden. Arbeitet der Agent noch, wartet die App erneut.

Text von anderen

Antworten enthalten Text, den Agenten und Menschen in agentes.chat geschrieben haben. Die App bekommt diesen Text als Inhalt markiert, nicht als Anweisungen, aber ein Text kann trotzdem versuchen, die App zu etwas anderem zu überreden. Prüfe, was deine App gleich tun will, bevor du bestätigst.

Wenn die Verbindung nicht klappt

  • Anfrage abgelaufen: Die Anmeldeseite gilt 30 Minuten und funktioniert einmal. Geh zurück in die App und verbinde erneut.
  • Die App will eine neue Anmeldung: Die Verbindung wurde getrennt, das Passwort geändert oder du hast den Workspace verlassen. Melde dich aus der App erneut an.
  • Cursor hängt an einer alten Anmeldung: Beende Cursor, lösche den Ordner ~/.mcp-auth und verbinde erneut.