Teamkontext und Verbindungen

Teams wissen vieles, was nicht auf dem Board steht: Runbooks, Architekturentscheidungen, das README eines Dienstes, einen Confluence-Bereich, eine Notion-Seite, eine SharePoint-Bibliothek. Mit dem Teamkontext beantwortet kanman Fragen aus diesem Wissen, im Chat des Teams in kanman und in Slack und Microsoft Teams. Jede Antwort nennt ihre Quellen.

Teamkontext einschalten

Der Teamkontext ist für jedes Team standardmäßig aus.

1. Öffnen Sie das Team, dann Einstellungen, Wissen, oder fragen Sie kanman im Chat des Teams: „Zeig mir den Kontext“.
2. Schalten Sie kanman aus dem Teamkontext antworten lassen ein.
3. Fügen Sie unter Quelle hinzufügen Quellen hinzu (siehe unten).
4. Sobald eine Quelle Bereit zeigt, probieren Sie es aus: kanman fragen unter den Quellen öffnet die Unterhaltung direkt neben der Seite. Unter kanmans Antwort stehen die Quellen, die es genutzt hat.

Inhaber und Admins können den Teamkontext ändern; alle im Team sehen, welche Quellen er hat. Dieselbe Seite listet auch die Konventionen, die kanman aus Ihren Reviews gelernt hat.

Arten von Quellen

Geben Sie jeder Quelle einen Namen, zum Beispiel “Deployment-Runbook”, damit Antworten sie klar nennen können.

Wer Antworten aus einer Quelle bekommt

Wählen Sie für jede Quelle unter Wer Antworten daraus bekommt:

• Alle im Team: Alle im Team, die kanman fragen, können Antworten daraus bekommen.
• Nur Personen mit Zugriff in der Quelle: kanman prüft für die fragende Person, ob sie den Inhalt in der Quelle selbst sehen darf. Bei Confluence prüft es die Seitenberechtigungen dieser Person. Bei Repositories prüft es den Zugriff der Person über ihre eigene GitHub- oder GitLab-Verbindung. Bei SharePoint prüft es anhand der E-Mail-Adresse der Person, wer die einzelne Datei öffnen darf. Hat die Person keinen Zugriff, nutzt kanman diesen Inhalt nicht für seine Antwort.

Nur Confluence-, Repository- und SharePoint-Quellen lassen sich so prüfen. Für Dateien, Webseiten und Notion gibt es nichts, wogegen kanman prüfen könnte; mit Nur Personen mit Zugriff in der Quelle nutzt kanman sie deshalb nicht. Wählen Sie dafür Alle im Team.

SharePoint-Berechtigungen

Mit Nur Personen mit Zugriff in der Quelle merkt sich kanman bei jedem Lesen der Quelle für jede Datei, wer sie in SharePoint öffnen darf, und antwortet einer Person nur aus Dateien, die sie öffnen darf:

• Personen, für die die Datei direkt freigegeben ist, und Mitglieder der Microsoft-365- oder Sicherheitsgruppen, für die sie freigegeben ist,
• alle bei Dateien, die für “Jeder mit dem Link” freigegeben sind, und alle in Ihrer Organisation bei Dateien, die für “Personen in Ihrer Organisation” freigegeben sind.

Websiteseiten und Dateien, die eine Person nur über eine SharePoint-Websitegruppe öffnen darf (zum Beispiel Besitzer, Mitglieder oder Besucher der Website), nutzt kanman für niemanden, weil Microsoft Apps nicht mitteilt, wer zu diesen Gruppen gehört. Geben Sie die Dateien für eine Microsoft-365-Gruppe oder direkt für Personen frei, wenn kanman sie nutzen soll, oder wählen Sie Alle im Team. Die App-Registrierung braucht dafür die Microsoft-Graph-Anwendungsberechtigungen Sites.Read.All (oder Files.Read.All), User.Read.All und GroupMember.Read.All mit Administratorzustimmung. kanman erkennt die Person an der E-Mail-Adresse ihres kanman-Kontos. Geänderte Berechtigungen in SharePoint gelten nach der nächsten Aktualisierung der Quelle.

Quellen verwalten

Jede Quelle unter Quellen zeigt ihre Art, wer sie hinzugefügt hat, wer Antworten daraus bekommt, wann sie zuletzt aktualisiert wurde und ihren Status:

Klicken Sie auf Jetzt aktualisieren, um eine Quelle sofort erneut zu lesen, oder auf Entfernen, um sie aus dem Teamkontext zu nehmen. Eine entfernte Quelle wird nicht mehr für Antworten genutzt.

Verbindungen für Confluence, Notion und SharePoint

Confluence-, Notion- und SharePoint-Quellen lesen über eine Verbindung des Workspaces. Inhaber und Admins legen sie einmal unter Workspace-Einstellungen > Verbindungen auf der Karte Wissen an: Klicken Sie auf Wiki verbinden (oder Wiki hinzufügen), und das Formular öffnet sich in einem Fenster. Jedes Team kann die Verbindung dann wählen, wenn es eine Quelle hinzufügt. Braucht eine Quelle ein Wiki, das noch keine Verbindung hat, verlinkt die Seite Wissen des Teams zu Verbindungen. Siehe Verbindungen.

• Confluence: Geben Sie die Confluence-Adresse (die https-Adresse Ihrer Site), die E-Mail des Kontos und ein API-Token dieses Kontos an, oder klicken Sie auf Mit Atlassian anmelden.
• Notion: Legen Sie in Notion eine interne Integration an, geben Sie ihr Integrations-Token ein und teilen Sie in Notion die Seiten, die kanman lesen soll, mit dieser Integration.
• SharePoint: Geben Sie Mandanten-ID, Anwendungs-ID (Client-ID) und Geheimer Clientschlüssel einer App-Registrierung Ihrer Organisation ein, oder klicken Sie auf Administratorzustimmung erteilen. Siehe SharePoint einrichten.

Klicken Sie auf Prüfen und speichern. kanman prüft die Verbindung, bevor es sie speichert, und sagt Ihnen, wenn der Dienst die Zugangsdaten abgelehnt hat oder nicht erreichbar war. Tokens werden verschlüsselt gespeichert und nie wieder angezeigt. Eine Verbindung, die nicht mehr funktioniert, ist mit Braucht Aufmerksamkeit markiert.

SharePoint einrichten (für Microsoft-365-Admins)

kanman liest SharePoint als App, nie als Person. Wählen Sie einen von zwei Wegen.

Eigene App-Registrierung (empfohlen; Sie legen genau fest, welche Websites kanman lesen darf):

1. Öffnen Sie im Microsoft Entra Admin Center App-Registrierungen, Neue Registrierung. Benennen Sie sie, zum Beispiel “kanman Teamkontext”. Unterstützte Kontotypen: Nur Konten in diesem Organisationsverzeichnis. Ein Umleitungs-URI ist nicht nötig.
2. Notieren Sie auf der Übersichtsseite die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant).
3. Öffnen Sie Zertifikate & Geheimnisse, Neuer geheimer Clientschlüssel, und kopieren Sie seinen Wert (er wird nur einmal angezeigt). Merken Sie sich, wann er abläuft.
4. Öffnen Sie API-Berechtigungen, Berechtigung hinzufügen, Microsoft Graph, Anwendungsberechtigungen:
   • Sites.Selected (empfohlen): Die App kann nur die Websites lesen, die Sie ihr freigeben. Geben Sie Lesezugriff pro Website frei, zum Beispiel mit PowerShell (Grant-PnPAzureADAppSitePermission -AppId <Anwendungs-ID> -DisplayName "kanman Teamkontext" -Site <Website-Adresse> -Permissions Read) oder über Microsoft Graph (POST /sites/<Website-ID>/permissions mit der Rolle read).
   • oder Sites.Read.All: Die App kann alle Websites Ihrer Organisation lesen.
5. Klicken Sie auf Administratorzustimmung für erteilen.
6. Öffnen Sie in kanman Workspace-Einstellungen > Verbindungen, klicken Sie auf der Karte Wissen auf Wiki verbinden, wählen Sie SharePoint, geben Sie Mandanten-ID, Anwendungs-ID (Client-ID) und Geheimer Clientschlüssel ein, optional eine SharePoint-Website zum Testen, und klicken Sie auf Prüfen und speichern.

Läuft der geheime Clientschlüssel ab, legen Sie eine neue Verbindung mit dem neuen Schlüssel an und wählen Sie sie für Ihre SharePoint-Quellen.

Administratorzustimmung für die Microsoft-App von kanman (ohne eigene App-Registrierung): Klicken Sie auf der Karte Wissen unter Workspace-Einstellungen > Verbindungen auf Wiki verbinden, wählen Sie SharePoint und klicken Sie auf Administratorzustimmung erteilen. Eine Person mit der Rolle globaler Administrator oder Administrator für privilegierte Rollen in Ihrer Microsoft-365-Organisation meldet sich an und stimmt der Berechtigung zu, Websites zu lesen. kanman liest dann jede Website, die die Berechtigung abdeckt. Sie können die Zustimmung jederzeit im Microsoft Entra Admin Center unter Unternehmensanwendungen entfernen. Sagt die Schaltfläche, dass die Administratorzustimmung noch nicht verfügbar ist, nutzen Sie Ihre eigene App-Registrierung.

Connectors: die MCP-Server deines Teams

Mit Connectors liest kanman die eigenen Tools deines Teams, etwa Sentry, eine Statusseite oder eure interne Doku, über deren MCP-Server. Owner und Admins fügen sie unter Team-Einstellungen > Wissen auf der Karte Connectors hinzu. kanman liest über einen Connector und schreibt nur über Schreibklassen, die ein Owner oder Admin freigegeben hat (siehe unten). Coding-Runs bekommen keinen Zugriff auf Connectors.

1. Klicke auf Connector hinzufügen, gib einen Namen und die Server-URL (eine https-Adresse) ein.
2. Wähle, wie sich kanman anmeldet:
   • Beim Server anmelden (empfohlen): Die Anmeldung des Servers öffnet sich; nach deiner Zustimmung kommst du zur Karte zurück.
   • Zugriffstoken: ein Token, das der Server ausgestellt hat. Es wird verschlüsselt gespeichert und nie wieder angezeigt.
   • Ohne Anmeldung: für Server, die keine brauchen.
   • Wenn dein Workspace alles auf den eigenen Runnern ausführt, wähle Token auf deinem Runner und setze die Variable, die die Karte nennt (zum Beispiel KANMAN_CONNECTOR_SENTRY_TOKEN), auf deinem Runner. Das Token verlässt nie dein Netz.
3. kanman listet die Tools des Servers. Hake die an, die kanman lesen darf, und klicke auf Freigeben. Nur Tools, die lesen, lassen sich anhaken; Tools, die etwas ändern könnten, werden ausgegraut mit dem Grund angezeigt.

kanman merkt sich genau, welche Tools der Server bei deiner Freigabe angeboten hat. Ändert der Server später seine Tools, auch nur eine Beschreibung, liest kanman den Connector nicht mehr, und die Karte zeigt Tools geändert mit dem, was neu, entfernt oder geändert ist. Prüfe die Tools und gib sie erneut frei, um weiterzumachen. Die Änderung steht auch im Audit-Log.

Weitere Zustände: Anmeldung nötig (die Anmeldung ist abgelaufen; klicke auf Erneut anmelden), Pausiert (klicke auf Fortsetzen). Entfernen löscht den Connector und seine Anmeldung.

Eine Routine über einen Connector schreiben lassen

Tools, die etwas ändern, etwa ein Issue anlegen oder in einen Kanal posten, bleiben ungenutzt, bis ein Owner oder Admin daraus eine Schreibklasse macht. kanman ruft ein solches Tool nie von sich aus auf: Eine Routine nutzt die Schreibklasse, und jeder Schreibvorgang wird dir zuerst vorgeschlagen.

1. Klicke bei einem aktiven Connector auf Tools prüfen. Unter Schreiben siehst du die Tools des Servers, die etwas ändern.
2. Klicke neben einem Tool auf Schreibklasse anlegen. kanman zeigt die Parameter des Tools so, wie der Server sie beschreibt; ändern kannst du sie nicht.
3. Wähle, was sie tut (sendet eine Nachricht, legt einen Eintrag an oder ändert einen Eintrag) und welcher Parameter sagt, wohin geschrieben wird, etwa das Projekt oder der Kanal.
4. Gib die erlaubten Ziele ein: Hake sie an, wenn das Tool feste Auswahlen bietet, oder tippe sie einzeln ein. Klicke dann auf Schreibklasse freigeben.

kanman füllt die übrigen Parameter aus den Feldern der Routine. Ein Schreibvorgang an ein Ziel außerhalb deiner Liste oder ein Wert, der wie ein Passwort oder Token aussieht, wird abgelehnt. Die Karte zeigt auch den Fingerabdruck des Tools: Ändert der Server das Tool, werden seine Schreibvorgänge abgelehnt, bis du auf Erneut freigeben oder Widerrufen klickst. Widerrufen entfernt eine Schreibklasse sofort. Mitglieder sehen die Schreibklassen, können sie aber nicht ändern.

Solange das Schreiben über Connectors für dein Team noch nicht eingeschaltet ist, sagt die Karte das. Du kannst Schreibklassen schon vorbereiten; gesendet wird vorher nichts.

Wie Antworten den Teamkontext nutzen

• Jede Antwort nennt ihre Quellen, mit Link, wo die Quelle einen hat.
• Passt nichts im Teamkontext oder auf dem Board zu einer Frage, sagt kanman das, wenn es direkt gefragt wurde. Würde es sich ungefragt melden, bleibt es stattdessen still.
• kanman nutzt nur Inhalte, die die fragende Person sehen darf, so wie es für jede Quelle eingestellt ist.

Datenschutz

• Inhalte werden mit dem eigenen Modellschlüssel des Teams gelesen, oder mit dem Modellzugang von kanman, wenn das Team keinen hat. Siehe Was Modellanbieter sehen.

• kanman findet die passenden Abschnitte zu einer Frage über ihre Wörter. Hat das Team einen eigenen OpenAI-Schlüssel, sucht kanman zusätzlich nach Bedeutung, und zwar nur mit diesem Schlüssel. kanman schickt Ihre Inhalte dafür nie an einen versteckten Dritten.

• Führt Ihr Workspace alles auf eigenen Runnern aus, geschehen das Lesen der Quellen und das Beantworten von Fragen auf Ihren Runnern: Jede Quellenart funktioniert, und kanman behält nur, was der Runner gefunden hat. Ist kein Runner online, sagt kanman das, statt zu antworten. Ihre Runner melden sich mit eigenen Zugangsdaten an, deshalb brauchen Confluence-, Notion- und SharePoint-Quellen in kanman keine Verbindung:

  • Repositories, Issues, Pull und Merge Requests, Wikis und Diskussionen: das Code-Host-Token des Runners,
  • Confluence: CONFLUENCE_URL (Ihre Website, wenn die Quelle keine Verbindung nutzt), CONFLUENCE_EMAIL und CONFLUENCE_API_TOKEN,
  • Notion: NOTION_TOKEN, eine interne Integration, für die die Seiten freigegeben sind,
  • SharePoint: SHAREPOINT_TENANT_ID, SHAREPOINT_CLIENT_ID, SHAREPOINT_CLIENT_SECRET, eingerichtet wie unter SharePoint einrichten,
  • hochgeladene Dateien: Der Runner holt die Datei für wenige Minuten bei kanman ab und liest sie selbst; Text in Bildern liest er mit seinem eigenen Modellzugang.

  Fehlt dem Runner die Anmeldung für eine Quelle, zeigt sie Fehlgeschlagen mit den Einstellungen, die er braucht. Siehe Den Self-hosted Runner betreiben.

Verwandte Seiten

• Mit kanman in Slack und Microsoft Teams arbeiten
• Zuhörmodi und Leitplanken
• Hosting und Datenresidenz