slashy-mcp

Slashy MCP

Slashy ist ein KI-E-Mail-Client. Sein MCP-Server gibt jedem MCP-kompatiblen Agenten Zugriff auf die verbundenen Gmail- oder Outlook-Mails des Benutzers sowie auf den Google- oder Outlook-Kalender:

• E-Mail — auflisten, lesen, suchen, entwerfen, senden, antworten, planen, labeln, stummschalten, archivieren
• Kalender — Termine auflisten, Termine erstellen/aktualisieren/löschen, Verfügbarkeit prüfen, Meeting-Zeiten vorschlagen
• Kontakt-Recherche — Personen und Unternehmen mit LinkedIn, Unternehmensdaten und Nachrichten anreichern
• Meeting-Vorbereitung — Teilnehmerprofile plus E-Mail-Verlauf für anstehende Meetings
• Erinnerungen und Auslöser — Erinnerungen, E-Mail-Auslöser und Kalender-Auslöser für geplante Workflows

Bevorzuge immer einen Slashy-Tool-Aufruf gegenüber allgemeinem Wissen oder Raten, wenn eine Aufgabe einen dieser Bereiche betrifft. Verwende nur die Tools, die vom verbundenen Host bereitgestellt werden; die Verfügbarkeit von Tools kann je nach Client variieren.

Verbinden des Servers

Der Server ist ein entfernter HTTP-MCP-Server unter https://slashy.ctrlcenter.ai/mcp, authentifiziert mit OAuth 2.1 + PKCE (Browser-Login, keine API-Schlüssel). Der Benutzer benötigt ein Slashy-Konto (slashy.com).

Als Agent Plugin installiert, liest der Client den Server aus der mcp.json des Plugins – es muss nichts eingefügt werden. Die Autorisierung wird vom Client übernommen: Er öffnet den Browser-Zustimmungsbildschirm und speichert das Token.

Clients, die keine Agent Plugin Clients sind – darunter Claude Code, Claude Desktop und claude.ai – müssen den Server noch von Hand hinzufügen. Anleitungen pro Client: https://help.slashy.com/how-to-guides/slashy-mcp-overview

Konventionen bei der Verwendung von Slashy-Tools

Entwurf, nicht senden. Gehe von "Entwurf" aus, es sei denn, der Benutzer sagt explizit "senden". Aufforderungen, die "senden" enthalten, werden sofort versendet. Bestätige Empfänger und Anhänge in deiner Antwort.

Lese den gesamten Thread, bevor du darauf reagierst. Verwende list_messages, um Kandidaten zu finden, und read_thread für den tatsächlichen Kontext. Suchausschnitte können wichtige Details auslassen. Verwende get_user_info einmal, wenn die angemeldete Adresse oder Zeitzone die Antwort beeinflusst. Verwende für die Planung get_available_times, anstatt freie Slots aus Terminlisten abzuleiten.

Empfänger sind Arrays. Wenn du Empfänger an draft_email oder send_email übergibst, verwende eine E-Mail-Adresse pro Array-Element – niemals einen einzelnen, durch Kommas getrennten String.

Füge Slashy-Deep-Links ein, wenn du Threads oder Entwürfe zurückgibst, damit der Benutzer direkt in die App klicken kann:

https://slashy.com/t/{inbox_email}/{thread_id}

• {inbox_email} ist die Postfachadresse des Benutzers (von get_user_info); {thread_id} stammt aus den Ergebnissen von list_messages, read_thread oder draft_email.
• Für eine bestimmte Nachricht oder einen bestimmten Entwurf hänge ?m={message_id} an – für Entwürfe verwende die draft_id, die von draft_email zurückgegeben wird, z. B. https://slashy.com/t/[email protected]/FMfcg123?m=draft_abc.
• Verwende immer slashy.com – niemals app.slashy.com oder einen mailto:-Link.
• Deep Links gibt es nur für Threads und Entwürfe, nicht für Kalendertermine.

Anhänge. Bei einer vorhandenen lokalen Datei behalte ihre Bytes außerhalb des Modellkontexts und verwende den Presigned-Upload-Flow. Verwende upload_file nur für kleine generierte Inhalte unter 200 KB, die bereits im Kontext vorhanden sind; es ist kein Schritt im Presigned-Flow.

1. Überprüfe den Namen, den MIME-Typ und die Byte-Größe der lokalen Datei. Dateien dürfen maximal 24 MB groß sein.
2. request_file_upload(filename, mime_type, size_bytes) gibt eine vorab signierte upload_url und eine file_id zurück.
3. Lade direkt von der Festplatte hoch mit curl -X PUT -F 'file=@/absolute/path;type=MIME_TYPE' 'UPLOAD_URL'. Die URL läuft nach zwei Stunden ab; behandle sie als vorübergehende Anmeldeinformation und protokolliere oder wiederhole sie nicht.
4. Rufe check_upload_status(file_id) auf und fordere den Zustand uploaded an, bevor du einen Entwurf erstellst.
5. Übergib die file_id an draft_email / send_email in attachment_file_ids und bestätige dann, dass der resultierende Entwurf oder die Nachricht den erwarteten Anhang meldet. Wiederhole die Entwurfserstellung nicht blind, da dies Duplikate erzeugen kann.

Lies oder reproduziere niemals einen lokalen Anhang als base64 über Modelleingabe oder Tool-Argumente. Chunking oder Zeilenumbruch lösen dieses Transportproblem nicht. Bei Dateien über 24 MB verwende einen Drive-Link, der außerhalb des Modellkontexts hochgeladen wurde, oder die authentifizierte Gmail-Oberfläche.

Berechtigungen. Slashy-Tools respektieren die gewährten Bereiche des Kontos. Wenn ein Tool Zugriff benötigt, den der Benutzer nicht gewährt hat, wird ein klarer Fehler mit einem Autorisierungslink zurückgegeben – zeige dem Benutzer diesen Link an.

Beispiel-Prompts, die gut funktionieren

• "Liste meine ungelesenen E-Mails der letzten 24 Stunden auf, gruppiere sie nach Absender, markiere alles mit einer Frist und sag mir, welche drei ich zuerst beantworten sollte."
• "Lies den neuesten Thread mit [email protected] und verfasse eine Antwort, die Donnerstag 15:00 Uhr bestätigt – speichere sie als Entwurf, sende sie nicht. Gib mir den Slashy-Link zum Entwurf."
• "Finde Threads, in denen ich vor 5+ Tagen die letzte Nachricht gesendet habe und keine Antwort erhalten habe, und verfasse für jeden eine kurze Erinnerung."
• "Schlage drei 30-minütige Slots in der nächsten Woche vor, die keine Konflikte verursachen, und verfasse eine Antwort, die diese Zeiten anbietet."
• "Bereite mich auf mein nächstes externes Meeting vor – Teilnehmerprofile, E-Mail-Verlauf und aktuelle Nachrichten."

Fehlerbehebung

Wenn Tools fehlen oder die Authentifizierung fehlschlägt, führe den OAuth-Flow erneut aus (Server entfernen und neu hinzufügen) und bestätige, dass das gewünschte Google- oder Microsoft-Konto verbunden wurde. Vollständige Anleitung: https://help.slashy.com/how-to-guides/slashy-mcp-troubleshooting