Saltar al contenido principal
Indice de documentacion Antes de explorar paginas individuales, consulta el indice completo en https://help.eazybe.com/llms.txt para conocer los temas disponibles.

Conectar el Servidor MCP de Eazybe con Herramientas de IA

Conecta tu workspace de Eazybe a Claude Code, Claude Desktop, ChatGPT, OpenAI Codex o cualquier herramienta de IA compatible con MCP, dandole acceso directo a tu CRM, conversaciones de WhatsApp, analiticas de equipo, campanas y mas.
El servidor MCP (Model Context Protocol) de Eazybe te permite consultar y gestionar tu workspace de Eazybe directamente desde cualquier herramienta de IA que soporte el estandar MCP. Una vez conectado, puedes buscar registros de CRM, leer conversaciones con clientes, consultar analiticas de equipo, inspeccionar campanas y realizar operaciones del workspace, todo mediante lenguaje natural.

Herramientas de IA Compatibles

El servidor MCP de Eazybe funciona con cualquier herramienta que soporte el Model Context Protocol, incluyendo:
  • Claude Code — Asistente de IA de Anthropic para programacion (app de escritorio o extension de VS Code)
  • Claude Desktop — App de escritorio de Anthropic para Claude con soporte MCP
  • ChatGPT — Asistente de IA de OpenAI con soporte de conectores MCP
  • OpenAI Codex — Asistente de programacion de OpenAI con soporte MCP
  • Cualquier cliente compatible con MCP — Cursor, Windsurf, Cline y otras herramientas que soporten servidores MCP
[!NOTE] Los pasos de configuracion son similares en todas las herramientas. Elige tu herramienta de IA a continuacion para ver las instrucciones especificas.

Lo que Necesitas Antes de Empezar

Asegurate de tener lo siguiente listo:
  • Claude Code — la app de escritorio o la extension de VS Code, instalada y funcionando
  • Una cuenta de workspace de Eazybe — con acceso de administrador o usuario autorizado
  • Tu URL del servidor MCP de Eazybe — tu equipo de desarrollo o administrador del workspace te la proporcionara

Paso 1: Abrir la Configuracion del Servidor MCP en Claude Code

1. Abre Claude Code en tu computadora (app de escritorio o VS Code).2. Abre el panel de servidores MCP. Puedes encontrarlo haciendo clic en el icono MCP en la barra lateral, o a traves de Settings > MCP Servers.Veras una lista de servidores MCP. Si es tu primera vez, la lista puede estar vacia o mostrar solo los servidores predeterminados de Claude (Claude Docs, Google Drive, Notion).

Paso 2: Agregar el Servidor de Eazybe

1. Haz clic en “Add MCP Server” (o el boton +) para agregar un nuevo servidor.2. Ingresa los detalles del servidor:
[!NOTE] La URL del servidor depende de tu entorno. Tu equipo de desarrollo te dara la URL correcta. Generalmente termina en /sse. Si no estas seguro, pregunta a tu administrador del workspace antes de continuar.
3. Haz clic en Save.El servidor aparece en tu lista de servidores MCP. Veras una insignia de estado “Connecting…” junto a el.Eazybe server appearing in the MCP servers list with Connecting statusEl servidor de Eazybe aparece bajo “User” con una insignia amarilla “Connecting…”.

Paso 3: Autenticar tu Conexion

El primer intento de conexion generalmente se agotara despues de 30 segundos. Esto es esperado — el servidor necesita que inicies sesion antes de poder conectarse.1. Veras un estado “Failed” con un mensaje de error: “MCP server eazybe connection timed out after 30000ms”.2. Haz clic en el boton “Authenticating…”. Esto abre una ventana del navegador donde puedes iniciar sesion.Connection failed screen showing timeout error and Authenticating buttonHaz clic en el boton amarillo “Authenticating…” para abrir la pagina de inicio de sesion en tu navegador.3. Inicia sesion con tus credenciales de Eazybe en la ventana del navegador que se abre. Usa el mismo correo electronico y contrasena que usas para iniciar sesion en tu workspace de Eazybe.4. Veras una pagina de confirmacion de exito una vez que la autenticacion este completa.Authentication successful confirmation page“Authentication successful” — ahora puedes cerrar esta pestana del navegador y volver a Claude Code.5. Cierra la pestana del navegador y regresa a Claude Code.

Paso 4: Reconectar y Confirmar

1. De vuelta en Claude Code, el servidor puede seguir mostrando Failed. Haz clic en “Reconnect”.2. El servidor deberia mostrar ahora una insignia verde “Connected”.Eazybe server showing Connected status with green badgeLa insignia verde “Connected” confirma que el servidor esta listo. Tambien veras opciones para Reconnect, Clear authentication, Disable y Remove.
[!NOTE] Si Reconnect no funciona, haz clic en “Clear authentication” y repite el Paso 3 desde el principio. Asegurate de estar usando las credenciales correctas de tu workspace de Eazybe.

Paso 5: Verificar que tus Herramientas estan Cargadas

1. Haz clic en “View tools” en la parte inferior del panel de detalles del servidor.2. Deberias ver 19 o mas herramientas listadas. Estas son las operaciones MCP que Claude puede usar en tu workspace.View tools link showing 19 available toolsHaz clic en “View tools (19)” para confirmar que todas las herramientas se cargaron correctamente. Si ves 0 herramientas, desconecta y reconecta el servidor.

Paso 6: Ejecutar tu Primera Consulta

1. Abre un nuevo chat en Claude Code.2. Escribe esta consulta de prueba:
3. Claude llamara a la herramienta business_capabilities y devolvera la lista completa de operaciones de tu workspace.4. Una respuesta exitosa muestra:
  • Tu ID de organizacion y detalles del plan
  • Proveedores conectados (ej., HubSpot, Google Calendar)
  • Numero total de operaciones disponibles
  • Cualquier limitacion de disponibilidad First query results showing workspace plan, operations, and readiness limitations
Una primera consulta exitosa confirma que tu conexion MCP esta funcionando completamente.Si ves esta respuesta, tu configuracion esta completa. Ahora puedes usar Claude para consultar tu workspace de Eazybe.

Lo que Puedes Hacer una vez Conectado

Una vez conectado el servidor MCP, puedes pedirle a tu herramienta de IA que:
  • Busque registros de CRM — encuentra deals, contactos, empresas o tickets por cualquier campo, propietario, fecha o etapa
  • Consulte analiticas de equipo — ve la actividad de mensajeria, rendimiento de representantes y comparaciones semana a semana
  • Lea conversaciones con clientes — busca mensajes de WhatsApp en varios idiomas, lee hilos completos, verifica quien esta esperando una respuesta
  • Inspeccione campanas y broadcasts — lista campanas, verifica tasas de entrega y lectura, ve estados individuales de destinatarios
  • Previsualice plantillas — ve mensajes de plantilla renderizados con valores de prueba, sin enviar nada
  • Consulte el saldo del wallet — ve tu saldo de creditos de mensajeria y moneda
  • Liste agentes y etiquetas — inspecciona agentes de IA, su disponibilidad, versiones y etiquetas de negocio con estructuras de embudo
  • Gestione registros de CRM — crea, actualiza o archiva deals, contactos, empresas y tickets (requiere tu aprobacion explicita)
[!NOTE] Todas las operaciones de escritura requieren tu aprobacion explicita. Tu herramienta de IA siempre te mostrara la accion exacta (que se creara, cambiara o eliminara) y esperara a que confirmes antes de realizar cualquier cambio. No se envian mensajes y no se modifican registros sin tu permiso.

Solucion de Problemas

La conexion se agota despues de 30 segundos Esto significa que se necesita autenticacion. Busca un boton “Authenticating” o una ventana del navegador. Inicia sesion con tus credenciales de Eazybe, luego reconecta. El servidor muestra “Failed” despues de la autenticacion Haz clic en Reconnect. Si sigue fallando, limpia cualquier autenticacion guardada y repite los pasos de inicio de sesion. Asegurate de estar usando las credenciales correctas de tu workspace de Eazybe. Las herramientas muestran 0 o no se estan cargando El servidor puede necesitar una actualizacion. Desconecta el servidor de Eazybe, reconectalo y comienza una nueva conversacion. Si las herramientas siguen sin aparecer, verifica con tu equipo de desarrollo que el servidor MCP este funcionando. “access_verified: false” en todas las operaciones Esto es normal y esperado. Significa que la conexion existe, pero cada fuente de datos se verifica la primera vez que ejecutas una consulta contra ella. Si una consulta especifica falla con un error de permisos, verifica los permisos de tu rol en Eazybe o cuenta de HubSpot. Error “connection_store_unavailable” en una consulta Este es un problema intermitente del backend. Simplemente reintenta la misma consulta — generalmente funciona en el segundo intento. Si sigue ocurriendo, el servidor MCP puede necesitar un reinicio por parte del equipo de desarrollo. Google Calendar muestra “connected” pero las consultas de calendario fallan La herramienta read_calendar_events no esta actualmente expuesta a traves del conector MCP. Las consultas relacionadas con el calendario (disponibilidad de reuniones, demos agendadas) no funcionaran hasta que se agregue esta herramienta. Contacta al equipo de desarrollo para solicitarla. Tu herramienta de IA dice “most tools aren’t loaded” o “status: refresh_required” Desconecta el servidor MCP de Eazybe en tu configuracion, reconectalo y comienza una nueva conversacion. Esto ocurre cuando el token de sesion ha expirado y necesita una conexion nueva.
Ultima actualizacion: Noviembre 2026