SalesTouch Docs

Authentifizierung

Verstehe SalesTouch OAuth, MCP-Berechtigungen, Kontoauswahl und Autorisierungsfehler.

SalesTouch verwendet OAuth 2.1 mit PKCE. MCP-Clients erkennen den Autorisierungsserver automatisch über die Metadaten der geschützten Ressource neben dem Remote-MCP-Endpunkt.

Berechtigungen

BerechtigungZweck
openidIdentifiziert den angemeldeten SalesTouch-Nutzer.
offline_accessErmöglicht dem MCP-Client, den Zugriff ohne wiederholte Anmeldungen zu erneuern.
salestouch:useGewährt Zugriff auf den SalesTouch-MCP-Dienst.
linkedin:accessGewährt die bei der Zustimmung bestätigten LinkedIn-Lese- und Schreibfunktionen.

Jede Tool-Seite nennt die erforderlichen Berechtigungen. SalesTouch prüft sie vor der Ausführung und gibt eine neue OAuth-Aufforderung zurück, wenn eine Berechtigung fehlt.

Kontoauswahl

Die meisten Tools akzeptieren eine optionale account_id. Fehlt sie, wählt SalesTouch ein geeignetes verbundenes Konto und verwendet das bekannte Besitzerkonto eines Leads erneut.

Nutze linkedin_accounts, wenn du Konten prüfen oder ausdrücklich auswählen möchtest. Erfinde niemals eine Konto-ID.

Authentifizierungsablauf

  1. Füge https://www.salestouch.io/api/mcp zum MCP-Client hinzu.
  2. Starte die Anmeldung im Client.
  3. Melde dich im Browser bei SalesTouch an.
  4. Prüfe und bestätige die angeforderten Berechtigungen.
  5. Kehre zum Client zurück und starte eine neue Aufgabe oder Unterhaltung.
  6. Prüfe den Zugriff mit linkedin_accounts.

Autorisierungsfehler

invalid_token oder Autorisierung erforderlich

Der MCP-Eintrag ist vorhanden, aber die OAuth-Sitzung fehlt oder ist abgelaufen. Starte die Anmeldung erneut und lade anschließend die Tool-Liste neu.

insufficient_scope

Das aktuelle Token enthält nicht die für das gewünschte Tool erforderliche Berechtigung. Verbinde das MCP erneut und bestätige die neue Berechtigung.

Die Authentifizierung war erfolgreich, aber der Workspace verfügt derzeit nicht über LinkedIn-MCP-Zugriff. Ändere die SalesTouch-Berechtigung des Workspace und versuche es erneut.

Keine LinkedIn-Konten zurückgegeben

OAuth funktioniert, aber SalesTouch findet kein nutzbares LinkedIn-Konto im Workspace. Verbinde LinkedIn in SalesTouch und rufe linkedin_accounts erneut auf.

Fahre nach erfolgreicher schreibgeschützter Prüfung mit den Arbeitsabläufen fort.