Referencia de herramientas MCP

El siguiente catálogo se crea a partir de las mismas definiciones que reciben los clientes MCP durante el descubrimiento de herramientas. Cada página de referencia añade requisitos, prompts, ejemplos, resultados esperados e indicaciones para resolver errores.

Archivos adjuntos nativos

linkedin_message admite attachments opcionales. linkedin_invite_then_message admite follow_up_attachments para el mensaje enviado tras aceptar la invitación. El texto sigue siendo obligatorio. Hasta 5 archivos y 20.000.000 bytes en total por mensaje, con 200 MB de almacenamiento privado por espacio de trabajo. Se validan PDF, MP4/MOV, PNG/JPG/GIF/BMP, documentos de Office y TXT/CSV/RTF por extensión, tipo MIME y contenido. HTML y archivos ejecutables no son compatibles. El proveedor puede rechazar archivos incompatibles con la bandeja seleccionada.

Para un archivo local, selecciónalo con el clip de la bandeja de SalesTouch. La aplicación sube fragmentos de hasta 2 MB mediante el flujo autenticado /api/linkedin/attachments y finaliza el archivo. Usa su attachment_id en un mensaje del agente. Los clientes comienzan con POST /api/linkedin/attachments y account_id, filename, content_type, size_bytes; envían fragmentos con POST /api/linkedin/attachments/{id}, Content-Type: application/octet-stream y Upload-Offset; finalizan con PUT en esa URL. GET devuelve el estado y la posición de bytes recibidos; DELETE elimina una subida sin usar. El servidor nunca abre una ruta local proporcionada por quien llama.

Un agente también puede proporcionar content_base64 (base64 canónico sin prefijo de URL de datos) o una url HTTPS pública, con filename y content_type. Las URL usan el puerto 443; se rechazan redes privadas y reservadas, redirecciones inseguras y descargas de más de 15 segundos. Todos los modos guardan los bytes privados antes de encolar. La vista previa nativa es la opción predeterminada; send_mode: "file" solicita un archivo descargable cuando sea compatible.

queue y scheduled_for conservan las referencias de archivos junto a la acción. Los seguimientos tras la aceptación guardan archivos hasta 90 días después de la invitación programada; las subidas incompletas caducan a las 24 horas y los archivos entregados a los 7 días. Los envíos pendientes conservan los archivos hasta la entrega. Los resultados inciertos conservan metadatos de diagnóstico y bloquean el reenvío automático.

Reutiliza idempotency_key al reintentar un mensaje con adjuntos. Sin clave, se deduplican destinatario, texto y archivos idénticos. Usa una clave nueva solo para un envío nuevo intencional. Las respuestas incluyen attachment_delivery_id, estado e identificadores de archivos; los seguimientos los muestran en follow_up. Consulta el estado en el endpoint autenticado GET /api/linkedin/attachment-deliveries/{id}. ATTACHMENT_SEND_UNCERTAIN exige revisar la conversación antes de otro envío. Los errores de subida, permisos, contenido, tamaño y URL tienen códigos explícitos.

{
  "identifier": "https://www.linkedin.com/in/example",
  "text": "Here is the brochure we discussed.",
  "attachments": [{"filename": "brochure.pdf", "content_type": "application/pdf", "url": "https://example.com/brochure.pdf"}],
  "idempotency_key": "brochure-prospect-2026-10",
  "queue": true
}

Herramientas de correo

Las herramientas de correo necesitan el permiso de correo en tu conexión MCP y un buzón conectado.

• email_accounts: buzones, capacidad diaria, calentamiento y el enlace de conexión cuando ninguno puede enviar.
• email_send: un correo personal o una respuesta. Un correo individual se envía de inmediato; los envíos agrupados pasan a la cola.
• email_conversations: conversaciones con leads en todos tus buzones, con needs_reply y búsqueda de texto completo.
• email_messages: un hilo página a página, con el texto completo de los mensajes.
• email_threads: todos los hilos de correo y envíos programados de un lead.
• email_attachment: un archivo adjunto a un correo, con su enlace de descarga; los archivos de texto y CSV incluyen su texto.

email_send acepta hasta 5 attachments (15 MB en total): un attachment_id de email_messages para reenviar un archivo recibido, una url HTTPS pública o content_base64. Los archivos recibidos se conservan 90 días; de los que superan 15 MB solo se guardan el nombre y el tamaño.