Connectors
Verbinde Remote-MCP-Server, damit Prüfungen und Aufgaben nachsehen können, was der Code allein nicht zeigt: wie eine Funktion genutzt wird, was in den Logs steht, welche Daten in einer Tabelle liegen oder was die Dokumentation einer Bibliothek sagt. Connectors sind in kostenpflichtigen Tarifen enthalten.
Einen Connector hinzufügen
Nur ein Inhaber der GitHub-Organisation oder der Inhaber eines persönlichen Kontos kann Connectors verwalten. Arbeitsbereichseinstellungen → Mitglieder kennzeichnet diese Personen als Inhaber der GitHub-Organisation oder Kontoinhaber.
Im kostenlosen Tarif, auch nach dem Ende eines kostenpflichtigen Tarifs, nutzen Prüfungen und Aufgaben keine gespeicherten Connectors. Du kannst sie dann nur entfernen.
- Öffne Arbeitsbereichseinstellungen → Connectors und wähle Connector hinzufügen.
- Gib einen Namen, den HTTPS-Endpunkt des Servers und die benötigten Anfrage-Header ein, und wähle dann Tools laden.
- Wähle aus, welche Tools zugelassen sind, für welche Repositorys der Connector gilt und wo er verwendet wird.
- Wähle Connector speichern. Ab dann gestartete Prüfungen und Aufgaben können ihn verwenden.
| Feld | Was du eingibst |
|---|---|
| Name | Was der Connector enthält, etwa Produktionsanalysen. |
| HTTPS-Endpunkt | Die Streamable-HTTP-Adresse des Servers, etwa https://mcp.your-service.com/mcp. |
| Anfrage-Header | Die Zugangsdaten, die der Server erwartet, etwa Authorization: Bearer <token>. Die Werte werden verschlüsselt gespeichert und nie wieder angezeigt. |
| Hinweise für HeyDeer | Optional: was der Connector enthält und wann er hilft. |
Lass beim Bearbeiten eines Connectors den Wert eines Headers leer, um den gespeicherten zu behalten. Wenn du den Endpunkt änderst, gib alle Werte erneut ein.
Anforderungen an Endpunkt und Header
- Der Endpunkt darf keinen Query-String, kein
#-Fragment, weder Benutzernamen noch Passwort und keinen anderen Port als 443 enthalten. - Er braucht einen öffentlichen Domainnamen, keine IP-Adresse und keinen Namen, der auf
.local,.internal,.test,.invalid,.exampleoderlocalhostendet. - Ein Connector kann bis zu 10 Header haben, deren Werte jeweils bis zu 8.192 druckbare ASCII-Zeichen lang sein dürfen.
- Ein Arbeitsbereich kann bis zu 50 Connectors haben.
Tools
Nur lesende Tools listet die Tools, die der Server als nur lesend kennzeichnet. Jedes andere Tool, auch eines ohne Kennzeichnung durch den Server, steht unter Andere Tools. Wenn du die Tools zum ersten Mal lädst, sind ausschließlich die nur lesenden zugelassen.
| Ausführung | Aufrufbare Tools |
|---|---|
| Prüfungen und Autopilot | Zugelassene Tools unter „Nur lesend“ |
| „Mit HeyDeer beheben“ und @heydeer-Erwähnungen | Alle zugelassenen Tools, ob unter „Nur lesend“ oder „Andere“ |
Ein Agent kann nur die zugelassenen Tools aufrufen und entscheidet selbst, wann eines hilft. Wenn sich die Tools des Servers ändern, wähle Tools neu laden.
Wo Connectors verwendet werden
Ein Connector gilt für alle Repositorys oder für die, die du auswählst. Eine Aufgabe, die in mehreren Repositorys arbeitet, erhält die Connectors jedes dieser Repositorys.
Standardmäßig wird ein Connector nur in privaten Repositorys verwendet, und zwar für Änderungen von Personen mit Schreibzugriff. Eine Prüfung oder Aufgabe lässt ihn weg, wenn:
- das Repository öffentlich ist oder eine Aufgabe ein öffentliches Repository ändern kann;
- der Pull Request aus einem Fork stammt;
- der Autor des Pull Requests keinen Schreibzugriff auf das Repository hat.
Wähle Auch öffentliche Repositorys und Forks nur für Connectors, deren Daten jeder sehen darf, etwa öffentliche Dokumentation. Die Seite der Prüfung oder Aufgabe zeigt, welche Connectors sie weggelassen hat und warum.
Connector-Aufrufe
Die Seite einer Prüfung oder Aufgabe listet jeden Connector-Aufruf auf: den Connector, das Tool, wann der Aufruf lief, wie lange er dauerte und ob er fehlgeschlagen ist. HeyDeer speichert nicht, was gesendet oder zurückgegeben wurde.
Tool-Aufrufe und der Text, den sie zurückgeben, sind Teil der Arbeit und erhöhen daher ihren Credit-Verbrauch. Wenn eine Prüfung fehlschlägt, nachdem sie einen Connector aufgerufen hat, werden ihre Credits nicht zurückgegeben. Siehe So funktionieren Credits.
Datenschutz und Vertrauen
Der Agent sieht die Header-Werte nie: Die Sandbox von HeyDeer fügt sie den ausgehenden Anfragen des Agenten hinzu.
Anfragen können Code und Aufgabenkontext enthalten, die der Betreiber des Servers nach seinen eigenen Richtlinien verarbeitet. Auch ein nur lesendes Tool kann private Daten zurückgeben. Verbinde daher nur Dienste, denen du vertraust, verwende Zugangsdaten mit nicht mehr Zugriff als nötig, etwa eine Datenbankrolle mit reinem Lesezugriff, und lass nur die Tools zu, die du brauchst. Siehe Sicherheit.
Wenn HeyDeer die Tools eines Connectors nicht laden kann, siehe Fehlerbehebung.