Servidor MCP

Endpoint

POST https://mcp.watsi.ai/mcp

Un solo endpoint, Streamable HTTP, sin estado. No existe un endpoint /sse ni una sesión que mantener viva — cada solicitud lleva sus propias credenciales. Hay dos formas de autenticarse, y ambas resuelven a un único espacio de trabajo:

• Clave de API. La clave de su espacio de trabajo como token bearer: Authorization: Bearer wats_…. Úsela en los clientes que usted configura — Claude Desktop, Cursor, Claude Code, sus propios agentes.
• OAuth 2.1. Ya disponible, con registro dinámico de clientes. Es la única opción para los clientes web que no pueden enviar un encabezado propio (Claude.ai, ChatGPT): usted inicia sesión en watsi, elige el espacio de trabajo y aprueba los alcances en una pantalla de consentimiento.

En ambos casos la credencial está limitada a un espacio de trabajo, y cada llamada a una herramienta queda auditada.

Qué puede leer

Una muestra de las herramientas de lectura. El catálogo autoritativo es el que el servidor publica por tools/list — pídale a su cliente que liste sus herramientas una vez conectado. No se fija aquí a propósito: una herramienta cuyo servicio de respaldo no está cableado en un entorno se retira allí en lugar de anunciarse y fallar, así que cualquier lista fija en un documento estaría mal en alguna parte. Cada herramienta se corresponde 1:1 con un alcance y solo funciona si su credencial lleva el alcance :read correspondiente.

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

Qué puede cambiar

La mayor parte del catálogo lee, pero no todo. Un conjunto pequeño de herramientas configura al propio agente de IA — crear un agente, actualizar su configuración, agregar o eliminar conocimiento, definir la política de asignación, definir los horarios de los miembros, actualizar la configuración de llamadas — para que pueda dejar listo un agente desde un cliente de IA en lugar del panel. Están limitadas de tres maneras:

• Un alcance de escritura explícito. Cada una exige agents:write, knowledge:write o scheduling:write. El selector de claves del panel no ofrece esos tres (sí ofrece otros alcances de escritura como messages:write y contacts:write), por lo que una clave del panel no puede cambiar la configuración del agente — esas escrituras requieren una clave emitida por el soporte de watsi, o una concesión OAuth en la que usted marque el alcance.
• Desmarcados por defecto. En la pantalla de consentimiento de OAuth los alcances de escritura aparecen por nombre y empiezan desmarcados. Si no aprueba nada extra, la sesión es de solo lectura.
• Anunciadas a su cliente. Cada herramienta de escritura se declara como una mutación (readOnlyHint: false) e indica si reemplaza o elimina datos (destructiveHint), para que el cliente pueda preguntarle antes de cada llamada.

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.

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"

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.

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"
      ]
    }
  }
}

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 no pueden enviar una clave de API estática, así que inician sesión con OAuth, que ya está disponible. Agregue https://mcp.watsi.ai/mcp como conector personalizado, inicie sesión en watsi cuando se le pida, elija el espacio de trabajo y apruebe los alcances. No hay encabezado que configurar ni clave que pegar: el cliente se registra con nosotros automáticamente (registro dinámico de clientes).

Ambas apps advierten que un conector personalizado no está verificado por ellas — es lo esperable para cualquier servidor que se agregue por URL.

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

• Lectura por defecto. Una clave del panel lleva alcances de lectura por defecto. El panel también ofrece algunos alcances de escritura (mensajes, leads, contactos) que puede activar; las escrituras de configuración del agente no están disponibles allí.
• Limitado al espacio de trabajo. Una clave solo ve los datos del espacio de trabajo al que pertenece.
• Auditado. Cada llamada exitosa queda registrada (qué credencial, 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.