Referência das ferramentas MCP

O catálogo abaixo é criado com as mesmas definições enviadas aos clientes MCP durante a descoberta de ferramentas. Cada página de referência acrescenta requisitos, prompts, exemplos, resultados esperados e orientações para resolver erros.

Anexos nativos nas mensagens

linkedin_message aceita attachments opcionais. linkedin_invite_then_message aceita follow_up_attachments para a mensagem enviada após a aceitação. O texto continua obrigatório. Até 5 arquivos e 20.000.000 bytes no total por mensagem, com 200 MB de armazenamento privado por espaço de trabalho. PDF, MP4/MOV, PNG/JPG/GIF/BMP, documentos do Office e TXT/CSV/RTF são validados por extensão, tipo MIME e conteúdo. HTML e arquivos executáveis não são aceitos. O provedor pode rejeitar arquivos incompatíveis com a caixa selecionada.

Para um arquivo local, selecione-o pelo clipe na caixa de entrada do SalesTouch. O aplicativo envia partes de até 2 MB pelo fluxo autenticado /api/linkedin/attachments e finaliza o arquivo. Use seu attachment_id na mensagem do agente. Clientes iniciam com POST /api/linkedin/attachments e account_id, filename, content_type, size_bytes; enviam partes com POST /api/linkedin/attachments/{id}, Content-Type: application/octet-stream e Upload-Offset; finalizam com PUT nessa URL. GET retorna o status e a posição dos bytes recebidos; DELETE remove um envio não utilizado. O servidor nunca abre um caminho local informado pelo chamador.

Um agente também pode fornecer content_base64 (base64 canônico sem prefixo de URL de dados) ou uma url HTTPS pública, com filename e content_type. As URLs usam a porta 443; redes privadas e reservadas, redirecionamentos inseguros e downloads acima de 15 segundos são rejeitados. Todos os modos armazenam os bytes privados antes de enfileirar. A visualização nativa de mídia é o padrão; send_mode: "file" solicita um arquivo para download quando compatível.

queue e scheduled_for preservam as referências dos arquivos com a ação. Os acompanhamentos após aceitação mantêm os arquivos por até 90 dias após o convite agendado; envios incompletos expiram em 24 horas e arquivos entregues em 7 dias. Mensagens pendentes mantêm os arquivos até a entrega. Resultados incertos preservam metadados de diagnóstico e bloqueiam o reenvio automático.

Reutilize idempotency_key ao tentar novamente uma mensagem com anexos. Sem chave, destinatário, texto e arquivos idênticos são deduplicados. Use uma chave nova somente para um envio novo intencional. As respostas incluem attachment_delivery_id, status e IDs dos arquivos; acompanhamentos mostram esses campos em follow_up. Consulte o status pelo endpoint autenticado GET /api/linkedin/attachment-deliveries/{id}. ATTACHMENT_SEND_UNCERTAIN exige verificar a conversa antes de outro envio. Erros de upload, permissões, conteúdo, tamanho e URL usam 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
}

Ferramentas de e-mail

As ferramentas de e-mail exigem a permissão de e-mail na sua conexão MCP e uma caixa de e-mail conectada.

• email_accounts: caixas, capacidade diária, aquecimento e o link de conexão quando nenhuma pode enviar.
• email_send: um e-mail pessoal ou uma resposta. Um e-mail avulso é enviado imediatamente; envios em lote vão para a fila.
• email_conversations: conversas com leads em todas as suas caixas, com needs_reply e busca de texto completo.
• email_messages: uma conversa página por página, com o texto completo das mensagens.
• email_threads: todas as conversas de e-mail e envios agendados de um lead.
• email_attachment: um arquivo anexado a um e-mail, com o link de download; arquivos de texto e CSV incluem o texto.

email_send aceita até 5 attachments (15 MB no total): um attachment_id de email_messages para encaminhar um arquivo recebido, uma url HTTPS pública ou content_base64. Os arquivos recebidos são mantidos por 90 dias; acima de 15 MB, apenas o nome e o tamanho são guardados.