MCP-Tool-Referenz

Der folgende Katalog basiert auf denselben Definitionen, die MCP-Clients bei der Tool-Erkennung erhalten. Jede Referenzseite ergänzt Voraussetzungen, Prompts, Beispiele, erwartete Antworten und Hinweise zur Fehlerbehebung.

Native Nachrichtenanhänge

linkedin_message akzeptiert optionale attachments. linkedin_invite_then_message akzeptiert follow_up_attachments für die Nachricht nach Annahme. Text bleibt erforderlich. Pro Nachricht sind bis zu 5 Dateien und insgesamt 20.000.000 Bytes erlaubt; jeder Workspace verfügt über 200 MB privaten Speicher. PDF, MP4/MOV, PNG/JPG/GIF/BMP, Office-Dateien und TXT/CSV/RTF werden anhand von Endung, MIME-Typ und Inhalt geprüft. HTML und ausführbare Dateien werden nicht unterstützt. Der Anbieter kann Dateien ablehnen, die das ausgewählte Postfach nicht unterstützt.

Wählen Sie lokale Dateien über die Büroklammer im SalesTouch-Posteingang. Die Anwendung lädt Teile von höchstens 2 MB über den authentifizierten Ablauf /api/linkedin/attachments hoch und schließt den Upload ab. Verwenden Sie die attachment_id in einer Agentennachricht. Clients beginnen mit POST /api/linkedin/attachments und account_id, filename, content_type, size_bytes, senden rohe Teile mit POST /api/linkedin/attachments/{id}, Content-Type: application/octet-stream und Upload-Offset und schließen mit PUT unter derselben URL ab. GET liefert Status und empfangenen Byte-Offset; DELETE entfernt ungenutzte Uploads. Der Server öffnet niemals lokale Pfade des Aufrufers.

Agenten können alternativ content_base64 (kanonisches Base64 ohne Data-URL-Präfix) oder eine öffentliche HTTPS-url mit filename und content_type angeben. URLs verwenden Port 443; private und reservierte Netzwerke, unsichere Weiterleitungen und Downloads über 15 Sekunden werden abgelehnt. Alle Modi speichern private Dateidaten vor der Einreihung. Native Medienvorschauen sind Standard; send_mode: "file" fordert, soweit unterstützt, eine herunterladbare Datei an.

queue und scheduled_for speichern Dateiverweise mit der Aktion. Folgenachrichten nach Annahme behalten Dateien bis zu 90 Tage nach der geplanten Einladung; unvollständige Uploads verfallen nach 24 Stunden und zugestellte Dateien nach 7 Tagen. Ausstehende Nachrichten behalten ihre Dateien bis zur Zustellung. Unklare Ergebnisse behalten Diagnosemetadaten und verhindern automatisches erneutes Senden.

Verwenden Sie bei Wiederholungen dieselbe idempotency_key. Ohne Schlüssel werden identische Empfänger, Texte und Dateien dedupliziert. Ein neuer Schlüssel ist nur für eine bewusst neue Nachricht vorgesehen. Antworten enthalten attachment_delivery_id, Status und Datei-IDs; Folgenachrichten zeigen sie unter follow_up. Der authentifizierte Endpunkt GET /api/linkedin/attachment-deliveries/{id} liefert den Zustellstatus. Bei ATTACHMENT_SEND_UNCERTAIN muss vor erneutem Senden die Unterhaltung geprüft werden. Upload-, Berechtigungs-, Inhalts-, Größen- und URL-Fehler haben eindeutige Codes.

{
  "identifier": "https://www.linkedin.com/in/example",
  "text": "Here is the brochure we discussed.",
  "attachments": [{"filename": "brochure.pdf", "content_type": "application/pdf", "url": "https://example.com/brochure.pdf"}],
  "idempotency_key": "brochure-prospect-2026-10",
  "queue": true
}

E-Mail-Tools

E-Mail-Tools benötigen die E-Mail-Berechtigung deiner MCP-Verbindung und ein verbundenes Postfach.

• email_accounts: Postfächer, Tageskapazität, Warmup und der Verbindungslink, wenn keines senden kann.
• email_send: eine persönliche E-Mail oder eine Antwort. Eine einzelne E-Mail wird sofort gesendet; mehrere werden eingereiht.
• email_conversations: Konversationen mit Leads in all deinen Postfächern, mit needs_reply und Volltextsuche.
• email_messages: ein Verlauf seitenweise, mit vollständigem Nachrichtentext.
• email_threads: alle E-Mail-Verläufe und geplanten Sendungen eines Leads.
• email_attachment: eine an eine E-Mail angehängte Datei mit Download-Link; Text- und CSV-Dateien enthalten ihren Text.

email_send akzeptiert bis zu 5 attachments (insgesamt 15 MB): eine attachment_id aus email_messages, um eine empfangene Datei weiterzuleiten, eine öffentliche HTTPS-url oder content_base64. Empfangene Dateien werden 90 Tage aufbewahrt; bei Dateien über 15 MB bleiben nur Name und Größe erhalten.