Freshsales in Claude, ChatGPT und jedem MCP-Client. Für Ihr ganzes Team.
Kontakte, Accounts, Deals, Aufgaben, Termine (Freshworks). Ein Token in Loopthink, ein Login pro Person, Rollen pro Tool und ein Audit-Eintrag für jeden Aufruf.
Kostenlos für 2 Connectors, ohne Karte · Pro 19 € · in der EU betrieben · 22 Lese-Tools
“Welche Deals in „Open Deals“ schließen diesen Monat mit einem Wert über 20.000?”
Drei Deals sollen im Oktober abgeschlossen werden:
| Deal | Account | Wert | Abschluss |
|---|---|---|---|
| ERP-Integration | Huber AG | 64.000 € | 28.10.2026 |
| Team-Lizenzen 2027 | Nordwind Handel | 31.500 € | 30.10.2026 |
| Onboarding-Paket | Kraus & Partner | 22.800 € | 23.10.2026 |
- nur lesend
- protokolliert
Ein Token rein, die Tools kommen raus.
In Freshsales liegt die Pipeline eines Vertriebsteams: Kontakte und die Accounts, zu denen sie gehören, Deals in Pipelines mit Phasen und Wahrscheinlichkeiten, Aufgaben und Termine pro Vertriebsmitarbeiter und die Aktivitätshistorie jedes Kontakts. Die Fragen kommen vor jedem Anruf und jedem Forecast, „welche Deals schließen diesen Monat“, „wann haben wir zuletzt mit der Huber AG gesprochen“, aber heute heißt das: Login, eine gespeicherte Ansicht und 25 Zeilen auf einmal scrollen.
Mit dem Freshsales-Connector fragen Vertrieb, Sales Operations und Geschäftsführung in Claude oder ChatGPT und bekommen die Antwort aus dem laufenden CRM. Loopthink hält einen Freshsales-API-Key, jede Person meldet sich mit ihrer eigenen Identität an, und jeder Aufruf wird unter ihrem Namen protokolliert. Der Key erreicht den KI-Client nie.
Der Connector ist nur lesend: 22 Tools für Suche und Lookup, Kontakte, Accounts und Deals mit ihren gespeicherten Ansichten, Kontaktaktivitäten, Aufgaben und Termine, Owner, Pipelines, Phasen und die Felddefinitionen hinter den Custom Fields. Nichts darin kann einen Datensatz anlegen oder ändern.
- Vertrieb
“Welche Deals in der Ansicht „Open Deals“ haben ein erwartetes Abschlussdatum in diesem Monat und einen Wert über 20.000?”
Beantwortet von
list_deals - Vertrieb
“Was war die letzte Aktivität mit der Huber AG: E-Mails, Anrufe, Notizen?”
Beantwortet von
list_contact_activities - Sales Operations
“Finde den Kontakt mit der E-Mail anna.meier@huber-ag.de und zeig den Account und die offenen Deals.”
Beantwortet von
lookup - Geschäftsführung
“Welche Phasen hat die Enterprise-Pipeline, mit ihren Wahrscheinlichkeiten?”
Beantwortet von
list_pipeline_stages - Vertrieb
“Welche meiner Termine sind für nächste Woche geplant?”
Beantwortet von
list_appointments - Sales Operations
“Welche Werte erlaubt das Custom Field cf_region bei Deals?”
Beantwortet von
list_deal_fields
Was der Freshsales-Connector kann.
| Tool | Was es tut | Zugriff | Standard |
|---|---|---|---|
| search | Full-text search across Freshsales records by name or other text. Use first when the user names a contact, account or deal to get its ID. | Lesen | An |
| lookup | Exact lookup of records by a field value, e.g. find a contact by email address. | Lesen | An |
| list_contact_views | Lists saved contact views (filters) with their IDs, e.g. 'All Contacts', 'My Contacts'. | Lesen | An |
| list_contacts | Lists contacts in a saved view. 25 per page; use page for more. | Lesen | An |
| get_contact | Returns one contact. Use include to embed related data in one call. | Lesen | An |
| list_contact_activities | Returns the activity timeline of a contact (emails, calls, notes, updates). | Lesen | An |
| list_account_views | Lists saved account (sales_account) views with their IDs. Call first to get a view_id for list_accounts. | Lesen | An |
| list_accounts | Lists accounts (companies) in a saved view. 25 per page; use page for more. | Lesen | An |
| get_account | Returns one account. Use include to embed contacts, deals, tasks etc. | Lesen | An |
| list_deal_views | Lists saved deal views with their IDs, e.g. 'Open Deals', 'My Deals'. | Lesen | An |
| list_deals | Lists deals in a saved view. 25 per page; use page for more. | Lesen | An |
| get_deal | Returns one deal with amount, stage, pipeline, expected close and custom fields. | Lesen | An |
| list_tasks | Lists tasks of the token's user. filter is required. | Lesen | An |
| get_task | Returns one task by ID. | Lesen | An |
| list_appointments | Lists appointments (meetings) of the token's user. filter is required. | Lesen | An |
| get_appointment | Returns one appointment by ID. | Lesen | An |
| list_owners | Lists users who can own records (id, display_name, email). Use to resolve owner_id values. | Lesen | An |
| list_deal_pipelines | Lists deal pipelines (id, name). Use with list_pipeline_stages. | Lesen | An |
| list_pipeline_stages | Lists the deal stages of one pipeline (id, name, position, probability). | Lesen | An |
| list_deal_stages | Lists all deal stages across pipelines (id, name). Use to map deal_stage_id on deals. | Lesen | An |
| list_deal_fields | Lists deal field definitions including custom fields (cf_*) and choice values. Use to interpret custom_field keys. | Lesen | An |
| list_contact_fields | Lists contact field definitions including custom fields (cf_*) and choice values. | Lesen | An |
Schreib-Tools sind für jede Rolle aus, bis Sie sie einschalten, ein Tool für eine Rolle. Die Namen und Beschreibungen sind das, was das Modell sieht, deshalb bleiben sie englisch; es bekommt außerdem die vollständige Parameterbeschreibung jedes Tools.
So kommen Sie an den Freshsales-Token.
Fünf Minuten, einmalig. Niemand in Ihrem Team sieht ihn je.
- 1
Bei Freshsales als der Benutzer anmelden, in dessen Namen Loopthink handeln soll.
- 2
Auf das Profilbild klicken > Profile Settings > Tab API Settings.
- 3
„Your API key“ kopieren (der Bundle-Alias für die Verbindung steht darunter).
- 4
Nur den Key in Loopthink einfügen; Loopthink sendet ihn als „Token token=<key>“.
- 5
In Loopthink fügen Sie Freshsales aus dem Katalog hinzu und fügen den Token ein. Außerdem fragt der Connector nach freshworks bundle alias. Eine Minute später sieht Ihr Team die Tools.
Der API-Key hat keine Scopes und handelt mit den vollen Berechtigungen seines Benutzers (Rolle, Gebiet, Sichtbarkeit von Datensätzen). Aufgabenlisten liefern nur Aufgaben dieses Benutzers. Nutzen Sie einen eigenen Benutzer mit einer auf Lesen ausgerichteten Rolle.
Was wir in Freshsales zu maskieren empfehlen.
Ein CRM ist eine Liste von Personen: E-Mail-Adressen, Mobil- und Büronummern, Vor- und Nachnamen, Anzeigenamen, Postadressen, LinkedIn-, Facebook- und Twitter-Handles, Freitextbeschreibungen. Die vorgeschlagenen Felder maskieren diese und behalten Account-Namen, Deal-Beträge, Phasen, erwartete Abschlussdaten und Aktivitätszeitstempel, also das, was eine Forecast- oder Vorbereitungsfrage braucht. Die Geschäftsführung sieht 340.000 Euro erwarteten Abschluss im November ohne eine einzige Mobilnummer in der Antwort.
- emails
- mobile_number
- work_number
- phone
- first_name
- last_name
- display_name
- address
- city
- zipcode
- description
Freshsales und Loopthink
- Wessen Berechtigungen trägt der Key?
- Der API-Key hat keine Scopes und handelt mit den vollen Berechtigungen seines Benutzers: Rolle, Gebiet und Sichtbarkeit von Datensätzen. Legen Sie einen eigenen Benutzer mit einer auf Lesen ausgerichteten Rolle an und nutzen Sie dessen Key; was dieser Benutzer nicht sehen kann, kann auch die KI nicht sehen.
- Warum sieht die KI nur manche Aufgaben und Termine?
- list_tasks und list_appointments liefern nur die Aufgaben und Termine des Token-Benutzers, und beide brauchen einen Filter. Wenn der Kalender des Teams sichtbar sein soll, muss der eigene Benutzer diese Datensätze besitzen oder ihnen zugewiesen sein.
- Was ist der Bundle-Alias?
- Der Teil vor .myfreshworks.com in Ihrer Freshsales-URL, angezeigt unter Profile Settings > API Settings unterhalb des Keys. Geben Sie nur den Key selbst ein; Loopthink sendet ihn bei jedem Aufruf als „Token token=<key>“.
- Braucht jedes Teammitglied einen eigenen Freshsales-Account?
- Nein. Loopthink hält einen Schlüssel oder Token für Freshsales. Ihre Leute melden sich mit ihrer eigenen Identität bei Loopthink an, und jeder Aufruf an Freshsales wird unter ihrem Namen protokolliert. Die Lizenzen in Freshsales bleiben, wie sie heute sind.
- Wo liegt der Freshsales-Schlüssel?
- In Loopthink, verschlüsselt, in der EU. Er erreicht weder den KI-Client noch die Personen, die den Connector nutzen. Rotieren Sie ihn in Freshsales, wann immer Sie wollen, und fügen Sie den neuen einmal ein.
- Kann jemand aus dem Chat heraus in Freshsales schreiben?
- Nur, wenn Sie es einschalten. Schreibaktionen sind eine eigene Zeile in der Rechtematrix und für jede Rolle standardmäßig aus. Braucht eine Rolle ein Schreib-Tool, geben Sie genau dieses eine Tool genau dieser Rolle frei.
- Was sieht das Modell?
- Das Ergebnis des Tool-Aufrufs, nach der Maskierung. Felder, die Sie als personenbezogen markieren, etwa E-Mail-Adressen, Namen oder Kartendaten, werden maskiert, bevor die Antwort zu den KI-Client reist. Das Modell bekommt die Zahlen, nicht die Menschen.
- Was kostet es?
- Kostenlos für eine Person und zwei Connectors, ohne Karte. Pro kostet 19 € im Monat für bis zu fünf Personen und jeden Connector auf dieser Seite, mit Rollen, feldgenauer Maskierung und 30 Tagen Audit-Log. Team kostet 49 € für zehn Personen und bringt Ihre eigenen REST-APIs und SQL-Datenbanken, Ihre eigene Domain und Ihren eigenen Identity Provider dazu. Kein Gespräch nötig.
Hängen Sie fest, oder fehlt ein Tool? Ein Mensch, der diesen Connector kennt, antwortet innerhalb eines Arbeitstags.
