Docs/ Platform & apps

API, MCP und Webhooks

Verbinden Sie KI-Agenten über MCP, rufen Sie die REST-API mit eingeschränkten Schlüsseln auf und empfangen Sie signierte Webhooks.

Unter Einstellungen > Entwickler verbinden Sie KI-Agenten wie Claude oder ChatGPT mit Ihrem Posteingang, erstellen API-Schlüssel für eigene Integrationen und richten Webhooks ein. Was Ihr Tarif enthält, zeigt die Seite an.

Einen KI-Agenten verbinden (MCP)

AI Emaily betreibt einen Model-Context-Protocol-Server unter https://mcp.aiemaily.com. Fügen Sie ihn in Ihrem KI-Client als Connector hinzu: Er öffnet die Anmeldung von AI Emaily, wo Sie die gewünschten Berechtigungen erteilen. Einstellungen > Entwickler enthält Schritt-für-Schritt-Anleitungen für Claude, ChatGPT, Claude Code und Cursor.

Verbundene Agenten listet jede verbundene App mit dem Zeitpunkt der Verbindung auf. Zugriff widerrufen wirkt sofort.

Senden über MCP läuft immer zuerst als Entwurf, dann folgt ein ausdrückliches Senden. Die vollständige Werkzeugliste und die Einrichtungsanleitungen stehen auf der MCP-Seite.

API-Schlüssel

  1. 1

    Einen Schlüssel erstellen

    Wählen Sie unter Einstellungen > Entwickler Schlüssel erstellen, geben Sie ihm einen Namen und haken Sie nur die Berechtigungen an, die er braucht. Berechtigungen lassen sich später nicht erweitern.

  2. 2

    Einmal kopieren

    Der vollständige Schlüssel wird nur einmal angezeigt. Bewahren Sie ihn in einem Secrets-Manager auf; verlieren Sie ihn, erstellen Sie einen neuen.

  3. 3

    Die API aufrufen

    Senden Sie den Schlüssel als Bearer-Token an https://api.aiemaily.com/v1. Die API-Referenz dokumentiert jeden Endpunkt.

  4. 4

    Am Ende widerrufen

    Wählen Sie Schlüssel widerrufen. Widerrufene Schlüssel funktionieren sofort nicht mehr.

BerechtigungsgruppeBerechtigungen
E-Mailmail:read, mail:write, mail:send, drafts:read, drafts:write
Suche und Kontaktesearch:read, contacts:read, contacts:write
KI und Agentenai:invoke, agent:read, brief:read
Daten und Kontextcontext:read, context:write, calendar:read, calendar:write
Plattformwebhooks:manage, usage:read

Ratenlimits

Anfragen sind auf 120 pro Minute pro API-Schlüssel und 300 pro Minute pro Konto begrenzt. Ihr Tarif legt außerdem eine tägliche Zahl an API-Anfragen und API-Sendungen fest, angezeigt unter Ratenlimits in Einstellungen > Entwickler. Bei Überschreitung kommt HTTP 429 mit einem Retry-After-Header zurück.

Lesezugriffe und Schreibzugriffe ohne KI verbrauchen keine Credits. KI-Aktionen über die API verbrauchen Credits wie dieselben Aktionen in der App.

Webhooks

Webhooks senden einen HTTPS-POST an Ihren Endpunkt, wenn etwas passiert. Wählen Sie Endpunkt hinzufügen, geben Sie die HTTPS-URL ein und wählen Sie Ereignisse: message.received, thread.updated, send.completed, send.failed, draft.created, agent.action und brief.ready.

Jede Zustellung ist mit HMAC-SHA256 im Header X-Aiemaily-Signature signiert. Das Signaturgeheimnis wird beim Hinzufügen des Endpunkts einmal angezeigt. Geheimnis rotieren gibt Ihnen ein neues, und das alte signiert noch 24 Stunden weiter, damit Sie wechseln können, ohne Zustellungen zu verpassen.

Jeder Endpunkt hat Testen, Bearbeiten, Deaktivieren und Löschen und zeigt die letzten Zustellungen mit Versuchen. Ein Endpunkt, der drei Tage am Stück fehlschlägt, wird automatisch deaktiviert; beheben Sie das Problem und aktivieren Sie ihn wieder. Ihr Tarif legt fest, wie viele Endpunkte Sie hinzufügen können.

Frequently asked

Ready to try it?

Start Free Trial