Fehlerbehebung

Das MCP ist installiert, aber keine Tools erscheinen

Starte nach dem Verbinden des Servers eine neue Aufgabe oder Konversation. MCP-Clients laden Tool-Definitionen normalerweise beim Beginn einer Sitzung und nicht fortlaufend in einer bestehenden Sitzung.

Prüfe, ob der konfigurierte Endpoint exakt lautet:

https://www.salestouch.io/api/mcp

Der Client fordert eine erneute Authentifizierung an

Das Zugriffstoken fehlt, ist abgelaufen oder besitzt nicht den erforderlichen Scope. Starte den MCP-Anmeldeablauf erneut, schließe die Zustimmung im Browser ab und erstelle anschließend eine neue Client-Sitzung.

paid_plan_required

Der Benutzer ist authentifiziert, aber der SalesTouch-Workspace hat keinen Zugriff auf das LinkedIn-MCP. Das ist ein Berechtigungsproblem und kein Problem mit dem OAuth-Transport.

Kein verbundenes LinkedIn-Konto

Verbinde LinkedIn in SalesTouch und prüfe es mit linkedin_accounts. Übergib keine geratene account_id.

Ein Ziel kann nicht aufgelöst werden

Verwende zuerst das engste Nachschlage-Tool:

• linkedin_lookup_profile für ein Mitglied.
• linkedin_lookup_company für ein Unternehmen oder eine Schule.
• linkedin_lookup_post für einen Beitrag.

Bevorzuge eine vollständige LinkedIn-URL, wenn ein Handle oder eine Anbieterkennung mehrdeutig ist.

message_requires_connection

Direktnachrichten erfordern normalerweise eine bestehende LinkedIn-Beziehung oder eine bekannte Konversation. Verwende stattdessen linkedin_invite oder linkedin_invite_then_message.

action_limit_queue_required

SalesTouch hat das Konto vor einer sofortigen Aktion geschützt. Wiederhole denselben Tool-Aufruf mit:

{
  "queue": true
}

Behalte beim erneuten Versuch das ursprüngliche Ziel und den ursprünglichen Inhalt bei.

Eine geplante Aktion wartet auf das Ausführungsfenster

scheduler_status: "awaiting_horizon" bedeutet, dass die Aktion sicher gespeichert ist, aber noch mehr als sieben Tage entfernt liegt. SalesTouch registriert das genaue Ausführungsereignis automatisch, sobald es das unterstützte Fenster erreicht.

pending_retry bedeutet, dass der stündliche Wiederherstellungsprozess die Ereignisregistrierung erneut versucht. Prüfe status mit Warteschlangendetails für den aktuellen wirksamen Zeitpunkt und mögliche Fehler bei der Neuverbindung.

Gibt die Ausführung linkedin_reconnect_required zurück, benötigt die gespeicherte LinkedIn-Sitzung menschliches Eingreifen. Konten mit Zugangsdaten verbinden sich normalerweise automatisch neu. Alte Cookie-Sitzungen können das nicht.

Ein Extraktionsergebnis ist zu groß

Extraktionstools speichern Personen oder Unternehmen und geben eine begrenzte Vorschau zurück. Verwende scrape_result_page mit der zurückgegebenen result_id und dem Cursor. Nutze den signierten CSV- oder JSONL-Export für den vollständigen Datensatz und füge keinen kompletten Export in den Agentenkontext ein.

Standardmäßig extrahiert scrape_linkedin_post_comments nur die Autoren von Hauptkommentaren. Setze include_replies: true, wenn auch Autoren von Antworten benötigt werden. Jeder Antwort-Thread erfordert zusätzliche LinkedIn-Anfragen und kann die Extraktion deutlich verlangsamen. Große Kommentar-Extraktionen pausieren automatisch nach einer begrenzten Zahl von Quellanfragen oder einer festgelegten Anbieterzeit, damit der MCP-Aufruf innerhalb seines Transportfensters abgeschlossen wird. source_stats.partial_reason ist je nach erreichter Grenze provider_request_budget, provider_time_budget oder provider_interruption. Bestätigter Fortschritt bleibt auch erhalten, wenn LinkedIn die erste Seite unterbricht. Wenn source_paging.exhausted den Wert false hat, rufe das Tool erneut mit source_paging.arguments auf. Der undurchsichtige source_cursor setzt die LinkedIn-Seitennavigation im selben Antwortmodus fort, statt neu zu beginnen. Der Aufruf kann daher weniger Profile als limit zurückgeben. scrape_result_page liest nur Profile seitenweise, die bereits durch einen Extraktionsaufruf gespeichert wurden.

Kommentar-Daten enthalten nicht immer die aktuelle Berufsbezeichnung des Autors. Ist eine Profilkennung verfügbar, führt der Extraktor vor dem Speichern des Exports eine begrenzte Profilanreicherung durch. Prüfe source_stats.headline_availability, headline_available_count und headline_missing_count. Ein Wert partial mit der passenden Warnung bedeutet, dass LinkedIn nicht alle Berufsbezeichnungen innerhalb des transportsicheren Anreicherungsfensters bereitgestellt hat.

Ein Sales-Navigator-Filter ist mehrdeutig

Rufe linkedin_sales_navigator_search_parameters mit dem gemeldeten Parametertyp und der Abfrage auf. Wähle die ID des beabsichtigten Kandidaten aus und wiederhole die strukturierte Suche mit { "id": "..." }. Parameter-IDs hängen vom verbundenen Sales-Navigator-Konto ab. Erfinde keine ID und verwende keine ungeprüfte ID erneut.

Tool-Ergebnisse sehen wie Text statt JSON aus

Das ist zu erwarten. SalesTouch gibt MCP-Textinhalt zurück, der formatiertes JSON enthält. Der Assistent sollte den Text analysieren und das nützliche Ergebnis in seiner normalen Antwort darstellen.

Weiterhin blockiert

Erfasse im SalesTouch-Aktivitätsprotokoll den Tool-Namen, die bereinigte Eingabe, den Fehlercode und den ungefähren Zeitpunkt. Füge niemals OAuth-Token, LinkedIn-Cookies oder private Zugangsdaten in einen Supportbericht ein.