Escribir un archivo del vault
vault_writeCrea o modifica un archivo de texto en el vault de la empresa, la base de conocimiento compartida que leen todos los miembros y agentes de SalesTouch. El modo replace (predeterminado) exige base_version: la versión devuelta por vault_read, o 0 para un archivo nuevo; una versión obsoleta se rechaza para que nadie pierda su cambio. El modo append añade texto al final, para registros y diarios. Sigue las convenciones de SCHEMA.md y pasa log_summary para registrar el cambio en log.md. Solo texto, hasta 3 MB.
Cuándo usarla
Guarda conocimiento duradero para todo el equipo y sus agentes: actualiza una oferta, una persona o un playbook, registra una llamada o un aprendizaje.
linkedin:accesssalestouch:useRequisitos
Ejemplo
Añade la objeción que escuchamos hoy a nuestra nota de manejo de objeciones en el vault.
{
"path": "05-messaging/objection-handling.md",
"content": "# Objection handling\n\n...",
"base_version": 3,
"log_summary": "Added the 'already have a tool' objection"
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: La ruta del archivo, su nueva versión y tamaño, y si log.md registró el cambio.
Parámetros
spacestringcompany (predeterminado): el vault compartido con tu equipo. personal: tu espacio de trabajo privado, no compartido con nadie.
pathobligatoriostringRuta del archivo relativa a la raíz del vault, por ejemplo 02-offers/core-offer.md.
contentobligatoriostringNuevo texto completo del archivo, o el texto que añadir en modo append.
base_versionintegerVersión devuelta por vault_read, o 0 para crear un archivo nuevo. Obligatoria en modo replace.
modestringreplace (predeterminado) reescribe el archivo; append añade content al final.
log_summarystringResumen del cambio en una línea, registrado en log.md.
Los alias se muestran por separado porque los clientes MCP envían un objeto JSON plano. Usa un solo alias de cada grupo obligatorio, no todos los alias.
Errores frecuentes
insufficient_scopeVuelve a conectar el MCP y aprueba el permiso de LinkedIn solicitado.
paid_plan_requiredSigue la action_url del error: inicia la prueba gratuita, elige un plan si la prueba o la suscripción terminó, o actualiza el método de pago tras un pago fallido. details.reason indica el caso.
trial_payment_method_requiredReintenta en un minuto si acabas de completar el pago; si no, añade un método de pago en la facturación de SalesTouch para activar la prueba y el acceso al MCP de LinkedIn.
vault_unavailableEl vault de la empresa viene con el agente de SalesTouch. Pide a un administrador del espacio de trabajo que lo active.
vault_conflictAlguien modificó el archivo desde que lo leíste: vuelve a leerlo, combina tu cambio y reintenta con la nueva base_version.
credits_requiredLos archivos de más de 256 KB se facturan en créditos de agente: añade créditos al espacio de trabajo en SalesTouch y vuelve a intentarlo.