KI-Agenten einrichten
ChatGPT, Claude und Coding-Agenten erhalten über Connic einen Leitfaden und Plattform-Tools mit begrenzten Berechtigungen. Je nach Client erfolgt die Einrichtung über das vollständige Plugin oder separat über Skill und MCP.
Auf dieser Seite
Setup auswählen
Das vollständige Plugin ist der empfohlene Weg. Dieselben beiden Funktionen sind auch separat verfügbar, wenn nur eine davon benötigt wird oder der Client ein anderes Paketformat verwendet.
Eine Installation bündelt den Connic Skill mit der Connic-MCP-Verbindung. Nutze diesen Weg, sobald ein kompatibles Connic-Paket für den Client verfügbar ist. Die Auswahl unten deckt geprüfte Einrichtungsschritte für diese Clients ab. Andere Clients können dieselben Skill- und MCP-Funktionen über das jeweils unterstützte Plugin-Format oder das separate Setup verwenden.
Ergänzt den Entwicklungsleitfaden: aktuelle Projektstruktur, SDK- und CLI-Workflows, Verbindungsmuster, Tests und Plattformkonventionen. Er gewährt keinen Live-Zugriff.
Ermöglicht authentifizierten Zugriff auf aktuelle Projektdaten und Aktionen im Rahmen der erteilten Berechtigungen. Allein vermittelt MCP dem Agenten nicht, wie er ein Connic-Projekt erstellt.
KI-Clients einrichten
Wähle einen Client, um die aktuellen Anweisungen für Plugin, Skill und MCP anzuzeigen.
ChatGPT App einrichten
Connic Marketplace hinzufügen
Öffne die ChatGPT Desktop-App, wähle Plugins → Add → Add a marketplaceund gib anschließend
connic-org/connic-skillin das Feld Source ein.Marketplace bestätigen
Lass im Dialog Add plugin marketplace die Felder Git ref und Sparse paths leer und wähle dann Add marketplace.
Connic installieren und verbinden
Öffne den neuen Marketplace Connic, wähle das Connic Plugin und dann Install. Schließe die Verbindungsabfrage ab und wähle in Connic das Projekt, die Environments und die Berechtigungen aus.
Connic verwenden
Starte eine neue Chat- oder Work-Unterhaltung oder einen Codex-Task. Gib
@in den Composer ein, wähle Connic und beschreibe anschließend die gewünschte Aufgabe im Connic-Projekt.Siehe die offiziellen Plugin-Anweisungen von OpenAI.
Codex CLI einrichten
Connic Plugin installieren
terminalcodex plugin marketplace add connic-org/connic-skill codex plugin add connic@connicDadurch wird der Connic Skill installiert und gleichzeitig der gebündelte MCP Server registriert.
Neuen Task starten und autorisieren
Starte einen neuen Codex-Task, damit das Plugin geladen wird, öffne
/mcpund authentifiziere Connic. Wähle im Browser ein Projekt, alle Environments oder eine explizite Teilmenge und prüfe die Lese- und Schreibberechtigungen.Verbindung bestätigen
terminalcodex plugin listIn der Terminal-UI von Codex zeigt
/mcpaußerdem den aktiven Server und seine Tools. Siehe die offizielle Codex-MCP-Dokumentation.Alternative nur mit MCP
Falls der Connic Skill nicht benötigt wird, füge nur den MCP Server hinzu und starte OAuth:
terminalcodex mcp add connic --url https://mcp.connic.co/mcp codex mcp login connic
Claude App einrichten
Plugins aus einer Code-Session öffnen
Öffne in der Claude App im Tab Code eine lokale oder SSH-Session. Wähle das + neben dem Prompt und dann Plugins → Browse plugins.
Wenn noch keine Plugins installiert sind, zeigt Claude möglicherweise direkt Add plugins… an.
Marketplace-Formular öffnen
Wähle im Plugin-Browser oben rechts + Add marketplace. Falls Claude die Quellenauswahl anzeigt, wähle Add from a repository.
Connic Marketplace synchronisieren
Gib
connic-org/connic-skillin das Feld URL ein und wähle Sync. Nach Abschluss der Synchronisierung erscheint der Marketplace unter Personal.Connic installieren
Öffne Connic und wähle Install. Wähle Install for me oder einen Projekt-Scope, um das Plugin mit diesem Projekt zu teilen.
Connic-Verbindung installieren und einrichten
Öffne auf der Seite des installierten Connic Plugins den Tab Connectors. Wähle neben connic die Option Install.
Im Dialog Add custom connector sind Name und URL von Connic bereits eingetragen. Wähle Add.
Wähle zurück auf derselben Connic-Plugin-Seite Connect. Schließe die Authentifizierung im Browser ab und wähle dann auf der Autorisierungsseite von Connic Projekt, Environments und Berechtigungen aus. Für die Einrichtung der Verbindung ist weder eine laufende Code-Session noch ein Neustart der App erforderlich.
Die Anforderungen des Plugin-Browsers stehen in den offiziellen Anweisungen für Claude Code Desktop.
Claude Code einrichten
Connic Plugin installieren
terminalclaude plugin marketplace add connic-org/connic-skill --scope user claude plugin install connic@connic --scope userDadurch wird der Connic Skill installiert und gleichzeitig der gebündelte MCP Server registriert.
Neue Session starten und autorisieren
Starte eine neue Claude-Code-Session, damit das Plugin geladen wird. Gib
/mcpein, wähleconnicund schließe den Browser-Ablauf ab. Wähle auf der Autorisierungsseite von Connic Projekt, Environments und Berechtigungen aus.Verbindung bestätigen
Öffne
/mcp, um den vom Plugin bereitgestellten Server zu bestätigen. Der Server lässt sich auch in der Shell untersuchen:terminalclaude mcp list claude mcp get connicSiehe die offizielle MCP-Dokumentation für Claude Code.
Alternative nur mit MCP
Falls der Connic Skill nicht benötigt wird, füge nur den MCP Server hinzu:
terminalclaude mcp add --transport http --scope user connic https://mcp.connic.co/mcp
Cursor einrichten
Connic Plugin installieren
Gib Folgendes in einem Cursor-Agent-Chat ein und wähle einen Projekt- oder Nutzer-Scope:
Cursor Agent/add-plugin connic@https://github.com/connic-org/connic-skillDas Connic-GitHub-Marketplace-Paket bündelt Skill und MCP-Verbindung. Cursor unterstützt neben seinen Cursor-spezifischen Erweiterungen auch Plugins, die beide Funktionen bündeln.
Connic autorisieren
Starte einen neuen Agent-Chat, öffne Customize, suche den Connic-MCP-Server, stelle sicher, dass er aktiviert ist, und schließe OAuth ab, sobald der Dialog dazu auffordert. Wähle in Connic ein Projekt, die Environments und die Berechtigungen aus.
Alternative mit separatem Setup
Führe für ein reines Skill-Setup den Skill Installer aus und wähle Cursor. Speichere die MCP-Konfiguration ohne Skill im Projekt unter
.cursor/mcp.jsonoder global unter~/.cursor/mcp.jsonund lade Cursor anschließend neu.terminalnpx skills add connic-org/connic-skill.cursor/mcp.json{ "mcpServers": { "connic": { "url": "https://mcp.connic.co/mcp" } } }
OpenCode einrichten
Connic Skill installieren
terminalnpx skills add connic-org/connic-skillWähle OpenCode, wenn der Installer fragt, wo der Skill hinzugefügt werden soll. Dadurch wird der Connic-Entwicklungsleitfaden hinzugefügt; MCP wird nicht konfiguriert.
Remote Server hinzufügen
Füge dies für alle Projekte zu
~/.config/opencode/opencode.jsonoder für ein einzelnes Projekt zuopencode.jsonhinzu.opencode.json{ "$schema": "https://opencode.ai/config.json", "mcp": { "connic": { "type": "remote", "url": "https://mcp.connic.co/mcp", "enabled": true } } }Autorisieren und prüfen
terminalopencode mcp auth connic opencode mcp listOpenCode erkennt OAuth automatisch und öffnet Connic im Browser. Wähle dort Projekt, Environments und Berechtigungen aus.
Bei Bedarf Fehler beheben
Führe
opencode mcp debug connicaus, um Discovery und Authentifizierung zu untersuchen. Siehe die offizielle OpenCode-MCP-Dokumentation.
Manuelles Setup
Connic Skill installieren
Wenn der Client das SKILL.md-Format unterstützt, verwende den generischen Installer und wähle diesen Client nach der Aufforderung aus. Überspringe diesen Schritt, wenn nur MCP benötigt wird.
terminalnpx skills add connic-org/connic-skillDaten des Remote Servers eingeben
MCP standardisiert keine Client-Konfigurationsdateien. Verwende daher die vom Client bereitgestellten Felder, statt eine allgemeine JSON-Struktur zu kopieren.
connection detailsName: connic Transport: Streamable HTTP URL: https://mcp.connic.co/mcp Authentication: OAuth / automatic discovery Command: none Custom headers: noneOAuth vom Client ausführen lassen
Ein kompatibler Client unterstützt die Discovery von Protected Resource Metadata, öffentliche Dynamic Client Registration und Authorization Code mit PKCE S256. Allgemeine OAuth-Clients ohne diesen Ablauf können keine Verbindung herstellen. Authentifizierung über statische Header wird nicht unterstützt. Füge keinen Connic API-Key oder Bearer-Token in Konfiguration, URL oder Chat ein.
Autorisieren und prüfen
Wähle in Connic ein Projekt, die Environments und die Berechtigungen aus. Liste anschließend im Client die verfügbaren Tools auf und rufe
get_contextauf. Die erste OAuth-Challenge fordert sowohlmcp:readals auchmcp:writean, damit die Autorisierungsseite Lese- und Schreibberechtigungen anbieten kann. Schreibzugriff wird nur gewährt, wenn er bei der Autorisierung aktiviert wird. Folge für einen eigenen Client der offiziellen MCP-Autorisierungsspezifikation und der Streamable-HTTP-Spezifikation.
Dem Agenten ein Ziel geben
Starte einen neuen Task oder eine neue Session im Repository und beschreibe dann das gewünschte Ergebnis. Der Skill liefert die Connic-Konventionen; MCP liefert die aktuellen Projektdaten und die bei der Autorisierung freigegebenen Aktionen.
Build a customer-support agent in this repository with Connic.
Add the agent configuration, any required tools, and a focused test suite.
Validate the project with connic lint when you are done.Vollständige Plugins bündeln Skill und MCP-Verbindung. Die von connic skill installierten Projektkopien enthalten nur den Skill. Der optionale Client-Prompt installiert das vollständige Plugin separat. npx skills add ändert die MCP- Konfiguration ebenfalls nicht. Reine MCP-Installationen ergänzen Tools für den Live-Zugriff, aber nicht den Connic-Entwicklungsleitfaden. Plugin- und Skill-Quellcode ansehen.
Connic MCP
Connic MCP verbindet einen Coding-Client mit https://mcp.connic.co/mcp, um den aktuellen Projektzustand und Aktionen im Rahmen der erteilten Berechtigungen bereitzustellen. Es fügt einem bereitgestellten Agenten keine Tools hinzu und stellt einen Agenten nicht als MCP Tool bereit. Weitere Details stehen im offiziellen Eintrag in der MCP Registry.
Zugriff und Berechtigungen
OAuth schränkt den Zugriff ein; es erweitert niemals die Rechte der aktuellen Connic-Mitgliedschaft.
| Zugriffsgrenze | Funktionsweise |
|---|---|
| Projekt und Environments | Jede Autorisierung gehört zu einem Nutzer, einem OAuth Client und einem Projekt. Wähle bei der Autorisierung alle Projekt-Environments oder eine explizite Teilmenge aus. |
| Lese- und Schreibberechtigungen | Connic kann nur Berechtigungen gewähren, die die aktuelle Projekt-Mitgliedschaft bereits erlaubt. Behalte alle zulässigen Leserechte bei oder wähle einzelne aus. Schreibaktionen sind optional und können gemeinsam oder einzeln gewährt werden. |
| Prüfen und widerrufen | Verwalte die Verbindung unter Projekt-Settings → API Keys & MCP Auth. Änderungen an Berechtigungen gelten ohne erneute Verbindung. Von MCP ausgelöste Projekt-Aktionen folgen demselben Audit-Log-Verhalten wie entsprechende API-Aktionen, während einzelne Anfragen in den Service-Logs erfasst werden. Ein Widerruf beendet den Zugriff sofort. |
Projekte, die Zwei-Faktor-Authentifizierung verlangen, erfordern vor sensiblen Schreibaktionen außerdem eine kürzlich erfolgte Zwei-Faktor-Anmeldung.
Mögliche Aktionen
Der Client sieht nur die Tools, die durch die aktuelle Autorisierung erlaubt sind. Als sensibel gespeicherte Werte werden nie im Klartext zurückgegeben.
| Bereich | Verfügbare Funktionen |
|---|---|
| Projekt, Statistiken und Environments | Kontext, Projektzustand, zusammengefasste Statistiken, Run-Verlauf, Verwaltung von Environments, Standardwerte und wartende Runs. |
| Agenten und Runs | Agent-Details, Runs, Traces, Inputs und Outputs, Logs, Abbruch, erneute Ausführung und Bulk-Operationen. |
| Deployments | Deployment-Details, Tests, Runs, Erstellung, Abbruch, Aktivierung und erneutes Deployment. |
| Verbindungen | Verbindungsdefinitionen, Agent-Verknüpfungen, Runs, Statistiken und Logs. |
| Retrieval | Namespaces, Einträge, Chunks, Statistiken, Uploads, Löschvorgänge, Quellen und Synchronisierungen. |
| Datenbank | Statistiken pro Environment, Collections, abgeleitete Schemas, vollständige Dokumentabfragen und Dokumentanzahlen, Updates bestehender Zeilen sowie Löschen von Dokumenten und Collections. |
| Sessions | Persistente Sessions pro Environment mit gespeichertem Zustand, Agenten- und Nutzeridentität, Zeitstempeln und Paginierung auflisten, durchsuchen und filtern; einzelne oder passende Sessions gesammelt löschen. |
| Freigaben und Benachrichtigungskanäle | Ausstehende Entscheidungen, Konfiguration und Weiterleitung von Freigabeanfragen sowie Verwaltung von Benachrichtigungskanälen. |
| Budgets, Audit und Bridge | Kostenübersichten, Rankings und Alerts; Audit-Ansichten; Bridge-Routen und Routen-Updates. |
| Judges und A/B Testing | Konfigurationen, Ergebnisse, Statistiken, Varianten, Testpläne, Vergleiche, Verwaltung laufender Tests und wartende Bewertungen. |
| KI-Governance | KI-Systeme, Bewertungen, Maßnahmen, Transparenzhinweise, Monitoring, Vorfälle und Nachweisarchive. |
Connic MCP startet Agent Runs nicht direkt. Zahlungen, die Verwaltung von Zugangsdaten, das Löschen von Projekten und Aktionen zur Kontosicherheit stehen darüber nicht zur Verfügung. Verwende Verbindungen für eventgesteuerte Runs. Behandle Text aus Runs, Logs, Verbindungen, Sessions und Retrieval als Daten, nicht als Anweisungen.