Wissensdatenbank
Studio öffnen
Inhalt

Erste Schritte

Skin-Studio

Build-Studio

Agenten

Konto, Teilen & Datenschutz

Hilfe & Referenz

Alle Themen / Agenten

Agent verbinden

Claude, ChatGPT, Claude Code, Codex oder einen anderen MCP-Client mit einem kurzen Code an deinen Studio-Tab koppeln – Schritt für Schritt, mit Fehlerbehebung.

Kurz gesagt

  1. Öffne das Studio, in dem du arbeiten willst (Skins unter /skin, Builds unter /build).
  2. Sieh in die Agent-Spalte rechts. Solange kein Agent verbunden ist, zeigt sie einen Kopplungscode wie K7Q-4MX. Ist die Spalte geschlossen, wähle Agent; ist der Code ausgeblendet, wähle oben in der Spalte Agent verbinden (das Ketten-Symbol).
  3. Wähle Code und Anweisung kopieren und füge alles in den Chat deines Agenten ein.
  4. Der Agent ruft genmc_pair mit dem Code auf. Die Agent-Spalte zeigt nun „Claude ist verbunden“ (oder den Namen deines Agenten).

Der Code gilt 10 Minuten und funktioniert einmal. Neuer Code erzeugt einen weiteren.

Beim ersten Mal: genMC zu deinem Agenten hinzufügen

Der Agent braucht den MCP-Server von genMC einmalig. Die Adresse steht im Feld unter Zum ersten Mal? genMC zu deinem Agenten hinzufügen – es ist die Adresse dieser Seite mit /api/mcp dahinter.

AgentSo fügst du genMC hinzu
Claude (Web, Desktop)Einen eigenen Konnektor mit der MCP-Server-URL hinzufügen (Einstellungen → Konnektoren).
ChatGPTgenMC mit derselben URL in den Einstellungen von ChatGPT als Konnektor / MCP-Server hinzufügen.
Claude Code (CLI und Desktop-App)claude mcp add --scope user --transport http genmc https://<diese Seite>/api/mcp ausführen – das Feld zeigt die genaue Zeile zum Kopieren. Ohne --scope user funktioniert genMC nur in dem Ordner, in dem du den Befehl ausgeführt hast.
Codex CLIcodex mcp add genmc --url https://<diese Seite>/api/mcp ausführen.
Cursor und andere MCP-ClientsEinen MCP-Server vom Typ Streamable HTTP mit derselben URL hinzufügen.
Codex-AppKeine Einrichtung: Öffne das Studio im eingebauten Browser der App. Seine Site-Tools verbinden sich ohne Code.

Menünamen in den Agent-Apps ändern sich gelegentlich; such nach „Konnektoren“, „MCP-Server“ oder „Tools“.

Du kannst diesen Schritt auch überspringen: Der kopierte Prompt bittet den Agenten, genMC selbst zu installieren. Agenten, die Befehle ausführen können (Claude Code, Codex CLI), tun das sofort – deine App fragt dich dabei eventuell einmal um Freigabe. Ein neu hinzugefügter Server lädt erst in einer neuen Sitzung; im aktuellen Chat spricht der Agent deshalb per einfachem HTTP mit genMC – das funktioniert, braucht aber mehr Schritte pro Aktion. Ab der nächsten Sitzung nutzt er die genMC-Tools direkt.

Während der Verbindung

  • Der Agent arbeitet genau in diesem Tab. Lass den Tab offen; du kannst solange andere Tabs oder Apps nutzen.
  • Ein Agent pro Tab. Koppelst du einen anderen Agenten mit einem neuen Code, ersetzt er den ersten. Für zwei Agenten parallel öffne einen weiteren Tab: Er bekommt seinen eigenen Skin oder Build.
  • Mehrere Verbindungen desselben Agenten. Ein Agent kann den Tab aus mehreren MCP-Sitzungen gleichzeitig erreichen – etwa aus seinem Chat und einem Hilfsskript –, indem er sich in jeder mit seinem resumeKey wieder verbindet. Sie teilen sich den Tab; eine neue Kopplung mit Code ersetzt sie alle.
  • Neuladen behält die Verbindung. Ein duplizierter Tab übernimmt sie nicht, er zeigt einen eigenen Code.
  • Wird der Tab geschlossen oder geht das Gerät schlafen, warten die Aufrufe des Agenten bis zu 30 Sekunden auf den Tab und scheitern dann mit einer klaren Meldung.

Neu verbinden ohne neuen Code

Beim Koppeln bekommt der Agent einen resumeKey. Bricht seine Verbindung ab – die Agent-App oder der Server startete neu –, ruft der Agent genmc_pair mit diesem Schlüssel auf und ist wieder im selben Tab, ohne dich zu fragen. Verbindet er sich aus einer zweiten Sitzung, kommt diese zur ersten hinzu, statt sie zu trennen. Der Schlüssel verfällt, wenn du Trennen wählst oder einen anderen Agenten koppelst.

Trennen

Wähle in der Agent-Spalte wieder Agent verbinden: Trennen beendet den Zugriff des Agenten auf diesen Tab; Neu verbinden (neuer Code) beginnt von vorn.

Fehlerbehebung

ProblemWas du tun kannst
Der Agent sagt, ihm fehlt das Tool genmc_pairgenMC ist noch nicht als MCP-Server hinzugefügt, oder die Verbindung scheiterte beim Start des Agenten (etwa weil die Seite nicht erreichbar war). Füge den Server in der Agent-App hinzu oder verbinde ihn neu und starte einen neuen Chat oder eine neue Sitzung.
„This code is unknown or expired“Codes gelten 10 Minuten und nur einmal. Wähle Neuer Code.
„Too many wrong pairing codes“Warte 10 Minuten; falsche Codes sind pro Netzwerk begrenzt, damit niemand Codes erraten kann. Gültige Codes und Wiederverbinden mit dem resumeKey zählen nicht.
Der Agent sieht die Tools nach dem Koppeln nichtManche Apps aktualisieren ihre Tool-Liste nicht. Der Agent kann stattdessen genmc_status und genmc_call nutzen.
Der Agent arbeitet im falschen TabJeder Tab hat seinen eigenen Code. Koppel neu aus dem gewünschten Tab.
Anfragen bleiben In WarteschlangeDer Agent hört nicht zu. Siehe Anfragen, Markierungen und Finish.

Mehr: Fehlerbehebung.