Der CoRoid-Connector ist das Programm, das es den Codierungs-Agenten auf Ihrem eigenen Rechner ermöglicht, für CoRoid zu arbeiten (siehe Codierungs-Agenten auf Ihrem eigenen Rechner). Er steht unter der Apache-2.0-Lizenz zur Verfügung und sein vollständiger Quellcode befindet sich unter github.com/COROID-AI/coroid-connector. Diese Seite richtet sich an alle, die entscheiden, ob der Connector auf den Rechnern Ihres Unternehmens ausgeführt werden darf.
Wie Daten fließen
Ihre Maschine
CoRoid-Connector
Open Source. Startet den Agenten für eine Runde in einem neuen, leeren Verzeichnis und beendet ihn anschließend.
Ihr Codierungs-Agent
Der Agent, den Sie nutzen, angemeldet als Sie, mit deaktivierten eigenen Tools.
- 1Fordert Arbeit an. Jede Anfrage wird bis zu 25 Sekunden gehalten; der Connector meldet alle 3 Sekunden, was der Agent sagt.
- 2Ruft die Werkzeuge der jeweiligen Rolle auf. Mit einem Token nur für diese Runde, das nach Abschluss der Runde nicht mehr funktioniert.
- 3Fragt sein Modell ab. Genauso wie ohne CoRoid. CoRoid sieht diese Anmeldung nie.
CoRoid
Orchestrator
Weist die Arbeitsaufgabe der Rolle der Maschine der Person zu, die die Aufgabe gestartet hat (1).
Die Werkzeuge der jeweiligen Rolle
Läuft im Sandbox-Umfeld der Aufgabe, wo Ihr Code bleibt (2).
Der Anbieter des Agents
Beantwortet die Modell-Anfragen des Agents unter Ihrer eigenen Anmeldung, auf Ihrem Plan (3).
Nichts gelangt in die Maschine: Der Connector öffnet keine Ports, sendet keine Dateien und führt keine eigenen Befehle aus.
Auf der Maschine bleiben Ihre Anmeldung beim Agenten sowie alles, was der Agent selbst von einer Runde aufbewahrt.
- Nur ausgehend. Der Connector öffnet keine Ports – außer für einen kurzen Moment während
127.0.0.1des Einloggens. Er fragt CoRoid über HTTPS nach Arbeit. Jede Anfrage wird bis zu 25 Sekunden lang gepuffert und anschließend erneut gestellt; so erkennt auch CoRoid, dass der Rechner verbunden ist. - Ihr Code bleibt in CoRoid. Das Repository wird niemals auf den Rechner kopiert. Die Werkzeuge der Rolle (Datei lesen, Tests ausführen, Code ändern) werden in der Sandbox der Aufgabe in CoRoid ausgeführt. Was den Rechner erreicht, sind die Anweisungen der Rolle sowie die Ergebnisse dieser Werkzeuge – etwa der Inhalt einer von dem Agenten gelesenen Datei oder das Ergebnis eines Testlaufs.
- Die Modell-Anfragen des Agents gehen an seinen Anbieter, unter Ihrem eigenen Login und gemäß Ihrem Tarif – genauso wie ohne CoRoid. Was der Agent an sein Modell sendet, umfasst die Ergebnisse der Werkzeuge der Rolle; somit gilt für diese Daten Ihre Vereinbarung mit dem jeweiligen Anbieter.
- Die Arbeit geht nur an die Person, die sie initiert hat. Eine Rolle wird auf einem Rechner nur ausgeführt, wenn ihre Zuweisung einen Agenten nennt, die Person, die die Aufgabe startete, einen damit verbundenen Rechner im Unternehmen besitzt und die Richtlinie des Unternehmens die Nutzung dieses Agenten erlaubt. Arbeit, die niemand initiiert hat – etwa Automatisierungen – wird auf dem Modell des Agenten ausgeführt.
Was der Connector tut
- Einloggen mittels OAuth 2.1 und PKCE in Ihrem Browser, für einen einzigen Bereich (
connector.turns). Das Zugriffstoken ist 15 Minuten gültig; das Aktualisierungstoken 30 Tage und wird bei jeder Nutzung ersetzt. Verbindung trennen in Ihre Maschinen wird beides widerrufen. - Diese Token aufbewahren im macOS-Schlüsselbund oder im Secret Service unter Linux-Desktops; sie werden diesen Werkzeugen über die Standard-Eingabe übergeben – niemals über die Befehlszeile. Nur dort, wo weder das eine noch das andere möglich ist, werden sie in einer Datei gespeichert, die nur Sie lesen können.
coroid-connector statuszeigt an, wo sich Ihre Token befinden. - CoRoid mitteilen, bei seiner ersten Anfrage den Namen des Rechners, sein Betriebssystem, seine eigene Version sowie die Version, den Status und die angebotenen Modelle jedes Agenten.
- Eine Runde ausführen: startet den Agenten in einem neuen, leeren Verzeichnis mit deaktivierten eigenen Werkzeugen des Agenten, gibt ihm ein Werkzeugset (die Werkzeuge der Rolle für diese Runde), übermittelt seine Aussagen, lehnt alle Berechtigungsanfragen ab, die keine Aufrufe dieser Werkzeuge sind, und beendet ihn anschließend. Danach wird das Verzeichnis gelöscht.
Was er nicht tut
- Ihre Dateien lesen oder senden oder einen eigenen Befehl ausführen. Die einzige Datei, die er liest und die nicht ihm selbst gehört, ist die Cursor-Einstellung – für die beiden Werte, die bestimmen, ob er Cursor nutzen darf (siehe Einschränkungen); nichts davon verlässt den Rechner.
- Dem Agenten erlauben, seine Shell, Dateibearbeitung, Websuche oder eigene MCP-Server und Connectoren zu nutzen. Jeder Agent wird mit seinem eigenen Schalter für diese Funktionen gestartet – abhängig von der getesteten Agentenversion; ein Agent einer anderen Version wird aufgelistet, aber nicht verwendet.
- Einen Port öffnen, den andere erreichen können, oder über die geöffnete Verbindung Anweisungen von jemandem außer CoRoid entgegennehmen.
- Beim Ausführen etwas herunterladen.
coroid-connector addinstalliert den Adapter eines Agenten einmal – exakt aus den Paketen, die im Lockfile der jeweiligen Version aufgeführt sind (jedes durch Version und SHA-512 fixiert) – mit deaktivierten Installationsskripten.
Die von ihm gestellten Anfragen
| Zu | Wann | Wozu |
|---|---|---|
Die API von CoRoid (https://api.coroid.ai) | Einloggen und Ausloggen | Registrierung des Connectors, Austausch, Erneuerung und Widerruf seiner Token (/oauth/…) |
| Die API von CoRoid | Während der Ausführung | Nach Arbeit fragen (/connector/v1/poll) und eine Runde melden (/connector/v1/turns/…/events) |
| Das npm-Registry | Nur während coroid-connector add | Die Adapter-Pakete enthalten die im Lockfile der Version aufgeführten Namen. |
Der Agent – nicht der Connector – ruft die Werkzeuge der Rolle auf (eine Adresse unter
/connector/v1/turns/, mit dem Token dieser Runde) sowie seinen eigenen Anbieter.
Wogegen er ausgelegt ist
| Falls | Dann |
|---|---|
| Jemand anderes versucht, einen Rechner als Sie zu verbinden | Die Genehmigung erfolgt in Ihrem Browser – unter Ihrem Login – und das Einloggen wird nur auf dem Rechner abgeschlossen, der die Anfrage gestartet hat (unter 127.0.0.1, mit PKCE). Genehmigen Sie nur einen Connector, den Sie vor Kurzem gestartet haben. |
| Die Tokens eines Connectors werden gestohlen. | Sie umfassen einen einzigen Bereich: die Anfrage nach der Arbeit dieser Person und deren Berichterstattung. Das Zugriffstoken läuft innerhalb von 15 Minuten ab, und die Funktion „Trennen“ widerruft beide. |
| Das Token einer Runde wird wiederverwendet. | Es funktioniert nur für diese Runde und hört auf zu wirken, sobald die Runde endet. |
| Eine Runde fordert vom Agenten etwas anderes an. | Die eigenen Tools des Agents sind deaktiviert und der Connector lehnt weitere Berechtigungsanfragen ab. Die Tools der Rolle entsprechen denen eines Cloud-Modells – mit denselben QA-, Review-, Gates- und Schrittlimits. |
| Ein Release entspricht nicht dem, was seine Quelle angibt. | Jedes Release wird durch GitHub Actions aus einem getagten Commit des öffentlichen Repositorys erstellt, beglaubigt und auf npm mit Provenienz veröffentlicht. Die Homebrew-Formel übernimmt eine neue Version erst nach Überprüfung der Beglaubigung. Sie können eine solche selbst überprüfen (unten). |
Grenzen
- Der Agent wird in Ihrem Namen mit den Rechten Ihres Benutzers auf dem System ausgeführt. Die Einschränkung auf die Tools von CoRoid hängt vom jeweiligen Schalter des Agents ab; deshalb verwendet der Connector einen Agenten nur für die Versionen, auf denen er getestet wurde.
- Was ein Agent von einer Runde in seinem eigenen Speicher behält, hängt vom Agenten ab (siehe Was auf Ihrem System bleibt). Die Richtlinie Ihrer Organisation bestimmt, welche Agenten ihre Mitarbeiter nutzen dürfen (siehe Was Ihre Organisation zulässt).
- Cursor fragt vor seinen Web-Fetch-, Web-Suche- und Browser-Aktionen nur in seinen Standardeinstellungen nach. Der Connector liest zwei davon auf dem System aus (die Genehmigungsmodus-Einstellung sowie ob Web-Suchen automatisch akzeptiert werden) und verwendet Cursor nicht, wenn diese Einstellungen die Ausführung dieser Tools ohne Nachfrage erlauben.
- Der Connector wurde unter Windows nicht getestet.
Ein Release überprüfen
Jedes Release auf GitHub enthält das veröffentlichte Paket, die Connector-Datei, eine CycloneDX-Bill-of-Materials-Datei und SHA256SUMS. Ersetzen Sie <version> durch das Release, das Sie überprüfen.
Die Registrierungssignatur und Provenienz des npm-Pakets:
mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signaturesDie Beglaubigung, die den Commit und den Workflow nennt, der die Datei erstellt hat:
gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
--signer-workflow COROID-AI/coroid-connector/.github/workflows/release.ymlDie Datei, die Sie selbst aus dem getagten Quellcode erstellt haben:
git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs # the same as its line in SHA256SUMSUm eine Schwachstelle zu melden, nutzen Sie die Sicherheitsrichtlinie des Repositorys (GitHub's private Vulnerability Reporting).