Freshsales zu MCP: Kontakte, Accounts, Deals, Aufgaben und Vertriebsaktivitäten in jedem KI-Agent

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Freshsales klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Freshsales

Freshsales (Freshworks CRM) in jedem KI-Agent: Kontakte, Accounts und Deals suchen und filtern, Deals durch die Phasen der Pipeline bewegen, Notizen anlegen, Aufgaben und Termine planen, Vertriebsaktivitäten erfassen und Marketinglisten pflegen. Mit dem persönlichen API-Schlüssel eines Benutzers und der Bundle-URL deines Kontos.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Freshsales-Konto (Freshworks CRM).

1. Klicke in Freshsales auf dein Profilbild, dann auf Profile Settings, und öffne den Tab API Settings.
2. Kopiere Your API key in FRESHSALES_API_KEY. Der Connector sendet ihn als Authorization: Token token=<key>, füge also nur den Schlüssel ein.
3. Kopiere im selben Tab den bundle alias (die Adresse deines Kontos) in FRESHSALES_BUNDLE_URL, zum Beispiel https://acme.myfreshworks.com/crm/sales. Konten, die vor der Freshworks-Suite angelegt wurden, nutzen https://acme.freshsales.io. Lass /api und einen abschließenden Schrägstrich weg.
4. Installiere den Connector und führe freshsales_list_owners aus: Es listet die Benutzer des Portals und bestätigt Schlüssel und Adresse.

Jeder Aufruf läuft mit den Rechten des Benutzers, dessen Schlüssel eingetragen ist: Datensätze außerhalb seines Bereichs bleiben unsichtbar. Nimm den Schlüssel eines Benutzers, der die Daten sieht, die das Team braucht.

Der Einstieg: freshsales_list_owners liefert die Benutzer-IDs für owner_id. freshsales_list_selector liest eine Auswahlliste (Gebiete, Pipelines und Phasen, Währungen, Deal-Typen und -Gründe, Lead-Quellen, Branchen und Unternehmensarten, Kampagnen, Kontaktstatus, Lifecycle-Phasen, Typen und Ergebnisse von Vertriebsaktivitäten) und gibt die IDs zurück, die beim Schreiben gebraucht werden. freshsales_list_pipeline_stages liefert die Phasen einer Pipeline. freshsales_list_fields listet die Felder von Kontakten, Accounts, Deals oder Vertriebsaktivitäten, auch die benutzerdefinierten: Ihre internen Namen beginnen mit cf_ und gehören in custom_field.

Datensätze finden:

• freshsales_search: Textsuche nach Name oder E-Mail über Kontakte, Accounts, Deals und Benutzer. include nimmt die Namen im Singular, contact, sales_account, deal und user; der Plural liefert nichts.
• freshsales_lookup: exakte Übereinstimmung in einem Feld, zum Beispiel Kontakte per E-Mail oder Kontakte, Accounts und Deals per Name oder Wert eines benutzerdefinierten Felds.
• freshsales_filtered_search: Regeln auf Feldern (exakte Werte, Bereiche, Listen), gibt vollständige Datensätze zurück.
• Listen laufen immer über eine gespeicherte Ansicht: freshsales_list_views liefert die View-IDs (etwa "All Contacts" oder "My Deals"), danach lesen freshsales_list_contacts, freshsales_list_accounts oder freshsales_list_deals die Ansicht mit Sortierung.

Kontakte, Accounts und Deals: freshsales_get_contact, freshsales_get_account und freshsales_get_deal lesen einen Datensatz und betten verknüpfte Datensätze über include ein (zum Beispiel sales_accounts,deals,notes). freshsales_list_contact_activities zeigt die Zeitleiste eines Kontakts (E-Mails, Anrufe, Notizen, Feldänderungen, Webbesuche). Zum Schreiben nutzt die KI freshsales_create_contact (mindestens E-Mail oder Nachname), freshsales_update_contact, freshsales_upsert_contact (anlegen oder aktualisieren per E-Mail oder einem anderen eindeutigen Feld), freshsales_create_account (eindeutiger name), freshsales_update_account, freshsales_create_deal (name und amount sind Pflicht) und freshsales_update_deal. Ein Deal wandert weiter, wenn deal_stage_id auf eine Phase seiner Pipeline gesetzt wird; gewonnen und verloren sind ebenfalls Phasen, und ein verlorener Deal kann eine deal_reason_id tragen. Updates ändern nur die übergebenen Felder.

Notizen, Aufgaben, Termine und Aktivitäten hängen über targetable_type (Contact, SalesAccount oder Deal) und targetable_id an einem Datensatz:

• Notizen: freshsales_create_note, freshsales_update_note.
• Aufgaben: freshsales_list_tasks (ein Filter pro Aufruf: open, due_today, due_tomorrow, overdue oder completed), freshsales_get_task, freshsales_create_task, freshsales_update_task, freshsales_complete_task.
• Termine: freshsales_list_appointments (open für kommende, past für vergangene; ältere Portale nutzen upcoming), freshsales_get_appointment, freshsales_create_appointment, freshsales_update_appointment. Teilnehmer sind Benutzer (FdMultitenant::User) oder Kontakte (Contact).
• Vertriebsaktivitäten wie protokollierte Anrufe und Besuche: freshsales_list_sales_activities, freshsales_get_sales_activity, freshsales_create_sales_activity.

Marketinglisten: freshsales_list_marketing_lists, freshsales_list_marketing_list_contacts, freshsales_add_contacts_to_list und freshsales_remove_contacts_from_list (die Kontakte selbst bleiben erhalten).

Leads: Aktuelle Freshsales-Konten führen Interessenten als Kontakte mit einer Lifecycle-Phase; ein eigenes Leads-Modul gibt es nicht. Die KI filtert Kontakte über eine Ansicht oder freshsales_filtered_search nach Lifecycle-Phase.

Bei der Installation ausgeschaltet: nichts. Der Connector hat keine Lösch-Tools und kann daher keine Kontakte, Accounts, Deals, Notizen, Aufgaben oder Termine entfernen. Anlegen und Ändern wirkt direkt in deinem CRM, lass dir die Felder also vor dem Speichern zeigen.

Datenformate: Zeitstempel kommen in UTC oder mit Offset zurück (2026-02-13T23:27:49Z). Datumseingaben akzeptieren YYYY-MM-DD oder ISO 8601; ohne Zone gilt UTC. Beträge stehen in der Währung des Deals; base_currency_amount ist in die Portalwährung umgerechnet. Leere Felder sind null. Über include eingebettete Datensätze kommen in eigenen Arrays auf oberster Ebene (users, sales_accounts, deals) neben dem Datensatz, verknüpft über die ID.

Seitenweise Abfrage: Listen nehmen page (ab 1) und per_page (Standard 25, höchstens 100) und liefern meta.total_pages und meta.total. freshsales_search gibt standardmäßig 10 Treffer zurück, höchstens 100.

Limits und häufige Fehler: 1000 Anfragen pro Stunde und Konto; darüber antwortet Freshsales mit 429. 401 heißt falscher oder fehlender Schlüssel, 403, dass dem Benutzer das Recht fehlt oder die Funktion nicht im Tarif ist, 404 eine falsche ID oder eine falsche Bundle-URL. Validierungsfehler kommen als 400 mit errors.message.

Der Connector löscht keine Datensätze, versendet keine E-Mails und ändert keine Portaleinstellungen, Felder oder Pipelines.

Voraussetzungen: FRESHSALES_BUNDLE_URL, FRESHSALES_API_KEY

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Freshsales und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Finde den Kontakt [email protected] und zeig mir ihre offenen Deals und die letzten Notizen dazu.“
• „Liste meine offenen Deals, die diesen Monat abschließen sollen, mit Betrag und Phase.“
• „Schieb den Deal Acme Verlängerung in die Phase Verhandlung und leg eine Notiz an, dass das Angebot raus ist.“
• „Welche meiner Aufgaben sind überfällig? Gruppiere sie nach verknüpftem Account.“
• „Erfasse für heute einen 30-minütigen Anruf mit Tom Becker und leg eine Folgeaufgabe für nächsten Dienstag um 10:00 an.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden