SalesTouch Docs
Tutti gli strumenti MCP
Scrive su LinkedInLinkedIn

Scrivi un file del vault

vault_write

Crea o aggiorna un file di testo nel vault aziendale, la base di conoscenza condivisa che ogni membro e ogni agente SalesTouch legge. La modalità replace (predefinita) richiede base_version: la versione restituita da vault_read, o 0 per un file nuovo; una versione superata viene rifiutata perché nessuno perda la propria modifica. La modalità append aggiunge testo in fondo, per registri e diari. Segui le convenzioni di SCHEMA.md e passa log_summary per annotare la modifica in log.md. Solo testo, fino a 3 MB.

Quando usarlo

Salva conoscenze durature per tutto il team e i suoi agenti: aggiorna un’offerta, una persona o un playbook, registra una chiamata o un insegnamento.

Scope richiesti
linkedin:accesssalestouch:use
Esecuzione
Chiamata sincrona a uno strumento MCP

Requisiti

Leggi prima il file e passa la sua versione come base_version, o 0 per un file nuovo.
Segui SCHEMA.md: un tema per nota, frontmatter, nomi di file in kebab-case.
Gli analisti non possono modificare il vault.

Esempio

Chiedi al tuo agente

Aggiungi l’obiezione sentita oggi alla nostra nota sulla gestione delle obiezioni nel vault.

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

Risultato atteso: Il percorso del file, la nuova versione e la dimensione, e se log.md ha registrato la modifica.

Parametri

space
string

company (predefinito): il vault condiviso con il tuo team. personal: il tuo spazio di lavoro privato, non condiviso con nessuno.

pathobbligatorio
string

Percorso del file relativo alla radice del vault, per esempio 02-offers/core-offer.md.

contentobbligatorio
string

Nuovo testo completo del file, o il testo da aggiungere in modalità append.

base_version
integer

Versione restituita da vault_read, o 0 per creare un file nuovo. Obbligatoria in modalità replace.

mode
string

replace (predefinito) riscrive il file; append aggiunge content in fondo.

log_summary
string

Riepilogo della modifica in una riga, registrato in log.md.

Gli alias sono mostrati separatamente perché i client MCP inviano un oggetto JSON piatto. Usa un solo alias per ogni gruppo obbligatorio, non tutti gli alias.

Errori comuni

insufficient_scope

Ricollega l’MCP e approva l’autorizzazione LinkedIn richiesta.

paid_plan_required

Segui l’action_url dell’errore: avvia la prova gratuita, scegli un piano se la prova o l’abbonamento è terminato, oppure aggiorna il metodo di pagamento dopo un pagamento non riuscito. details.reason indica il caso.

trial_payment_method_required

Riprova tra un minuto se hai appena completato il checkout; altrimenti aggiungi un metodo di pagamento nella fatturazione SalesTouch per attivare la prova e l’accesso all’MCP LinkedIn.

vault_unavailable

Il vault aziendale è incluso nell’agente SalesTouch. Chiedi a un amministratore dello spazio di lavoro di attivarlo.

vault_conflict

Qualcuno ha modificato il file dopo la tua lettura: rileggilo, unisci la tua modifica e riprova con la nuova base_version.

credits_required

I file oltre 256 KB sono addebitati in crediti agente: aggiungi crediti allo spazio di lavoro in SalesTouch e riprova.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati