Elfsight AI Chatbot

npx add-mcp 'https://widget-data.service.elfsight.com/mcp/ai_chat'

Elfsight AI Chatbot — Servidor MCP

Este repositorio contiene la documentación y el manifiesto de registro (server.json) del servidor MCP de Elfsight AI Chatbot. El servidor en sí está alojado por Elfsight; no hay nada que compilar o ejecutar aquí. Para obtener ayuda, contacta con el Centro de ayuda de Elfsight.

Un servidor remoto de Model Context Protocol sobre los datos de tu widget Elfsight AI Chatbot. Apunta un agente de IA compatible con MCP hacia él y podrá leer tus conversaciones, leads, base de conocimiento y analíticas — y añadir respuestas a tu base de conocimiento — sin que tengas que copiar y pegar nada en una ventana de chat.

El servidor está limitado a la cuenta: una vez que inicias sesión, el agente puede acceder a todos los widgets de AI Chatbot de tu cuenta de Elfsight, y nada más (ningún otro producto o dato de Elfsight).

URL del servidor: https://widget-data.service.elfsight.com/mcp/ai_chat (HTTP Streamable).

Conexión

El inicio de sesión es mediante OAuth. Añade la URL del servidor a tu cliente MCP; el cliente abre una ventana del navegador, inicias sesión en Elfsight y apruebas el acceso. No hay ninguna clave que copiar.

Claude Code

claude mcp add --transport http elfsight-ai-chatbot https://widget-data.service.elfsight.com/mcp/ai_chat

Luego ejecuta /mcp dentro de Claude Code y elige Autenticar para elfsight-ai-chatbot.

Cursor

Este repositorio también es un plugin de Cursor: el manifiesto está en .cursor-plugin/plugin.json, la conexión del servidor en mcp.json, y una regla con notas de uso para el agente en rules/.

Para conectarte sin el plugin, añade el servidor a .cursor/mcp.json y autentícalo cuando Cursor te lo pida:

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Cline

En Cline, abre Servidores MCP → Servidores remotos y añade:

• Nombre del servidor: elfsight-ai-chatbot
• URL del servidor: https://widget-data.service.elfsight.com/mcp/ai_chat
• Transporte: HTTP Streamable

Luego elige Autenticar para el servidor e inicia sesión en Elfsight en el navegador.

Lo mismo en el archivo de configuración propio de Cline, cline_mcp_settings.json. Las versiones recientes lo mantienen en ~/.cline/data/settings/, las más antiguas en el User/globalStorage/saoudrizwan.claude-dev/settings/ del editor. Mantén type: sin él, Cline vuelve al transporte SSE heredado. .vscode/mcp.json pertenece al soporte MCP integrado de VS Code; Cline no lo lee.

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "type": "streamableHttp",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Otros clientes

Cualquier cliente que admita servidores MCP remotos con OAuth (registro dinámico de clientes y PKCE) debería conectarse solo con la URL del servidor. Solo hemos probado Claude Code, Cursor (a través del plugin), Cline y VS Code; el fragmento de VS Code a continuación está verificado, el de Windsurf tiene la forma habitual de su configuración.

VS Code (.vscode/mcp.json):

{
  "servers": {
    "elfsight-ai-chatbot": {
      "type": "http",
      "url": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Windsurf (mcp_config.json):

{
  "mcpServers": {
    "elfsight-ai-chatbot": {
      "serverUrl": "https://widget-data.service.elfsight.com/mcp/ai_chat"
    }
  }
}

Qué puedes preguntarle

• list_assistants — "¿Qué widgets de AI Chatbot tengo?"
• get_analytics — "¿Cómo ha funcionado mi AI Chatbot en los últimos 30 días?"
• search_conversations — "Muéstrame las conversaciones de la semana pasada sobre envíos."
• get_conversation — "¿Qué pasó en la conversación <id>?"
• list_leads — "Enumera los nuevos leads de esta semana que aún no he revisado."
• search_knowledge — "¿Mi base de conocimiento dice algo sobre reembolsos?"
• list_knowledge_gaps — "¿Qué preguntan los visitantes que mi asistente no puede responder?"
• answer_knowledge_gap — "Añade esto como respuesta a la base de conocimiento y cierra esa brecha."

answer_knowledge_gap es la única herramienta que escribe. Tres prompts listos para usar envuelven flujos de trabajo comunes de principio a fin: weekly_report, knowledge_gaps_review, lead_followup.

Privacidad

Todo lo que devuelve una herramienta puede enviarse a tu proveedor de IA (Anthropic, OpenAI, etc.) como parte de tu conversación con el agente. Tenlo en cuenta:

• Los campos de contacto de los leads están enmascarados por defecto. El nombre, el correo electrónico y el teléfono de un lead se devuelven enmascarados (p. ej., j***@example.com, +7***4567). Pasa contacts: "full" en get_conversation o list_leads para obtener los valores reales en esa llamada.
• El enmascaramiento cubre solo esos campos. El texto de los mensajes, las URL de las páginas y los enlaces de archivos adjuntos se devuelven tal cual. Los visitantes suelen escribir su correo o teléfono en el chat, por lo que get_conversation puede mostrar datos de contacto incluso cuando los campos del lead están enmascarados. Trata todo lo que devuelva una herramienta como posiblemente contenedor de datos personales.
• Los archivos adjuntos son enlaces, no contenido. Los archivos adjuntos se devuelven como URL, por lo que una llamada de herramienta nunca pone el contenido de un archivo en el contexto del modelo.

Las conversaciones internas y de prueba no se filtran de ninguna herramienta — si usas tu propio widget para pruebas, espera ver ese tráfico también en los resultados.

Límites y limitación de velocidad

• search_conversations, list_leads, search_knowledge y list_knowledge_gaps devuelven 20 elementos por defecto, 100 como máximo. Un resultado truncado lo indica y reporta el total. search_conversations y list_leads paginan con cursor; para los otros dos, acota la consulta.
• get_conversation devuelve los 100 mensajes más recientes por defecto, 500 como máximo.
• Los períodos son ventanas móviles que terminan ahora — 7d, 30d o 90d. No se admiten rangos de fechas arbitrarios. list_leads también acepta ningún período, lo que significa todo el historial.
• Las solicitudes tienen límite de velocidad por cuenta y cliente. Superar el límite devuelve un 429 con un encabezado Retry-After — espera y reintenta.

Soporte

Preguntas o problemas — contacta con el Centro de ayuda de Elfsight o con tu gestor de cuenta.