KI-Apps (MCP)
Authentifizierung
Melden Sie sich per OAuth an und wählen Sie die Berechtigungen, oder nutzen Sie einen API key. In beiden Fällen erhält die App nur, was Sie erlauben, und Sie können es jederzeit zurücknehmen.
- OAuth 2.1 + PKCE
- Zugriff 1 Stunde, von der App erneuert
- Widerruf unter Connected apps
Was Sie nutzen sollten
OAuth
EmpfohlenFür Claude (claude.ai und Desktop) und jeden Client, der es unterstützt. Sie melden sich an, wählen die Berechtigungen und klicken auf Authorize. Kein Key zum Kopieren oder Speichern.
API key
EntwicklerFür Claude Code, Cursor, VS Code und Skripte. Senden Sie den Key als Authorization: Bearer. Die Scopes des Keys bestimmen, welche Tools erscheinen.
OAuth
Ihre App erledigt das alles selbst. Sie sehen nur das Sendcorex-Fenster.
- 1
Die App ruft den Server ohne Token auf und erhält 401 mit einem Link zu den Sendcorex-Autorisierungsmetadaten.
- 2
Die App registriert sich selbst (Dynamic Client Registration) und öffnet ein Sendcorex-Fenster.
- 3
Sie melden sich bei Bedarf im Dashboard an, wählen die Berechtigungen (oder das Postfach) und klicken auf Authorize.
- 4
Die App erhält ein Access Token (1 Stunde) und ein Refresh Token (30 Tage, bei jeder Nutzung erneuert) und beginnt, Tools aufzurufen.
Mitglieder einer Organisation können nur die Berechtigungen vergeben, die sie selbst haben.
Berechtigungen
Auf dem Authorize-Bildschirm ist jeder Bereich No access, Read oder Full. Dieselben Scopes gelten für API keys. Konto-, Abrechnungs-, Team- und API-Key-Verwaltung stehen KI-Apps nie zur Verfügung.
| Bereich | Lesen | Full ergänzt |
|---|---|---|
| Domains | domain:read | domain:create, domain:delete |
| Absender | sender:read | sender:create, sender:update, sender:delete |
| Templates | template:read | template:create, template:update, template:delete |
| Kontakte | contact:read | contact:create, contact:update, contact:delete |
| Logs | logs:read | — |
| Bounces & Beschwerden | feedback:read | — |
| Zähler | counters:read | — |
| Tracking-Einstellungen | privacy:read | privacy:write |
| E-Mail-Validierung | — | tools:validate |
| E-Mail-Versand | — | email:send |
API key
Erstellen Sie im Dashboard einen Key mit nur den Scopes, die die App braucht, und senden Sie ihn bei jedem Request mit.
POST https://g.sendcorex.com/mcp/account
Authorization: Bearer SENDCOREX_API_KEY
Content-Type: application/json- Die Tool-Liste folgt dem Key. Ein Key mit nur
logs:readsieht nur die Log-Tools. - Erlaubte IPs gelten weiterhin. Cloud-Apps rufen von ihren eigenen Servern aus auf, ein auf Ihre IPs beschränkter Key wird dort also abgelehnt. Nutzen Sie für diese OAuth.
Postfachzugriff
Der Postfach-Server arbeitet mit jeweils einem Postfach. Mit OAuth wählen Sie das Postfach auf dem Authorize-Bildschirm (die Suche hilft bei vielen Postfächern). Aus Code können Sie auch das Postfach-Token der Receive-Emails-API verwenden. Allgemeine API keys öffnen nie ein Postfach.
Nur-Lese-Zugriff
Beim Verbinden eines Postfachs wählen Sie Vollzugriff oder Nur lesen. Nur lesen ist für Apps voreingestellt und die sicherste Wahl für KI-Assistenten, die Ihre E-Mails nur lesen müssen.
Ein als Nur lesen erstelltes Token oder eine als Nur lesen autorisierte App kann das Postfach nur lesen.
Jeder schreibende Befehl antwortet mit READ_ONLY_ACCESS (HTTP 403 beim Hochladen von Anhängen).
Im MCP werden die schreibenden Tools nicht angezeigt: Die App sieht nur die Tools, die sie nutzen darf.
Erlaubte Befehle
whoamilist_foldersget_counterslist_threadsget_threadlist_messagesget_messagessearchget_attachmentget_raw_sourcelist_draftsget_draftget_trackinglist_activityactivity_countslist_contactscount_contactsget_mailbox_contactlist_segmentsget_audiencecheck_recipientsget_delivery_statusget_contact_eventsget_trustlist_trustlist_junkblocked_junk_countlist_top_sendersget_filter_modelist_signaturesget_conversationlist_assigneeslist_conversationslist_conversation_noteslist_rulesget_rulerule_optionstest_rulelist_templatesget_templatelist_labelsget_contactlist_followupsget_unsubscribe_optionslist_unsubscribedZugriff widerrufen
Connected apps im Dashboard listet jede App auf, die Sie autorisiert haben, worauf sie zugreifen kann und wann sie zuletzt genutzt wurde. Nach dem Widerruf verliert die App innerhalb einer Minute den Zugriff. Um sie wieder zu nutzen, verbinden und autorisieren Sie sie erneut.
Connected apps öffnen