Zum Hauptinhalt springen
Du kannst dich per Microsoft-Anmeldung in Free, Mini, Essentials und Plus verbinden. Der Workspace-API-Schlüssel und die vollständigen API-Tools erfordern 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. Jeder aktive Benutzer in diesem Workspace kann sich per Microsoft-Anmeldung verbinden. Melde dich mit Microsoft an, oder sende den API-Schlüssel aus Einstellungen > Integrations > API im Header X-API-KEY. Der API-Schlüssel erfordert Plus. 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, deine eigene Anfrage ändern oder 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, einschließlich einer Änderung an einem genehmigten Antrag.

Dokumentation durchsuchen

Die gesamte absentify Dokumentation durchsuchen und detaillierte Anleitungen abrufen. Direkt im selben Server integriert.
Im Plus-Plan können Administratoren beim Verbinden zusätzlich die vollständigen API-Tools erlauben. Diese Tools decken die absentify API ab. Der Assistent kann dann Benutzer, Abteilungen, Abwesenheitsarten und Workspace-Einstellungen ändern. POST /exports und GET /exports/{id}/file sind keine MCP-Tools. Starte diese Exporte über die REST API.

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“
  • „Ändere meinen Antrag für nächsten Montag in Krankheit“
  • „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“
  • „Genehmige die Änderung an Sarahs Antrag“
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 persönliche Tools, die in deinem Namen handeln. Diese Tools sind in jedem Plan verfügbar: Wenn du Administrator im Plus-Plan 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 die absentify API ab, einschließlich Benutzer, Abteilungen, Abwesenheitsarten und Workspace-Einstellungen. POST /exports und GET /exports/{id}/file sind keine MCP-Tools. 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 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. Der API-Schlüssel erfordert Plus.
In Free, Mini und Essentials erlaubt die Microsoft-Anmeldung 100 Tool-Aufrufe pro Tag und 20 Tool-Aufrufe pro Minute. Plus hat kein Limit für Tool-Aufrufe pro Tag oder pro Minute. 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 im Plus-Plan bist, kannst du auf dieser Maske zusätzlich die vollständigen API-Tools erlauben. Lass die Option aus, wenn der Assistent Benutzer, Abteilungen, Abwesenheitsarten und Workspace-Einstellungen nicht über die API ändern soll. Wenn dein Client diesen Ablauf nicht abschließen kann, verwende einen API-Schlüssel. Der API-Schlüssel erfordert Plus.
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:
  • No absentify account is linked to this Microsoft user. Please sign in to absentify once before connecting the app. If your workspace signs in with an email code instead of Microsoft 365, AI assistants cannot be connected.
  • Your workspace only allows signing in with an email code, not with Microsoft 365, so you cannot connect an AI assistant here.
  • Your workspace is locked because of an inactive subscription or an open invoice. Open absentify for details.
  • 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 needs the Plus plan. Please upgrade your subscription to use this API key. To connect an AI assistant without Plus, sign in with your Microsoft account instead of using an 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.
  • You have reached the limit of 100 absentify tool calls for today. It resets at 00:00 UTC. The Plus plan has no daily limit.
  • You have reached the limit of 20 absentify tool calls a minute. Wait a minute and try again. The Plus plan has no limit.
  • Der Assistent kann nur das tun, was der verbundene Benutzer in absentify darf.
  • Die Microsoft-Anmeldung enthält die vollständigen API-Tools, wenn ein Administrator im Plus-Plan sie beim Verbinden erlaubt. Verbinde dich als Administrator im Plus-Plan erneut und erlaube sie, wenn du die vollständigen API-Tools brauchst.
  • Wenn dieser Benutzer nicht aktiv ist, endet die Verbindung. Verbinde dich erneut, nachdem ein Administrator das Konto reaktiviert hat. Wenn der Workspace nicht auf Plus ist, steht die Microsoft-Anmeldung mit den persönlichen Tools zur Verfügung. Die vollständigen API-Tools und der API-Schlüssel erfordern Plus. Bei einem API-Schlüssel muss der Administrator, der den Schlüssel erzeugt hat, ein aktiver Administrator auf Plus 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-Endpunkte und ihre deutschen Erläuterungen durchstöbern.