Slack — API und MCP
Überblick
Dieser Bereich stellt 12 Operationen bereit. Jede davon ist zugleich ein MCP-Werkzeug.
Der Bereich hängt am Modul-Schalter module.slack. Ist das Modul aus, antworten diese Operationen mit 404.
Operationen
| Methode | Pfad | Zweck | Recht | Parameter |
|---|---|---|---|---|
GET | /api/v1/slack/installation | Eine SlackInstallation lesen | octi.slack.read | — |
POST | /api/v1/slack/messages | Nachricht in einen verknuepften Slack-Channel senden — Sendet einen Text in den Slack-Channel einer aktiven Projekt-Verknuepfung. Ziel entweder ueber channelId (Slack-Id C…) oder ueber projectId. Geprueft wird octi.slack.manage in der Marke des verknuepften Projekts. | octi.slack.manage | + Rumpf |
DELETE | /api/v1/slack/my-link | Eigene Slack-Zuordnung lösen — Entfernt die Zuordnung des eigenen Kontos zu Slack und offene Einmal-Codes; Slash-Befehle aus dem Slack-Konto wirken danach nicht mehr. | octi.slack.link_own | — |
GET | /api/v1/slack/my-link | Eigene Slack-Zuordnung lesen — Ob das eigene Octibiz-Konto mit einem Slack-Konto verbunden ist (Anzeigename, seit wann) und bis wann ein offener Einmal-Code gilt. Recht octi.slack.link_own. | octi.slack.link_own | — |
POST | /api/v1/slack/my-link/code | Einmal-Code für die Slack-Zuordnung erzeugen — Erzeugt einen Einmal-Code (10 Minuten gültig, einmalig, gedrosselt); ein offener Code verfällt. In Slack /octi connect <Code> senden — danach handeln die Slash-Befehle unter diesem Konto. Der Code steht nur in dieser Antwort. | octi.slack.link_own | — |
GET | /api/v1/slack/project-links | Liste der SlackProjectLink | octi.slack.read | page |
POST | /api/v1/slack/project-links | Eine SlackProjectLink anlegen | octi.slack.manage | + Rumpf |
DELETE | /api/v1/slack/project-links/{ulid} | Eine SlackProjectLink löschen | octi.slack.manage | ulid |
GET | /api/v1/slack/project-links/{ulid} | Eine SlackProjectLink lesen | octi.slack.read | ulid |
PATCH | /api/v1/slack/project-links/{ulid} | Eine SlackProjectLink ändern | octi.slack.manage | ulid, + Rumpf |
GET | /api/v1/slack/user-links | Slack-Zuordnungen der Mitarbeiter auflisten — Welche Slack-Konten mit welchem Octibiz-Konto verbunden sind (Anzeigename, seit wann). Entstehen nur per Einmal-Code des Mitarbeiters. Recht octi.slack.read. | octi.slack.read | — |
DELETE | /api/v1/slack/user-links/{ulid} | Slack-Zuordnung eines Mitarbeiters lösen — Entfernt die Zuordnung; Slash-Befehle aus diesem Slack-Konto wirken danach nicht mehr, bis der Mitarbeiter einen neuen Code einlöst. Recht octi.slack.manage. | octi.slack.manage | ulid |
Zweckangaben, die nicht dem Standardmuster folgen, stammen unverändert aus der Schnittstellen-Beschreibung im Code.