Solução de problemas

O MCP está instalado, mas nenhuma ferramenta aparece

Inicie uma nova tarefa ou conversa depois de conectar o servidor. Os clientes MCP normalmente carregam as definições das ferramentas quando uma sessão começa, não de forma contínua em uma sessão existente.

Confirme que o endpoint configurado seja exatamente:

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

O cliente pede uma nova autenticação

O token de acesso está ausente, expirou ou não possui o escopo necessário. Execute novamente o fluxo de login do MCP, conclua o consentimento no navegador e crie uma nova sessão no cliente.

paid_plan_required

O usuário está autenticado, mas o espaço de trabalho da SalesTouch não tem acesso ao MCP do LinkedIn. Esse é um problema de direito de acesso, não de transporte OAuth.

Nenhuma conta do LinkedIn conectada

Conecte o LinkedIn na SalesTouch e confira com linkedin_accounts. Não forneça um account_id adivinhado.

Não é possível resolver um alvo

Use primeiro a ferramenta de consulta mais específica:

• linkedin_lookup_profile para um membro.
• linkedin_lookup_company para uma empresa ou instituição de ensino.
• linkedin_lookup_post para uma publicação.

Prefira uma URL completa do LinkedIn quando um handle ou identificador do provedor for ambíguo.

message_requires_connection

Mensagens diretas normalmente exigem uma relação existente no LinkedIn ou uma conversa conhecida. Use linkedin_invite ou linkedin_invite_then_message.

action_limit_queue_required

A SalesTouch protegeu a conta de uma ação imediata. Repita a mesma chamada com:

{
  "queue": true
}

Preserve o alvo e o conteúdo originais ao tentar novamente.

Uma ação agendada aguarda o horizonte de execução

scheduler_status: "awaiting_horizon" significa que a ação foi salva com segurança, mas ainda está a mais de sete dias de distância. A SalesTouch registra automaticamente o evento exato de execução quando a ação entra no horizonte compatível.

pending_retry significa que o processo de recuperação por hora tentará registrar o evento novamente. Consulte status com os detalhes da fila para ver o horário efetivo atual e qualquer erro de reconexão.

Se a execução retornar linkedin_reconnect_required, a sessão salva do LinkedIn precisa de intervenção humana. Contas com credenciais normalmente se reconectam automaticamente. Sessões antigas por cookie não conseguem fazer isso.

Um resultado de extração é grande demais

As ferramentas de extração salvam itens de pessoas ou empresas e retornam uma prévia limitada. Use scrape_result_page com o result_id e o cursor retornados. Use a exportação assinada em CSV ou JSONL para o conjunto completo e não cole toda a exportação no contexto do agente.

Por padrão, scrape_linkedin_post_comments extrai apenas os autores dos comentários principais. Defina include_replies: true quando também precisar dos autores das respostas. Cada tópico de respostas exige solicitações adicionais ao LinkedIn e pode deixar a extração muito mais lenta. Grandes extrações de comentários pausam automaticamente após um número limitado de solicitações à fonte ou um período definido no provedor, para que a chamada MCP termine dentro de sua janela de transporte. source_stats.partial_reason é provider_request_budget, provider_time_budget ou provider_interruption, de acordo com o limite atingido. O progresso confirmado é preservado mesmo quando o LinkedIn interrompe a primeira página. Quando source_paging.exhausted for false, chame a ferramenta novamente com source_paging.arguments. O source_cursor opaco retoma a paginação do LinkedIn no mesmo modo de respostas em vez de recomeçar. Portanto, a chamada pode retornar menos perfis que limit. scrape_result_page apenas percorre perfis que já foram salvos por uma chamada de extração.

Os dados dos comentários nem sempre incluem o cargo profissional atual do autor. Quando há um identificador de perfil disponível, o extrator realiza um enriquecimento limitado antes de salvar a exportação. Confira source_stats.headline_availability, headline_available_count e headline_missing_count. Um valor partial com o aviso correspondente significa que o LinkedIn não expôs todos os cargos dentro da janela de enriquecimento segura para o transporte.

Um filtro do Sales Navigator é ambíguo

Chame linkedin_sales_navigator_search_parameters com o tipo de parâmetro e a consulta informados. Selecione o ID do candidato desejado e tente novamente a pesquisa estruturada com { "id": "..." }. Os IDs dos parâmetros dependem da conta conectada do Sales Navigator. Não invente nem reutilize um ID não verificado.

Os resultados das ferramentas parecem texto em vez de JSON

Isso é esperado. A SalesTouch retorna conteúdo de texto MCP com JSON formatado. O assistente deve analisar o texto e apresentar o resultado útil em sua resposta normal.

Ainda está bloqueado

Reúna no log de atividades da SalesTouch o nome da ferramenta, a entrada higienizada, o código de erro e o horário aproximado. Nunca inclua tokens OAuth, cookies do LinkedIn ou credenciais privadas em um relatório de suporte.