watsiwatsi docs

Servidor MCP de solo lectura

Conecte un cliente de IA como Claude Desktop o Cursor directamente a su espacio de trabajo de watsi y haga preguntas sobre sus datos en lenguaje natural. El servidor habla el Model Context Protocol (Streamable HTTP) y es estrictamente de solo lectura — puede mirar, nunca tocar.

Acceso anticipado (socios de diseño)

El MCP de solo lectura se está desplegando primero en los espacios de trabajo de los socios de diseño. Si desea acceso, contacte a su representante de watsi o escriba a support@watsi.ai.

Endpoint

https://mcp.watsi.ai/mcp

Autentique cada solicitud con la clave de API de su espacio de trabajo como token bearer: Authorization: Bearer wats_…. Cada clave está limitada a un único espacio de trabajo, y cada llamada a una herramienta queda auditada.

Qué puede leer

El servidor expone estas herramientas de lectura. Se corresponden 1:1 con los alcances de su clave de API — una herramienta solo funciona si la clave lleva el alcance :read correspondiente.

HerramientaAlcanceQué devuelve
list_contactscontacts:readSus contactos (clientes), los más recientes primero.
find_conversationsconversations:readConversaciones del espacio de trabajo, filtrables y paginadas.
get_conversationconversations:readUna conversación: los mensajes más el resumen de IA.
list_appointmentsscheduling:readPróximas citas del calendario.
workspace_overviewanalytics:readAnalíticas principales: volumen, tasa de respuesta de IA, tendencias.
resources_listresources:readArchivos y recursos de la biblioteca del espacio de trabajo.
resources_getresources:readMetadatos de un archivo de recurso.

list_appointments requiere que la agenda esté habilitada en su espacio de trabajo.

Conéctese con un solo pegado

¿Ya está en un asistente compatible con MCP (Claude Code, el agente de Cursor o cualquier cliente que acepte una URL de servidor más un encabezado)? Pegue este prompt, reemplace su clave y envíelo. Configura la conexión y hace la primera pregunta de una sola vez:

Conéctate a mi espacio de trabajo de watsi por MCP (solo lectura).

Nombre del servidor: watsi
Transporte: Streamable HTTP
URL: https://mcp.watsi.ai/mcp
Encabezado de autenticación: Authorization: Bearer YOUR_API_KEY

Una vez conectado, enumera las herramientas que puedes usar, luego dime cuántos contactos tengo y resume mis tres conversaciones más recientes.

¿Prefiere un solo comando? En Claude Code ejecute:

claude mcp add --transport http watsi https://mcp.watsi.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
Paso 1

Genere una clave de API de solo lectura

Abra Configuración → Claves de API en el panel de watsi, haga clic en Generar nueva clave y otorgue solo los alcances de lectura que necesite (p. ej. contacts:read, conversations:read). Copie la clave de inmediato — solo se muestra una vez.

Paso 2

Agregue el servidor a Claude Desktop

Edite su claude_desktop_config.json (Configuración → Desarrollador → Editar configuración) y agregue una entrada watsi. Claude Desktop se conecta a servidores HTTP remotos mediante mcp-remote:

{
  "mcpServers": {
    "watsi": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.watsi.ai/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
Paso 3

…o Cursor / cualquier cliente MCP por HTTP

Los clientes que hablan Streamable HTTP de forma nativa (Cursor, Windsurf, agentes personalizados) toman la URL y los encabezados directamente. Para Cursor, agregue esto a .cursor/mcp.json:

{
  "mcpServers": {
    "watsi": {
      "url": "https://mcp.watsi.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude.ai (web) y ChatGPT

Las apps web acceden a servidores MCP personalizados desde su propia nube y hoy inician sesión con OAuth, por lo que el método con clave de API anterior funciona mejor en Claude Desktop, Cursor, Claude Code y otros agentes compatibles con MCP. El inicio de sesión con OAuth de un clic para las apps web está en nuestra hoja de ruta. Si lo necesita, avise a su contacto de watsi.

Paso 4

Haga preguntas

Reinicie el cliente y pregunte sobre su espacio de trabajo en lenguaje sencillo. El modelo elige la herramienta de lectura correcta, la llama con su clave y responde a partir de sus datos en vivo.

Preguntas de ejemplo

  • “¿Cuántos contactos agregué esta semana?”
  • “Muéstrame mis conversaciones de WhatsApp más recientes que sigan abiertas.”
  • “Resume la conversación con Maria Garcia.”
  • “¿Qué citas tengo en los próximos 7 días?”
  • “¿Cómo cambió mi tasa de respuesta de IA respecto al mes pasado?”

Bueno saberlo

  • Solo lectura. Ninguna herramienta puede crear, editar ni eliminar nada en su espacio de trabajo.
  • Limitado al espacio de trabajo. Una clave solo ve los datos del espacio de trabajo al que pertenece.
  • Auditado. Cada lectura exitosa queda registrada (qué clave, qué herramienta, cuándo) para que tenga un rastro completo de egreso.
  • Con límite de tasa por clave. Las solicitudes están limitadas por minuto; regule las extracciones grandes y paginadas en consecuencia.

Consulte la guía de autenticación para conocer los alcances y la seguridad de las claves, y la referencia de la API para los endpoints REST equivalentes.