i-Planner MCP-Server

Zur Schritt-für-Schritt-Einrichtung↗

Verbindung und Verfügbarkeit

MCP-Server-Adresse: https://www.mcp.i-planner.app/mcp

Anmeldung: OAuth. Melde dich direkt bei i-Planner an und prüfe die angezeigten Berechtigungen bei der Freigabe. Gib dein i-Planner-Passwort und die Zugangsdaten deiner Postfächer nicht an einen KI-Assistenten weiter.

Dokumentationsadresse: https://www.api.i-planner.app/mcp-server. Diese Seite ist öffentlich und ohne Anmeldung erreichbar. Sie ist nicht der MCP-Verbindungsendpunkt.

Der Connector befindet sich in einer geschlossenen Prüf- und Testphase. Eine Einreichung im Verzeichnis bedeutet noch keine Genehmigung oder allgemeine Verfügbarkeit. Bis zur öffentlichen Freigabe können sich nur ausdrücklich freigeschaltete Testzugänge verbinden. Eine verbundene App erhält dadurch keinen Zugriff auf zusätzliche Organisationen oder Postfächer.

MCP für eine Organisation freischalten

1. Du benötigst eine aktive i-Planner-Mitgliedschaft in einer Organisation, deren Tarif MCP-Zugriff umfasst. Während der Prüfphase muss dein Zugang zusätzlich ausdrücklich zum Testen freigeschaltet sein.
2. Ein berechtigter Administrator öffnet Organisation → Einstellungen → MCP und aktiviert die benötigten E-Mail- und Signaturfunktionen.
3. Unter Organisation → Einstellungen → Benutzerrollen müssen MCP und die benötigten Funktionen für deine Rolle freigegeben sein. Die Freigabe auf Organisationsebene allein gewährt nicht jedem Mitglied Zugriff.
4. Verbinde den Server in deiner KI-Anwendung als benutzerdefinierten MCP-Connector mit der oben genannten Server-Adresse und OAuth. Wenn du mehreren Organisationen angehörst, wähle bei der Anmeldung die gewünschte Organisation.
5. Prüfe und bestätige die angefragten Funktionen. Du kannst weniger freigeben, aber nicht mehr Rechte gewähren, als deine Organisation und Rolle erlauben.

Der Zugriff auf ein Postfach muss zusätzlich freigegeben sein. Das Leserecht erlaubt nicht automatisch den Versand, das Bearbeiten von Nachrichten oder das Verwalten von Signaturen. Die Rechte werden bei jedem Tool-Aufruf erneut geprüft.

Postfachrechte vergeben

Der Kontoinhaber oder ein Administrator mit den erforderlichen Rechten zur Account-Verwaltung richtet den Zugriff in i-Planner ein:

1. Öffne Organisation → Accounts und wähle das verbundene E-Mail-Konto.
2. Wähle unter Freischaltung → Nutzbar für den passenden Zugriffsumfang: Inhaber, Team, Organisation oder ausgewählte Mitarbeiter/Gruppen. Bei einer individuellen Freigabe wählst du die gewünschten Personen oder Gruppen unter Ausgewählte Mitarbeiter aus.
3. Prüfe die Versand- und Empfangsrichtung des Kontos. Lesen setzt erlaubten Empfang voraus, Senden einen erlaubten Versand. Ein Konto, das nur zum Empfang eingerichtet ist, kann auch über MCP nicht senden.
4. Prüfe, ob die Postfachverbindung aktiv und nutzbar ist. Verbinde oder validiere das Konto erneut in i-Planner, wenn die Verbindung zum Anbieter Aufmerksamkeit benötigt.
5. Bitte den Assistenten, die verfügbaren Postfächer aufzulisten. email_accounts_list liefert die wirksamen Rechte canRead, canSend, canModify und canUseSignatures sowie die Verfügbarkeit.

Rechte zur Account-Verwaltung und Rechte zur Nutzung eines Postfachs sind getrennt. Eine Postfachfreigabe erlaubt nicht automatisch, dessen Zugangsdaten oder Freigaben zu ändern. Eine erfolgreiche OAuth-Anmeldung hebt Postfachbeschränkungen nicht auf.

Verfügbare Tools

email_accounts_list

Listet die für den angemeldeten Benutzer verfügbaren Postfächer mit Referenzen, wirksamen Rechten und Verfügbarkeit auf. Die zurückgegebenen Referenzen werden für die weiteren Postfach-Tools verwendet. Eine leere Liste bedeutet nicht, dass die gesamte Organisation keine Postfächer hat; möglicherweise ist für diesen Benutzer keines verfügbar.

E-Mails und Ordner lesen

• email_mailbox_get liefert Postfachdetails und Ordner.
• email_messages_list sucht und blättert durch Nachrichten. Unterstützte Suchfelder sind Absender (from), Betreff (subject) und Datumsgrenzen (since, before). Die Suche bezieht sich auf das gewählte Postfach und den gewählten Ordner.
• email_message_get liefert Inhalt und Anhangmetadaten einer einzelnen Nachricht anhand ihrer Nachrichtenreferenz.

Ein Assistent kann die zurückgegebenen Inhalte zusammenfassen. Nachrichtentexte können gekürzt sein; dies wird im Ergebnis ausgewiesen. Nachrichtendetails enthalten Anhangreferenzen, Dateinamen, Inhaltstypen und eine Größenangabe. Diese E-Mail-Tools laden oder analysieren keine Anhanginhalte und senden keine E-Mails.

Entwürfe bearbeiten und E-Mails organisieren

• email_draft_get liest einen einfachen Entwurf einschließlich seiner Revision.
• email_draft_create legt einen einfachen Entwurf an, ohne ihn zu senden.
• email_draft_update aktualisiert einen einfachen Entwurf mit dessen aktueller Revision.
• email_message_mark_read markiert eine Nachricht als gelesen.
• email_message_mark_unread markiert eine Nachricht als ungelesen.
• email_message_archive verschiebt eine Nachricht in den Archivordner.
• email_message_move verschiebt eine Nachricht in einen vorhandenen Ordner desselben Postfachs.

Zum Aktualisieren eines Entwurfs wird dessen aktuelle Revision benötigt. Dabei entsteht eine neue Nachricht; die vorherige Version wird in den Papierkorb verschoben. Verwende anschließend die neue Nachrichtenreferenz aus dem Ergebnis. Entwürfe mit Anhängen oder Antwortbezug können nicht bearbeitet werden. Diese Tools benötigen die Freigabe E-Mails bearbeiten, senden keine Nachrichten und löschen sie nicht endgültig. Ein Ergebnis mit partial bedeutet, dass nicht alle Änderungen abgeschlossen wurden; prüfe das Ergebnis vor weiteren Aktionen.

email_send

Stellt eine E-Mail aus einem freigegebenen, sendefähigen Postfach in die Versandwarteschlange. Benötigt werden Empfänger, Betreff und Text- oder HTML-Inhalt. Prüfe Absender, sämtliche Empfänger, Betreff und Inhalt, bevor du einen Versand beauftragst. Wenn ein Assistent keine E-Mails senden soll, lasse die Versandfunktion deaktiviert.

Der Ablauf ist zweistufig: prepare liefert die endgültige Vorschau einschließlich Signatur und einen befristeten Bestätigungstoken. Erst nach ausdrücklicher Nutzerfreigabe darf confirm mit demselben idempotencyKey und Token den Versand auslösen. Änderungen benötigen eine neue Vorschau und Bestätigung.

Ein erfolgreiches Ergebnis bedeutet queued – in die Versandwarteschlange aufgenommen, nicht zugestellt. Eine Wiederholung mit demselben Versandschlüssel erzeugt keinen zweiten Versandauftrag. Ist der Versandstatus unklar, bleibt eine Wiederholung gesperrt; prüfe das Postfach oder wende dich an den Support. Verwende dann keinen neuen Schlüssel, um die Sperre zu umgehen. Das aktuelle MCP-Versandtool nimmt keine Anhänge entgegen.

Ohne ausdrückliche Signaturauswahl gilt die Postfacheinstellung. Die ausdrückliche Auswahl der Standardsignatur, keiner Signatur oder einer bestimmten Signatur erfordert zusätzlich das Recht zur Signaturnutzung. Der Server hängt die ausgewählte Signatur an; füge sie nicht zusätzlich in den Nachrichtentext ein.

email_signatures_list

Listet die für Benutzer und gewähltes sendefähiges Postfach verfügbaren Signaturen mit eindeutigen IDs, Namen und Standardsignatur-Kennzeichnung auf. Namen können mehrfach vorkommen; für eine ausdrückliche Auswahl wird die zurückgegebene ID verwendet. Eine leere Liste bedeutet, dass für diesen Zugriff keine Signatur verfügbar ist. Dieses Tool verändert keine Signaturen.

Signaturen verwalten

• email_signatures_catalog_list listet sichtbare native Signaturen mit Bearbeitungsrechten und Seitenaufteilung.
• email_signature_get liest eine sichtbare Signatur einschließlich HTML und Revision.
• email_signature_create erstellt eine private Signatur für den angemeldeten Benutzer.
• email_signature_update aktualisiert eine bearbeitbare Signatur mit deren aktueller Revision.
• email_signature_delete löscht eine bearbeitbare Signatur mit deren aktueller Revision wiederherstellbar.

Diese fünf Tools benötigen Signaturen verwalten. Das Anlegen oder Ändern einer Standardsignatur beeinflusst künftige Nachrichten. Solange eine Signatur einem Postfach zugeordnet ist, ist das Löschen gesperrt. Die Tools ändern weder Inhaber noch Freigaben und senden keine E-Mails.

Personenbezogene Daten und Zugriffsgrenzen

Postfachinhalte können personenbezogene Kundendaten einschließlich Gesundheitsinformationen enthalten. Beim Lesen einer Nachricht können diese Inhalte der verbundenen KI-Anwendung zugänglich werden. Gib nur die Funktionen und Postfächer frei, die für die jeweilige Arbeit erforderlich sind. Verwende zum Testen fiktive Daten.

Der Zugriff auf i-Planner wird durch Organisationseinstellungen, die aktuelle Benutzerrolle, die OAuth-Freigabe sowie Postfach- und Signaturrechte begrenzt. Die Tools gewähren keinen uneingeschränkten Organisationszugriff. Zugangsdaten werden serverseitig verarbeitet; füge niemals Postfachpasswörter oder Zugriffstoken in einen Chat ein.

Für die Verarbeitung von Gesprächsinhalten durch den verbundenen KI-Anbieter gelten dessen Bedingungen, Datenschutzhinweise und Kontoeinstellungen. Hinweise zu i-Planner findest du in unserer Datenschutzerklärung↗.

Zum Widerrufen einer Verbindung öffnest du Account → Verbundene Apps und trennst die App. Administratoren können außerdem die entsprechenden Organisations- oder Rollenrechte entziehen.

Häufige Fehler und Lösungen

Bei Fragen erreichst du uns unter support@i-planner.de. Nenne die KI-Anwendung, den ungefähren Zeitpunkt und den angezeigten Fehler. Sende keine Passwörter, Token oder unnötigen Kundendaten mit.