Solución de problemas

El MCP está instalado, pero no aparece ninguna herramienta

Inicia una tarea o conversación nueva después de conectar el servidor. Los clientes MCP suelen cargar las definiciones de las herramientas al comenzar una sesión, no de forma continua en una sesión existente.

Confirma que el endpoint configurado sea exactamente:

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

El cliente te pide que vuelvas a autenticarte

El token de acceso no existe, ha caducado o carece del scope necesario. Ejecuta otra vez el flujo de inicio de sesión del MCP, completa el consentimiento en el navegador y crea una sesión nueva en el cliente.

paid_plan_required

El usuario está autenticado, pero el espacio de trabajo de SalesTouch no tiene acceso al MCP de LinkedIn. Es un problema de derechos de acceso, no del transporte OAuth.

No hay ninguna cuenta de LinkedIn conectada

Conecta LinkedIn en SalesTouch y compruébalo con linkedin_accounts. No envíes un account_id inventado.

No se puede resolver un objetivo

Usa primero la herramienta de consulta más específica:

• linkedin_lookup_profile para un miembro.
• linkedin_lookup_company para una empresa o centro educativo.
• linkedin_lookup_post para una publicación.

Prefiere una URL completa de LinkedIn cuando un handle o identificador del proveedor sea ambiguo.

message_requires_connection

Los mensajes directos suelen requerir una relación existente en LinkedIn o una conversación conocida. Usa en su lugar linkedin_invite o linkedin_invite_then_message.

action_limit_queue_required

SalesTouch ha protegido la cuenta de una acción inmediata. Repite la misma llamada con:

{
  "queue": true
}

Conserva el objetivo y el contenido originales al volver a intentarlo.

Una acción programada espera el horizonte de ejecución

scheduler_status: "awaiting_horizon" significa que la acción está guardada de forma segura, pero aún faltan más de siete días. SalesTouch registra automáticamente su evento de ejecución exacto cuando entra en el horizonte admitido.

pending_retry significa que el proceso de recuperación por hora volverá a intentar registrar el evento. Consulta status con los detalles de la cola para ver la hora efectiva actual y cualquier error de reconexión.

Si la ejecución devuelve linkedin_reconnect_required, la sesión de LinkedIn guardada necesita intervención humana. Las cuentas con credenciales suelen reconectarse automáticamente, pero las sesiones antiguas con cookies no pueden hacerlo.

Un resultado de extracción es demasiado grande

Las herramientas de extracción guardan los elementos de personas o empresas y devuelven una vista previa limitada. Usa scrape_result_page con el result_id y el cursor devueltos. Usa la exportación firmada en CSV o JSONL para el conjunto completo. No pegues una exportación entera en el contexto del agente.

Por defecto, scrape_linkedin_post_comments extrae solo a los autores de los comentarios raíz. Define include_replies: true cuando también necesites los autores de las respuestas. Cada hilo de respuestas requiere solicitudes adicionales a LinkedIn y puede ralentizar mucho la extracción. Las extracciones grandes de comentarios se detienen automáticamente tras un número limitado de solicitudes a la fuente o un tiempo definido del proveedor, para que la llamada MCP finalice dentro de su ventana de transporte. source_stats.partial_reason es provider_request_budget, provider_time_budget o provider_interruption según el límite alcanzado. El progreso confirmado se conserva incluso si LinkedIn interrumpe la primera página. Cuando source_paging.exhausted sea false, vuelve a llamar a la herramienta con source_paging.arguments. Su source_cursor opaco reanuda la paginación de LinkedIn en el mismo modo de respuestas en lugar de empezar de nuevo. Por tanto, la llamada puede devolver menos perfiles que limit. scrape_result_page solo recorre los perfiles ya guardados por una llamada de extracción.

Los datos de los comentarios no siempre incluyen el puesto profesional actual del autor. Cuando hay un identificador de perfil, el extractor realiza un enriquecimiento limitado antes de guardar la exportación. Revisa source_stats.headline_availability, headline_available_count y headline_missing_count. Un valor partial y la advertencia correspondiente significan que LinkedIn no expuso todos los puestos dentro de la ventana de enriquecimiento segura para el transporte.

Un filtro de Sales Navigator es ambiguo

Llama a linkedin_sales_navigator_search_parameters con el tipo de parámetro y la consulta indicados. Selecciona el identificador del candidato correcto y repite la búsqueda estructurada con { "id": "..." }. Los identificadores de parámetros dependen de la cuenta de Sales Navigator conectada. No inventes ni reutilices un identificador sin verificar.

Los resultados de las herramientas parecen texto en vez de JSON

Es lo esperado. SalesTouch devuelve contenido de texto MCP que contiene JSON formateado. El asistente debe analizar el texto y presentar el resultado útil en su respuesta normal.

Sigues bloqueado

Recopila en el registro de actividad de SalesTouch el nombre de la herramienta, la entrada anonimizada, el código de error y la hora aproximada. Nunca incluyas tokens OAuth, cookies de LinkedIn ni credenciales privadas en un informe de soporte.