So funktionieren Verbindungen

kanman arbeitet in den Werkzeugen, die dein Team schon nutzt. Workspace-Einstellungen > Verbindungen (/<workspace>/settings/connections) zeigt oben unter Verbundene Systeme die Systeme, die dein Workspace verbunden hat. Darunter, unter System hinzufügen, stehen alle übrigen Systeme, mit denen sich kanman verbinden kann, gruppiert danach, was sie für dein Team tun: Code und Auslieferung, Arbeit und Planung, Betrieb, Wissen, Daten und Dateien, Menschen und Kommunikation, Qualität und Sicherheit und Allgemein (MCP-Server und Webhooks).

Alle Systeme, mit denen sich kanman verbindet, stehen im Katalog der Verbindungen.

Ein System wird einmal für den ganzen Workspace verbunden. Erst dann können Teams es nutzen: Jedes Team wählt in seinen eigenen Einstellungen, was es nutzt, etwa welche Repositories, welches Jira-Projekt oder welche ServiceNow-Gruppen.

Ältere Links auf die früheren Seiten Code-Hosts, Tracker und Chat sowie Treffer der Einstellungssuche öffnen die Seite des passenden Systems.

Verbundene Systeme

Jedes verbundene System hat eine Zeile, die auf einen Blick zeigt:

• Seinen Namen, und den Namen der Verbindung, wenn du ein System mehrfach verbunden hast, etwa zwei Jira-Sites. Jede Verbindung hat dann eine eigene Zeile.
• Aus der kanman-Cloud verbunden oder Über deinen Runner verbunden (für Systeme in deinem Firmennetz, etwa ein selbst betriebenes GitLab oder ServiceNow hinter deinem VPN). In einem Workspace, der alles auf eigenen Runnern ausführt, läuft jede Verbindung über deinen Runner; siehe Workspaces, die alles auf eigenen Runnern ausführen.
• Welche Teams es nutzen.
• Eine Zeile dazu, was kanman damit tut.
• Seinen Zustand: In Ordnung, Braucht Aufmerksamkeit, Noch nicht getestet, Weniger Rechte als zuvor (ein späterer Test fand, dass das Konto weniger darf), Ungewöhnlich still (ein System, das sonst Alarme oder Tickets schickt, ist viel länger still als üblich) oder Länger kein Erfolg.

System hinzufügen

Zuerst suchen: Tipp einen Namen oder einfach, was du brauchst, etwa „Tickets", „Alarme", „CI", „Wiki" oder „Fehler", und die passenden Systeme erscheinen sofort, die besten Treffer zuerst. Mit ↓ gelangst du vom Suchfeld in die Treffer, mit ↑ und ↓ zwischen ihnen, Enter öffnet einen, Escape führt zurück ins Feld. Die Chips unter der Suche grenzen die Liste auf eine Gruppe ein.

Für dich empfohlen listet Systeme, auf die die Repositories deiner Teams schon hinweisen, jeweils mit einem kurzen Grund, etwa „Nutzt SENTRY_DSN in acme/api" oder „sonar-project.properties in acme/web". kanman schaut dabei nur auf Dateinamen und die Namen von Umgebungsvariablen, nie auf deren Werte.

Ohne Suche zeigt jede Gruppe zuerst ihre meistgenutzten Systeme; Alle … zeigen listet den Rest der Gruppe. Mit Beta markierte Systeme funktionieren und werden gerade mit weiteren Teams geprüft.

Findet die Suche nichts, wähle „…" anfragen, um uns zu sagen, welches System du brauchst. Wir notieren es und sagen dir Bescheid, sobald sich kanman damit verbindet.

Die eigene Seite eines Systems

Klicke auf eine Zeile, um die eigene Seite des Systems zu öffnen, etwa /<workspace>/settings/connections/jira. Hast du ein System mehrfach verbunden, hat jede Verbindung ihre eigene Seite mit einem kurzen Code nach dem Namen (jira-3fa9c1). Du kannst diese Links als Lesezeichen speichern oder teilen; Zurück zu Verbindungen führt zurück zur Liste.

Jede Seite beginnt mit Wofür kanman es nutzen kann: eine kurze Beschreibung und eine Liste dessen, was kanman mit dem System tut, etwa deine Repositories lesen, eigene Merge Requests nach dem Review öffnen und mergen oder Incidents lesen. Danach folgen für jedes System dieselben Teile:

• Verbindung: wie du es verbindest und welche Verbindungen es schon gibt, mit Verbindung testen, das zeigt, welche Rechte kanman je Nutzungsart hat. Zugangsdaten werden unter einem Secret-Namen gespeichert und nie wieder angezeigt. Systeme mit Anmeldung, etwa Linear und Google Sheets, bieten stattdessen Anmelden: Speichere die Verbindung, wähle dann Autorisieren und melde dich beim System an. Die Verbindung zeigt danach Autorisiert als und das Konto; läuft der Zugang ab, sagt sie das, und Neu verbinden meldet dich erneut an. Bei manchen Systemen kannst du dich auch anmelden, statt ein Token einzugeben (Google Sheets, Linear, Vercel (das installiert die Vercel-Integration von kanman für das Team, das du wählst), Azure DevOps Services mit deinem Microsoft-Konto und MCP-Server mit eigener Anmeldung): Wähle Anmelden, speichere und klicke auf Autorisieren. Du stimmst im Fenster des Systems zu und kommst auf die Seite zurück, die dann Autorisiert als mit dem genutzten Konto zeigt. kanman erneuert die Anmeldung selbst; geht das nicht mehr, zeigt die Seite Autorisierung abgelaufen und Neu verbinden. Systeme, die jedes Team selbst einrichtet (Alarmquellen, Checkmk, Backstage, Webhooks), verlinken stattdessen auf die Seite jedes Teams.
• Zuordnung: wo jedes Team wählt, was es von diesem System nutzt.
• Lesen: was kanman von sich aus liest, sobald das System verbunden ist. Lesen ändert nie etwas im System.
• Aktionen: sobald verbunden, die Grenze des Workspace für jede Aktion: das Höchste, was ein Team kanman erlauben darf. Eigentümer und Admins setzen die Grenzen; Teams wählen innerhalb davon. Bevor ein System verbunden ist, zeigt die Liste, wie jede Aktion startet.
• Zustand: pro Verbindung, wann sie zuletzt funktioniert hat, ihr letztes Problem und welche Rechte der letzte Test je Nutzungsart gefunden hat.
• Teams: die Teams, die das System nutzen. Jeder Name öffnet die Einstellungen dieses Teams dafür.

Was kanman tun darf: sichere Standards

kanman überrascht dich in keinem anderen System:

• Lesen ist an, sobald ein System verbunden ist.
• Alles, was Menschen oder Kunden außerhalb deines Teams erreicht (ein für Kunden sichtbarer Kommentar, eine Nachricht, ein Alarmruf), ist Aus, bis ein Team es einschaltet, und läuft nie ohne Rückfrage.
• Interne Schreibvorgänge mit geringem Risiko, etwa eine Arbeitsnotiz an einem Incident, starten mit Erst fragen: kanman schlägt sie im Teamraum vor und führt sie nach einem Tipp auf Freigeben aus.
• Nichts läuft Automatisch, bis ein Team es so wählt, und nur innerhalb der Grenzen, die Eigentümer und Admins für den Workspace setzen. Die eine Ausnahme lässt alles, wie es war: Auf GitHub und GitLab bleiben kanmans eigene Arbeit an den Repositories, die ein Team verbunden hat (seine Branches pushen, seine Merge Requests öffnen und nach deinen Merge-Regeln und Review-Vorgaben mergen, CI wiederholen), und was kanman schon an der Arbeit von Menschen erledigt hat (deren Merge Requests reviewen, wo das Team es eingeschaltet hat, verknüpfte Issues aktuell halten), Automatisch. In Jira bleibt ebenfalls Automatisch, was kanman schon für ein Team erledigt hat (seine Issues anlegen, ändern, verschieben und kommentieren, Merge Requests verknüpfen, Personen im Team antworten, die kanman erwähnen). Alles Neue an der Arbeit von Menschen, etwa jemanden einem Issue zuweisen, startet mit Erst fragen, und Branches anderer löschen oder den Branch-Schutz ändern wird gar nicht angeboten. Jedes Team kann jede dieser Aktionen auf seiner Seite Verbindungen herunterstufen.

Die Verbindungen eines Teams

Jedes Team hat seine eigene Seite Team > Verbindungen (/<workspace>/teams/<team>/team/connections). Sie listet nur die Systeme, die dein Workspace verbunden hat, jeweils mit Zustand und dem, was kanman damit tut. Eigentümer und Admins sehen zusätzlich einen Link, um weitere Systeme für den Workspace zu verbinden; alle anderen sehen nur, was verbunden ist.

Klicke auf ein System, um es für dieses Team in einem Panel zu öffnen:

• wofür kanman es nutzen kann und wie es der Verbindung geht;
• was das Team ihm zuordnet, etwa seine Kanäle oder Projekte, und was kanman dort für dieses Team tun darf, innerhalb der Grenzen des Workspace (das ändern die Leads des Teams, Eigentümer und Admins);
• für Eigentümer und Admins ein Link zur Seite des Systems in den Workspace-Einstellungen.

Dasselbe Panel öffnet sich überall, wo kanman ein verbundenes System nennt, etwa in den nächsten Schritten einer Incident-Prüfung.

Jede Verbindung auf einen Blick

Jedes Werkzeug hat eine Zeile mit seinem Zustand:

• Verbunden: Die Verbindung funktioniert. Die Zeile nennt das Konto oder die Site, zum Beispiel „Deine Verbindung als ada“ bei GitHub.
• Braucht Aufmerksamkeit: kanman kann die Verbindung nicht mehr nutzen, etwa weil ein Token abgelaufen ist oder der Zugriff entzogen wurde. Verbinde sie neu.
• Kein Zustand und ein Knopf Verbinden (oder Verknüpfen): Das Werkzeug ist noch nicht verbunden.

Schlagen Aufrufe an ein System wiederholt fehl, etwa weil ein Token widerrufen wurde oder das System nicht mehr antwortet, pausiert kanman seine Aufrufe an diese Verbindung, statt es immer wieder zu versuchen. kanman sagt den Teams, die die Verbindung nutzen, in ihrem Chat Bescheid und markiert sie mit Braucht Aufmerksamkeit. Behebe die Ursache und wähle Verbindung testen: Sobald der Test klappt, nutzt kanman die Verbindung wieder.

Verbinden öffnet immer die Anmeldung des Anbieters oder ein kurzes Formular in einem Fenster, eine Verbindung wird also erst gespeichert, wenn sie vollständig ist. Alles andere steht im Menü ⋯ der Zeile. Dort ist auch Trennen, und es fragt vorher nach: Die Bestätigung nennt, welche Teams betroffen sind und was nicht mehr funktioniert. Eine Verbindung, die Teams nutzen, sagt das in ihrer Zeile, zum Beispiel Von 3 Teams genutzt: bei einem Code-Host die Teams mit einem Repository dort, bei Jira die mit der Site verknüpften Teams, bei Slack die Teams mit einem Kanal, bei einem Wiki die Teams, die daraus lesen.

Wer was verbindet

Alle anderen sehen diese Zeilen mit einem kurzen Hinweis an der Stelle des Knopfs und wissen so, wen sie fragen können.

Code

GitHub und GitLab haben jeweils eine eigene Seite unter Code und Auslieferung und werden wie jedes andere System verbunden. Die Verbindung gehört dem Workspace: Jedes Team nutzt sie für seine Repositories. Inhaber und Admins klicken auf der Seite auf GitHub verbinden (oder GitLab verbinden):

• GitHub: Wähle als Anmeldung Anmelden, speichere und klicke auf Autorisieren; GitHub fragt nach deiner Bestätigung und leitet dich zurück. Für GitHub Enterprise Server gibst du stattdessen seine Adresse und ein Token oder Schlüssel ein. Unter den Verbindungen zeigt die kanman GitHub App die Konten, auf denen sie installiert ist; mit der App nutzen Runs kurzlebige Tokens, die auf ein Repository beschränkt sind. Siehe GitHub verbinden.
• GitLab: Wähle Anmelden für gitlab.com, oder gib die Adresse deines GitLab und ein Zugriffstoken als Token oder Schlüssel ein. Für ein GitLab, das nur dein Firmennetz erreicht, wähle unter Erreicht aus Dein Runner (in deinem Netz): Die kanman Cloud nimmt dann nie Kontakt zu ihm auf, und dein Runner erledigt alle Arbeit damit. Siehe Jira und GitLab verbinden.

Verbindung testen prüft die Verbindung (über deinen Runner, wenn er sie erreicht) und zeigt, was kanman damit tun darf. Eine Verbindung, die nicht mehr funktioniert, etwa weil ihr Token abgelaufen ist, ist mit Braucht Aufmerksamkeit markiert: Trag vorher mit Bearbeiten ein neues Token ein. Ältere Links auf die frühere Karte Code öffnen GitHub.

Die Repository-Auswahl der Team-Einrichtung und unter Team > Repositories nutzt die Verbindung des Workspaces. Gibt es noch keine, verbinden Inhaber und Admins sie direkt dort; alle anderen werden auf die Seite des Code-Hosts hier verwiesen.

Tracker

GitHub- und GitLab-Issues kommen mit ihrem Code-Host und stehen deshalb nicht noch einmal hier. Jira ist ein System der Liste wie jedes andere: Jira Cloud (Adresse der Site, E-Mail und API-Token) oder Jira Data Center (Adresse und persönliches Zugriffstoken, aus der kanman Cloud oder über deinen Runner), mit einem Verbindungstest, der zeigt, was kanman nutzen darf. Auch die Team-Einrichtung verbindet es an Ort und Stelle. Jedes Team wählt dann sein Jira-Projekt und unter Team > Verbindungen, was kanman in Jira tun darf. Siehe Jira und GitLab verbinden.

Chat

Slack und Microsoft Teams gehören zum Team-Tarif. Ohne ein Team mit Team-Tarif zeigt die Karte, welcher Tarif sie enthält, siehe Tarife und Abrechnung.

Slack: Klicke auf Slack verbinden und bestätige in Slack. Ist Slack verbunden, enthält das Menü ⋯ der Zeile Testnachricht senden und Trennen. Welche Kanäle ein Team nutzt, legst du im Reiter Team des Teams fest. Teams ohne eigenen Kanal posten in den Ausweichkanal des Workspaces: Öffne unter der Zeile Teams ohne eigenen Kanal posten in …, um ihn zu wählen. Siehe Entscheidungen in Slack beantworten.

Microsoft Teams: Öffne Microsoft Teams in der Liste. Auf seiner Seite wählen Inhaber und Admins Verknüpfungscode erstellen: Der Code erscheint mit einem Knopf Kopieren und der Zeit, bis zu der er gilt (30 Minuten). Sende link und den Code in Microsoft Teams an kanman; die Verbindung zeigt dann, dass sie verbunden ist, und Neuen Verknüpfungscode erstellen verknüpft erneut. Siehe Mit kanman in Slack und Microsoft Teams arbeiten.

Wissen

Confluence, Notion und SharePoint sind wie Jira Systeme der Liste: Öffne ihre Seite, um sie zu verbinden. Teams wählen dann eine Verbindung, wenn sie unter Mind > Gedächtnis > Quellen eine Quelle hinzufügen; hat eine Quelle noch keine Verbindung, verlinkt die Seite des Teams dorthin. Trennen löscht den gespeicherten Zugang, und die Quellen, die Teams daraus hinzugefügt haben, werden nicht mehr aktualisiert; was kanman schon gelesen hat, bleibt, bis das Team die Quelle entfernt. Siehe Verbindungen für Notion und SharePoint.

SharePoint gehört zum Team-Tarif. Ohne ihn zeigt seine Seite, welcher Tarif es enthält.

Verwandte Seiten

• GitHub verbinden
• Jira und GitLab verbinden
• Mit kanman in Slack und Microsoft Teams arbeiten
• Teamkontext und Verbindungen
• Workspace, Mitglieder und Rollen