Risoluzione dei problemi

L’MCP è installato, ma non compare alcuno strumento

Avvia una nuova attività o conversazione dopo aver collegato il server. In genere, i client MCP caricano le definizioni degli strumenti all’inizio di una sessione, non continuamente in una sessione già esistente.

Verifica che l’endpoint configurato sia esattamente:

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

Il client chiede di autenticarti di nuovo

Il token di accesso è assente, scaduto o non possiede lo scope richiesto. Esegui nuovamente il flusso di accesso MCP, completa il consenso nel browser e crea una nuova sessione nel client.

paid_plan_required

L’utente è autenticato, ma il workspace SalesTouch non dispone dell’accesso all’MCP LinkedIn. È un problema di diritto di accesso, non di trasporto OAuth.

Nessun account LinkedIn collegato

Collega LinkedIn in SalesTouch e verifica con linkedin_accounts. Non fornire un account_id ipotizzato.

Impossibile risolvere una destinazione

Usa prima lo strumento di ricerca più specifico:

• linkedin_lookup_profile per un membro.
• linkedin_lookup_company per un’azienda o una scuola.
• linkedin_lookup_post per un post.

Preferisci un URL LinkedIn completo quando un handle o un identificatore del provider è ambiguo.

message_requires_connection

I messaggi diretti richiedono normalmente una relazione LinkedIn esistente o una conversazione nota. Usa invece linkedin_invite o linkedin_invite_then_message.

action_limit_queue_required

SalesTouch ha protetto l’account da un’azione immediata. Ripeti la stessa chiamata con:

{
  "queue": true
}

Conserva la destinazione e il contenuto originali quando riprovi.

Un’azione pianificata attende l’orizzonte di esecuzione

scheduler_status: "awaiting_horizon" significa che l’azione è stata salvata in modo sicuro, ma si trova ancora a più di sette giorni di distanza. SalesTouch registra automaticamente l’evento di esecuzione esatto quando entra nell’orizzonte supportato.

pending_retry significa che il processo di recupero orario ritenterà la registrazione dell’evento. Controlla status con i dettagli della coda per conoscere l’orario effettivo e gli eventuali errori di riconnessione.

Se l’esecuzione restituisce linkedin_reconnect_required, la sessione LinkedIn salvata richiede un intervento umano. Gli account basati su credenziali si ricollegano normalmente in automatico. Le vecchie sessioni con cookie non possono farlo.

Un risultato di estrazione è troppo grande

Gli strumenti di estrazione salvano le persone o le aziende e restituiscono un’anteprima limitata. Usa scrape_result_page con il result_id e il cursore restituiti. Usa l’esportazione firmata CSV o JSONL per il set di dati completo e non incollare un’intera esportazione nel contesto dell’agente.

Per impostazione predefinita, scrape_linkedin_post_comments estrae solo gli autori dei commenti principali. Imposta include_replies: true quando servono anche gli autori delle risposte. Ogni thread di risposte richiede ulteriori richieste LinkedIn e può rallentare notevolmente l’estrazione. Le grandi estrazioni dei commenti si mettono automaticamente in pausa dopo un numero limitato di richieste alla fonte o un tempo definito del provider, in modo che la chiamata MCP termini nella sua finestra di trasporto. source_stats.partial_reason è provider_request_budget, provider_time_budget o provider_interruption a seconda del limite raggiunto. I progressi confermati vengono conservati anche quando LinkedIn interrompe la prima pagina. Quando source_paging.exhausted è false, chiama di nuovo lo strumento con source_paging.arguments. Il suo source_cursor opaco riprende l’impaginazione LinkedIn nella stessa modalità di risposte invece di ricominciare. La chiamata può quindi restituire meno profili rispetto a limit. scrape_result_page scorre solo i profili già salvati da una chiamata di estrazione.

I dati dei commenti non includono sempre il ruolo professionale attuale dell’autore. Quando è disponibile un identificatore del profilo, lo strumento esegue un arricchimento limitato prima di salvare l’esportazione. Controlla source_stats.headline_availability, headline_available_count e headline_missing_count. Un valore partial con il relativo avviso significa che LinkedIn non ha esposto tutti i ruoli nella finestra di arricchimento sicura per il trasporto.

Un filtro Sales Navigator è ambiguo

Chiama linkedin_sales_navigator_search_parameters con il tipo di parametro e la query segnalati. Seleziona l’ID del candidato corretto, quindi ripeti la ricerca strutturata con { "id": "..." }. Gli ID dei parametri dipendono dall’account Sales Navigator collegato. Non inventare né riutilizzare un ID non verificato.

I risultati degli strumenti sembrano testo invece di JSON

È previsto. SalesTouch restituisce contenuto testuale MCP che contiene JSON formattato. L’assistente deve analizzare il testo e presentare il risultato utile nella sua normale risposta.

Ancora bloccato

Raccogli dal registro attività di SalesTouch il nome dello strumento, l’input ripulito, il codice di errore e l’orario approssimativo. Non includere mai token OAuth, cookie LinkedIn o credenziali private in una segnalazione di supporto.