SalesTouch Docs
Todas as ferramentas MCP
Grava no LinkedInLinkedIn

Escrever um arquivo do vault

vault_write

Cria ou atualiza um arquivo de texto no vault da empresa, a base de conhecimento compartilhada que todos os membros e agentes da SalesTouch leem. O modo replace (padrão) exige base_version: a versão retornada por vault_read, ou 0 para um arquivo novo; uma versão desatualizada é recusada para que ninguém perca sua alteração. O modo append adiciona texto ao final, para registros e diários. Siga as convenções de SCHEMA.md e passe log_summary para registrar a alteração em log.md. Somente texto, até 3 MB.

Quando usar

Salve conhecimento duradouro para toda a equipe e seus agentes: atualize uma oferta, uma persona ou um playbook, registre uma ligação ou um aprendizado.

Escopos necessários
linkedin:accesssalestouch:use
Execução
Chamada síncrona de ferramenta MCP

Requisitos

Leia primeiro o arquivo e passe sua versão como base_version, ou 0 para um arquivo novo.
Siga SCHEMA.md: um tema por nota, frontmatter, nomes de arquivo em kebab-case.
Os analistas não podem alterar o vault.

Exemplo

Peça ao seu agente

Adicione a objeção que ouvimos hoje à nossa nota de tratamento de objeções no vault.

Argumentos da ferramenta
{
  "path": "05-messaging/objection-handling.md",
  "content": "# Objection handling\n\n...",
  "base_version": 3,
  "log_summary": "Added the 'already have a tool' objection"
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: O caminho do arquivo, sua nova versão e tamanho, e se log.md registrou a alteração.

Parâmetros

space
string

company (padrão): o vault compartilhado com sua equipe. personal: seu espaço de trabalho privado, não compartilhado com ninguém.

pathobrigatório
string

Caminho do arquivo relativo à raiz do vault, por exemplo 02-offers/core-offer.md.

contentobrigatório
string

Novo texto completo do arquivo, ou o texto a adicionar no modo append.

base_version
integer

Versão retornada por vault_read, ou 0 para criar um arquivo novo. Obrigatória no modo replace.

mode
string

replace (padrão) reescreve o arquivo; append adiciona content ao final.

log_summary
string

Resumo da alteração em uma linha, registrado em log.md.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

vault_unavailable

O vault da empresa vem com o agente da SalesTouch. Peça a um administrador do espaço de trabalho para ativá-lo.

vault_conflict

Alguém alterou o arquivo desde a sua leitura: leia-o novamente, combine sua alteração e tente de novo com a nova base_version.

credits_required

Arquivos acima de 256 KB são cobrados em créditos de agente: adicione créditos ao espaço de trabalho na SalesTouch e tente novamente.

Nesta página

Quando usarRequisitosExemploParâmetrosErros comunsFerramentas relacionadas