Servidor MCP: conecta un asistente de IA

El servidor MCP de WbizTool permite que un asistente de IA trabaje con tu espacio de trabajo. Puedes pedirle cosas como "¿qué mensajes fallaron hoy y por qué?", "pausa el recordatorio del alquiler" o "envía nuestro nuevo horario a estos cinco clientes", y las hace con tu cuenta de WbizTool.

Habla el Model Context Protocol (MCP), que entienden Claude Code, Cursor, VS Code y otras herramientas de IA. Por detrás, cada acción es una llamada a la API v2 hecha con tu propia clave API v2, así que la clave decide qué puede ver y hacer el asistente.

Qué puede hacer un asistente#

El asistente solo ve las herramientas que la clave permite (consulta los permisos):

También ofrece tres prompts listos para usar: Daily summary (resumen diario), Failed messages (mensajes fallidos) y Draft an announcement (redactar un anuncio).

No puede conectar un número nuevo (eso se sigue haciendo en tu panel), subir archivos, gestionar webhooks ni leer tu bandeja de Unibox.

1. Crea una clave para el asistente#

1. Abre la tarjeta Claves API v2

   En WbizTool, ve a Configuración → Claves API y busca la tarjeta Claves API v2.

2. Usa el ajuste para un asistente de IA

   Haz clic en Crear clave v2 y luego en Para un asistente de IA. Crea una clave de Solo lectura que puede leer mensajes y números y caduca en 90 días. Es una forma segura de empezar: el asistente puede mirar, pero no enviar ni cambiar nada.

3. Permite enviar solo si lo quieres

   Si el asistente debe enviar mensajes o gestionar recordatorios, desmarca Solo lectura y marca Enviar mensajes (y Recordatorios si hace falta). También puedes limitar la clave a algunos de tus números.

4. Copia la clave

   La clave (wbz_live_…) se muestra una sola vez. Guárdala en una variable de entorno de tu ordenador, como WBIZTOOL_API_KEY; nunca la pegues en un archivo que compartas o subas a un repositorio.

export WBIZTOOL_API_KEY=wbz_live_…

2. Añade el servidor a tu herramienta de IA#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: ejecuta el comando una vez (añade --scope project para compartirlo con un proyecto a través de .mcp.json; el archivo contiene ${WBIZTOOL_API_KEY}, no la clave).
• Cursor: ponlo en ~/.cursor/mcp.json, o en .cursor/mcp.json dentro de un proyecto.
• VS Code: ponlo en .vscode/mcp.json. VS Code te pide la clave una vez y la guarda en su almacenamiento de secretos.

Después pregúntale al asistente algo como "¿Cuál es mi cuenta de WbizTool?". Debería responder con el nombre y el plan de tu espacio de trabajo.

3. Cómo los envíos siguen siendo seguros#

• Cada envío se previsualiza primero. Cuando pides un mensaje, el asistente primero recibe una vista previa de WbizTool (desde qué número sale, a quién va, el texto exacto, el archivo si lo hay, cuándo) y todavía no se ha enviado nada. Tiene instrucciones de mostrarte esa vista previa y esperar tu sí. Solo entonces lo envía, exactamente con lo que viste.
• Un reintento nunca envía dos veces. Si el asistente repite un envío confirmado (por ejemplo, tras un tiempo de espera agotado), WbizTool responde con el mensaje que ya envió.
• La clave es el límite firme. Una clave de solo lectura no puede enviar nada. Una clave sin Enviar mensajes ni siquiera ve las herramientas de envío, y una clave limitada a algunos números no puede usar los demás. También se aplican los límites propios de WbizTool: 60 solicitudes por minuto por clave y como máximo 1.000 mensajes al día por número.
• El texto de otras personas se marca como datos. Los mensajes, nombres y archivos que vienen de fuera llegan al asistente marcados como no fiables, y tiene instrucciones de no seguir nunca las instrucciones que contengan.
• Sin secretos en las respuestas. Los códigos QR y los códigos de vinculación nunca se muestran, y las listas no incluyen enlaces a archivos.
• Revoca cuando quieras. Revocar la clave en Configuración → Claves API detiene al asistente al instante.

Privacidad#

Cuando conectas un asistente, lo que lee de WbizTool (los mensajes, nombres y números que dejes ver a la clave) se envía al proveedor de ese asistente, por ejemplo Anthropic para Claude u OpenAI para ChatGPT, y se trata según sus condiciones. El servidor MCP de WbizTool no guarda nada: pasa cada solicitud a la API v2 y registra qué herramienta se usó, nunca el texto de los mensajes ni tu clave. Da a la clave solo el acceso que el asistente necesita.

Solución de problemas#

Relacionado#

• Resumen de la API v2
• Claves API
• Mensajes (API v2)
• Apps e integraciones