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

Empfohlen

Fü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

Entwickler

Fü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. 1

    Die App ruft den Server ohne Token auf und erhält 401 mit einem Link zu den Sendcorex-Autorisierungsmetadaten.

  2. 2

    Die App registriert sich selbst (Dynamic Client Registration) und öffnet ein Sendcorex-Fenster.

  3. 3

    Sie melden sich bei Bedarf im Dashboard an, wählen die Berechtigungen (oder das Postfach) und klicken auf Authorize.

  4. 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.

BereichLesenFull ergänzt
Domainsdomain:readdomain:create, domain:delete
Absendersender:readsender:create, sender:update, sender:delete
Templatestemplate:readtemplate:create, template:update, template:delete
Kontaktecontact:readcontact:create, contact:update, contact:delete
Logslogs:read—
Bounces & Beschwerdenfeedback:read—
Zählercounters:read—
Tracking-Einstellungenprivacy:readprivacy: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.

Request
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:read sieht 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.
API Keys öffnen

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_unsubscribed

Zugriff 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