Skip to main content
Der MCP Server erfordert Plus. Siehe Plan-Feature-Matrix.

Was ist der MCP Server?

Der absentify MCP Server verbindet KI-Assistenten direkt mit deinem absentify Workspace. Über das Model Context Protocol, einen offenen Standard, unterstützt von Claude, ChatGPT, Cursor und weiteren, kannst du in einfacher Sprache fragen, wie viele Urlaubstage du noch hast, wer diese Woche abwesend ist oder um einen Tag frei zu buchen.
MCP Server URL: https://api.absentify.com/api/mcpDas ist der Workspace-MCP-Server. Er erfordert einen Plus Plan. Jeder aktive Benutzer in diesem Workspace kann sich verbinden. Melde dich mit Microsoft an, oder sende den API-Schlüssel aus Einstellungen > Integrations > API im Header X-API-KEY. Nach der Microsoft-Anmeldung sieht und ändert der Assistent nur das, was dieser Benutzer sehen und ändern darf. Ein API-Schlüssel enthält immer die vollständigen API-Tools und handelt mit den Berechtigungen des Administrators, der ihn erzeugt hat.

Was kann die KI?

Sobald die Verbindung steht, kann dein KI-Assistent:

Dein Kontingent prüfen

Deine Abwesenheiten und dein Restkontingent anzeigen. Eine Abwesenheit beantragen oder deine eigene Anfrage stornieren.

Sehen, wer abwesend ist

Sehen, wer diese Woche abwesend ist, optional in einer Abteilung. Einen Benutzer per Name oder E-Mail nachschlagen.

Anfragen genehmigen

Anfragen anzeigen, die auf dich warten, und sie genehmigen oder ablehnen, wenn du in absentify Anfragen genehmigst.

Dokumentation durchsuchen

Die gesamte absentify Dokumentation durchsuchen und detaillierte Anleitungen abrufen. Direkt im selben Server integriert.
Administratoren können beim Verbinden zusätzlich die vollständigen API-Tools erlauben. Diese Tools decken jeden Endpunkt der absentify API ab. Der Assistent kann dann Benutzer, Abteilungen, Abwesenheitsarten und Workspace-Einstellungen ändern.

Beispiel-Prompts

Hier sind einige Dinge, die du deinen KI-Assistenten fragen kannst: Dein Urlaub:
  • „Wie viele Urlaubstage habe ich noch?“
  • „Erstelle einen Urlaubsantrag für nächste Woche Montag bis Freitag“
  • „Storniere meine Anfrage für nächsten Montag“
  • „Wer ist diese Woche in Marketing abwesend?“
Genehmigungen:
  • „Zeig mir die Anfragen, die auf mich warten“
  • „Genehmige die Abwesenheitsanfrage von Sarah“
Dokumentation und Hilfe:
  • „Wie konfiguriere ich Genehmigungsworkflows mit mehreren Genehmigern?“
  • „Was sind die API-Limits?“
  • „Wie funktioniert die Kalender-Synchronisierung?“

Verfügbare Tools

Standardmäßig erhält der Assistent nach der Microsoft-Anmeldung Tools, die in deinem Namen handeln: Wenn du Administrator bist, bietet die Zustimmungsmaske die Option, zusätzlich die vollständigen API-Tools zu erlauben. Diese Option ist aus, bis du sie wählst. Sie deckt jeden Endpunkt der absentify API ab. Ein Workspace-API-Schlüssel enthält diese vollständigen API-Tools automatisch. Für einen API-Schlüssel gibt es keine Zustimmungsmaske.

Einrichtung

Voraussetzungen

  • Ein Plus Plan
  • Ein aktiver Benutzer in diesem Workspace
  • Ein MCP-kompatibler KI-Client
  • Eine Authentifizierung. Melde dich mit Microsoft an, wenn dein Client einen Browser öffnen kann. Nutze den API-Schlüssel aus Einstellungen > Integrations > API, wenn das nicht geht.
Für die Microsoft-Anmeldung brauchst du ein Microsoft-Konto, das bereits zu diesem absentify-Benutzer gehört. Melde dich einmal bei absentify an, bevor du den Assistenten verbindest.

Server hinzufügen und mit Microsoft anmelden

Füge die Server-URL hinzu. Dein Client öffnet einen Browser, damit du dich mit Microsoft anmeldest. Nach der Kontoauswahl zeigt absentify eine Zustimmungsmaske mit dem Titel „Connect to absentify“. Sie nennt die App, dein Konto, deinen Workspace und die angefragten Berechtigungen. Wähle Allow, um die Verbindung abzuschließen. Cancel sendet dich zurück, ohne zu verbinden. Der Assistent handelt danach mit deinen Berechtigungen in diesem Workspace. Wenn du Administrator bist, kannst du auf dieser Maske zusätzlich die vollständigen API-Tools erlauben. Lass die Option aus, wenn der Assistent nicht jeden Endpunkt der absentify API nutzen soll. Wenn dein Client diesen Ablauf nicht abschließen kann, verwende stattdessen einen API-Schlüssel.
1

Connectors öffnen

Öffne Settings und wähle Connectors.
2

Custom Connector hinzufügen

Wähle Add custom connector und trage ein:
  • Name: absentify
  • Remote MCP server URL: https://api.absentify.com/api/mcp
Wähle Add.
3

Verbinden und anmelden

Wähle Connect neben absentify. Ein Browser-Fenster öffnet sich. Melde dich mit Microsoft an und bestätige den Zugriff. Fertig.
Claude Desktop verbindet Remote-Server über Connectors, nicht über die Datei claude_desktop_config.json. Diese Datei unterstützt nur lokale Server.
Die Einrichtungsanleitung findest du auch in Einstellungen > Integrations > MCP Server.

Mit einem API-Schlüssel verbinden

Wenn der Client die Microsoft-Anmeldung nicht abschließen kann, sende den Workspace-API-Schlüssel aus Einstellungen > Integrations > API im Header X-API-KEY.
  1. Öffne Einstellungen > Integrations > API.
  2. Auf der API-Integrationsseite wähle API-Schlüssel erhalten.
  3. Wähle Neuen Schlüssel generieren, und kopiere den Schlüssel, solange er angezeigt wird. Ein neu generierter Schlüssel macht den alten ungültig.
  4. Füge die Server-URL https://api.absentify.com/api/mcp hinzu und sende den Schlüssel im Header X-API-KEY.
Claude Code:
Clients mit einer JSON-Konfiguration ergänzen ein headers-Objekt:
Manche Clients zeigen X-API-KEY als optionalen Header. Trage ihn ein und überspringe die Microsoft-Anmeldung. Der Assistent handelt dann mit den Berechtigungen des Administrators, der den Schlüssel erzeugt hat. Er enthält die vollständigen API-Tools, kann also Workspace-Daten lesen und Abwesenheiten, Benutzer und Einstellungen erstellen oder ändern. Es gibt keine Zustimmungsmaske. Sende den Schlüssel nur in X-API-KEY. Gib ihn nicht in der URL an. Sende ihn nicht als Authorization: Bearer. Dieser Header ist für die Microsoft-Anmeldung. Wenn dein Client beides sendet, nutzt absentify die Microsoft-Anmeldung und ignoriert den API-Schlüssel. Wenn du einen neuen Schlüssel generierst, aktualisiere jeden Client, der noch den alten verwendet. Wie du den Schlüssel erstellst und ersetzt, steht unter API-Zugriff.

Beispiel: Echtes Gespräch

So sieht ein Gespräch mit einem MCP-verbundenen KI-Assistenten aus:
Der letzte Schritt funktioniert nur, wenn diese Anfrage auf dich wartet. Sonst lass den Assistenten deine eigenen Anfragen erstellen oder stornieren.
Du kannst die Dokumentation weiterhin durchsuchen, ohne deinen Workspace zu verbinden. Nutze den schreibgeschützten Dokumentations-MCP-Server unter https://absentify.com/docs/mcp. Damit kann dein KI-Assistent unsere Doku durchsuchen und Einrichtungsfragen beantworten, aber nicht mit deinem Workspace interagieren.

Fehlerbehebung

  • Stelle sicher, dass du die richtige URL verwendest: https://api.absentify.com/api/mcp
  • Prüfe deine Standard-Browser-Einstellungen
  • Starte die Verbindung erneut aus der Anwendung
absentify zeigt eine dieser Meldungen:
  • The absentify MCP server requires the Plus plan. Please upgrade your subscription to connect absentify to Copilot.
  • No absentify account is linked to this Microsoft user. Please sign in to absentify once before connecting the app.
  • Your absentify account is not active. Please ask an administrator to reactivate it.
  • This sign-in has expired oder This page has expired: Starte die Verbindung erneut aus der Anwendung.
  • absentify could not verify your Microsoft account. Please try again.
  • Too many sign-in attempts from this network. Please try again later.
absentify zeigt eine dieser Meldungen:
  • Authentication required.: Der Client hat weder eine Microsoft-Anmeldung noch einen X-API-KEY-Header gesendet.
  • The API key is not valid.: Öffne Einstellungen > Integrations > API, wähle API-Schlüssel erhalten, wähle dann Neuen Schlüssel generieren und kopiere den Schlüssel, solange er angezeigt wird.
  • The absentify API and MCP server require the Plus plan. Please upgrade your subscription to use this API key.
  • The user associated with this API key is no longer an active admin
  • User associated with API key not found
  • This API key was issued for a different workspace.
  • The access token is not valid.: Der Schlüssel wurde als Authorization: Bearer gesendet. Sende ihn stattdessen in X-API-KEY.
  • Prüfe die API-Limits. Möglicherweise bist du gedrosselt.
  • Der Assistent kann nur das tun, was der verbundene Benutzer in absentify darf.
  • Die Microsoft-Anmeldung enthält die vollständigen API-Tools nur, wenn ein Administrator sie beim Verbinden erlaubt hat. Verbinde dich als Administrator erneut und erlaube sie, wenn du jeden API-Endpunkt brauchst.
  • Wenn dieser Benutzer nicht mehr aktiv ist oder der Workspace keinen Plus Plan mehr hat, endet die Verbindung. Behebe das und verbinde dich danach erneut. Bei einem API-Schlüssel muss der Administrator, der den Schlüssel erzeugt hat, weiterhin ein aktiver Administrator auf einem Plus Plan sein.
  • This connection was authorized for a different workspace. Please connect absentify again.
  • Erwähne „absentify“ in deinem Prompt, damit die KI die richtigen Tools nutzt
  • Prüfe, ob das MCP-Tools-Symbol in deinem Client erscheint
  • Versuche es mit: „Nutze die absentify Tools um…“
  • Starte deinen KI-Client nach dem Hinzufügen des MCP Servers neu

Nächste Schritte

Integrations

Öffne MCP Server in den Einstellungen und folge der Einrichtungsanleitung

API-Referenz

Alle verfügbaren API-Endpoints durchstöbern. Die API-Referenz ist nur auf Englisch verfügbar.