Conectar Hedy con asistentes de IA usando MCP

¿Que es el servidor MCP de Hedy?

El servidor MCP de Hedy permite a los asistentes de IA acceder de forma segura y ayudar a organizar sus datos de Hedy. Una vez conectado, puede pedirle a su IA que analice transcripciones de reuniones, encuentre destacados, revise elementos de accion, cree temas y gestione sus contextos de sesion, todo a traves de una conversacion natural.

MCP (Model Context Protocol) es un estandar abierto que permite a las aplicaciones de IA conectarse a fuentes de datos externas. El servidor MCP de Hedy utiliza autenticacion OAuth, lo que lo hace compatible con plataformas de IA basadas en web, aplicaciones de escritorio y herramientas de desarrollo.

Como conectar

Paso 1: Agregar el servidor

1. Abra la configuracion del servidor MCP de su cliente de IA

2. Busque “Add MCP Server”, “Connect Remote Server” o “Add Integration”

3. Ingrese la URL del servidor: https://api.hedy.bot/mcp

4. Haga clic en “Add” o “Connect”

Paso 2: Autorizar el acceso

1. Su cliente de IA abrira una ventana del navegador

2. Inicie sesion con su cuenta de Hedy

3. Revise los permisos solicitados

4. Haga clic en “Allow” para autorizar

5. Regrese a su cliente de IA

¡Eso es todo! No se necesitan archivos de configuracion ni API keys.

Clientes de IA compatibles

Funciona con cualquier cliente compatible con MCP que soporte servidores remotos:

• Plataformas de IA basadas en web - Asistentes de IA accesibles desde el navegador

• Aplicaciones de escritorio - Claude Desktop, BoltAI, Cursor, Windsurf, Zed

• Herramientas de desarrollo - VS Code con GitHub Copilot, Cline, Claude Code

• Plataformas de agentes de IA - Constructores de flujos de trabajo personalizados

Instrucciones de configuracion por cliente

Claude Code (CLI)

Agregue el servidor MCP de Hedy con un solo comando:

claude mcp add --transport http hedy https://api.hedy.bot/mcp

Esto activara el flujo de OAuth en su navegador. Inicie sesion con su cuenta de Hedy y autorice el acceso.

Claude Desktop (Pro/Max/Team/Enterprise)

1. Abra Claude Desktop y vaya a Settings

2. Desplacese hasta Integrations en la parte inferior

3. Haga clic en Add more (o Add integration)

4. Ingrese:

   • Integration name: Hedy

   • Integration URL: https://api.hedy.bot/mcp

5. Haga clic en Connect y complete el flujo de OAuth en su navegador

6. En chats nuevos, haga clic en el icono de herramientas para habilitar las herramientas de Hedy

Nota: Los usuarios del nivel gratuito necesitan usar el puente mcp-remote. Consulte el README del proyecto para la configuracion.

Cline (Extension de VS Code)

Opcion 1: A traves de la interfaz de Cline (Recomendado)

1. Abra VS Code con la extension Cline instalada

2. Haga clic en el icono de Cline en la barra lateral

3. Haga clic en el menu (⋮) y seleccione “MCP Servers”

4. Seleccione la pestana “Remote Servers”

5. Ingrese: Server Name: hedy, Server URL: https://api.hedy.bot/mcp, Transport Type: Streamable HTTP

6. Haga clic en “Add Server”

7. Haga clic en “Authenticate” cuando se le solicite y complete el flujo de OAuth en su navegador

Opcion 2: Configuracion JSON manual

1. Abra el archivo de configuracion MCP de Cline:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Agregue esta configuracion:

   {"mcpServers": {"hedy": {"url": "https://api.hedy.bot/mcp","type": "streamableHttp","disabled": false}}}

3. Guarde el archivo y reinicie VS Code

4. El flujo de OAuth se activara cuando Cline intente usar el servidor

BoltAI (macOS)

BoltAI se conecta a servidores MCP a traves de configuracion local. Dado que BoltAI no soporta nativamente servidores remotos con OAuth, necesitara el puente mcp-remote.

Requisitos: Node.js debe estar instalado en su Mac (node -v para verificar).

1. Abra BoltAI → Settings → Plugins, haga clic en el boton + para abrir mcp.json

2. Agregue la siguiente configuracion:

   {"mcpServers":{"hedy":{"command":"npx","args":["mcp-remote","https://api.hedy.bot/mcp"]}}}

3. Haga clic en Save Changes

4. En el primer uso, se abrira una ventana del navegador; inicie sesion con su cuenta de Hedy y autorice el acceso

Nota: El puente mcp-remote traduce el servidor remoto habilitado con OAuth en una conexion stdio local que BoltAI puede manejar. Despues de la primera autorizacion, el token se almacena en cache localmente.

Cursor / Windsurf / Otras herramientas de IDE

1. Abra la configuracion de MCP en su IDE

2. Agregue la URL del servidor: https://api.hedy.bot/mcp

3. Seleccione “HTTP” o “Streamable HTTP” como tipo de transporte

4. Autorice cuando se le solicite

Clientes de IA basados en web

1. Busque “Connect MCP Server” o “Add Integration”

2. Ingrese: https://api.hedy.bot/mcp

3. Complete la autorizacion OAuth en su navegador

Herramientas disponibles

El servidor MCP de Hedy proporciona 18 herramientas que su asistente de IA puede usar para acceder y organizar sus datos de reuniones:

Herramientas de sesion

GetSessions

Que hace: Lista sus sesiones de reuniones recientes, ordenadas por hora de inicio (mas recientes primero)

Parametros:

• limit (opcional) - Numero de sesiones a devolver (1-100)

• after (opcional) - ID de sesion para comenzar la paginacion despues

Ejemplos de solicitudes:

• “Muestrame mis ultimas 10 sesiones”

• “Lista todas las sesiones de esta semana”

• “¿Que reuniones tuve recientemente?”

GetSessionDetails

Que hace: Recupera los detalles completos de una sesion especifica, incluyendo metadatos, participantes y transcripcion

Parametros:

• sessionId (requerido) - El ID de la sesion

Ejemplos de solicitudes:

• “Muestrame los detalles de la sesion ABC123”

• “¿Que se discutio en mi ultima reunion de equipo?”

• “Obtener la transcripcion de la sesion de lanzamiento de producto”

GetSessionHighlights

Que hace: Devuelve todos los destacados capturados durante una sesion especifica

Parametros:

• sessionId (requerido) - El ID de la sesion

Ejemplos de solicitudes:

• “¿Que destacados guarde en la sesion ABC123?”

• “Muestrame los momentos clave del standup de ayer”

• “Lista todos los destacados de la reunion de presupuesto”

GetSessionToDos

Que hace: Lista todos los elementos pendientes generados durante una sesion especifica

Parametros:

• sessionId (requerido) - El ID de la sesion

• includeCompleted (opcional) - Si es verdadero, incluye tareas completadas (por defecto: solo tareas pendientes)

Ejemplos de solicitudes:

• “¿Que elementos de accion surgieron de la sesion ABC123?”

• “Muestrame las tareas de la reunion con el cliente, incluyendo las completadas”

• “Lista las tareas pendientes de la sesion de planificacion de ayer”

Herramientas de destacados

GetHighlights

Que hace: Lista sus destacados recientes de todas las sesiones, ordenados por mas recientes primero

Parametros:

• limit (opcional) - Numero de destacados a devolver (1-100)

• after (opcional) - ID de destacado para comenzar la paginacion despues

Ejemplos de solicitudes:

• “Muestrame mis ultimos 20 destacados”

• “¿Que he destacado esta semana?”

• “Lista los momentos clave recientes que he guardado”

GetHighlightDetails

Que hace: Recupera los detalles completos de un destacado especifico, incluyendo fragmento de transcripcion, marca de tiempo y contexto

Parametros:

• highlightId (requerido) - El ID del destacado

Ejemplos de solicitudes:

• “Muestrame el destacado XYZ789 en detalle”

• “¿Cual fue el contexto del destacado sobre el presupuesto?”

• “Obtener la transcripcion completa del destacado XYZ789”

Herramientas de tareas

GetToDos

Que hace: Devuelve todos los elementos pendientes de todas sus sesiones

Parametros:

• includeCompleted (opcional) - Si es verdadero, incluye tareas completadas (por defecto: solo tareas pendientes)

Ejemplos de solicitudes:

• “¿Cuales son todos mis elementos de accion pendientes?”

• “Muestrame todas las tareas, incluyendo las completadas”

• “Lista todo lo que necesito hacer de mis reuniones”

Herramientas de temas

Los asistentes de IA pueden ver sus temas y tambien ayudarle a organizarlos creando nuevos temas, actualizando los existentes o eliminando temas que ya no necesita.

GetAllTopics

Que hace: Lista todos sus temas y carpetas de reuniones

Parametros:

• includeArchived (opcional) - Si es verdadero, incluye temas archivados (por defecto: solo temas activos)

Ejemplos de solicitudes:

• “¿Que temas tengo en Hedy?”

• “Lista todas mis categorias de reuniones”

• “Muestrame todos los temas incluyendo los archivados”

GetTopicDetails

Que hace: Recupera los detalles de un tema especifico, incluyendo descripcion, cantidad de sesiones e informacion generada por IA

Parametros:

• topicId (requerido) - El ID del tema

Ejemplos de solicitudes:

• “Muestrame los detalles del tema Reuniones con Clientes”

• “¿Cuantas sesiones hay en mi tema Standups del Equipo?”

• “¿Que informacion tiene Hedy sobre mi tema de Planificacion de Producto?”

GetTopicSessions

Que hace: Lista todas las sesiones asociadas con un tema especifico

Parametros:

• topicId (requerido) - El ID del tema

Ejemplos de solicitudes:

• “Muestrame todas las sesiones en el tema Planificacion de Producto”

• “Lista las reuniones etiquetadas con Reuniones con Clientes”

• “¿Que sesiones hay en mi carpeta de 1:1s?”

CreateTopic

Que hace: Crea un nuevo tema para organizar sus sesiones de reuniones

Parametros:

• name (requerido) - Nombre del tema (maximo 100 caracteres)

• description (opcional) - Descripcion del tema (maximo 500 caracteres)

• color (opcional) - Color para el tema (ej. #FF5733)

• iconName (opcional) - Nombre del icono para el tema

• topicContext (opcional) - Instrucciones personalizadas para el analisis de IA de las sesiones en este tema

Ejemplos de solicitudes:

• “Crear un nuevo tema llamado Planificacion Q1”

• “Crear un tema para llamadas con clientes con color azul”

• “Configurar una nueva categoria para sesiones de entrevistas”

UpdateTopic

Que hace: Actualiza el nombre, descripcion, color u otras configuraciones de un tema existente

Parametros:

• topicId (requerido) - El ID del tema a actualizar

• name (opcional) - Nuevo nombre para el tema

• description (opcional) - Nueva descripcion

• color (opcional) - Nuevo color

• iconName (opcional) - Nuevo icono

• topicContext (opcional) - Nuevas instrucciones personalizadas para el analisis de IA

Ejemplos de solicitudes:

• “Renombrar el tema Planificacion Q1 a Planificacion Q2”

• “Cambiar el color de mi tema Reuniones con Clientes a verde”

• “Actualizar la descripcion de mi tema Standups del Equipo”

DeleteTopic

Que hace: Elimina un tema. Las sesiones que estaban en el tema se conservan pero ya no se agrupan bajo el.

Parametros:

• topicId (requerido) - El ID del tema a eliminar

Ejemplos de solicitudes:

• “Eliminar el antiguo tema Proyecto Alpha”

• “Quitar mi tema no utilizado de Preparacion de Entrevistas”

• “Deshacerse del tema llamado Test”

Herramientas de contexto de sesion

Los contextos de sesion le permiten proporcionar informacion de fondo que Hedy utiliza al analizar sus reuniones. Los asistentes de IA pueden ayudarle a ver y gestionar estos contextos.

ListSessionContexts

Que hace: Lista todos sus contextos de sesion guardados, ordenados por los actualizados mas recientemente

Ejemplos de solicitudes:

• “Muestrame todos mis contextos de sesion”

• “¿Que contextos de fondo tengo configurados?”

• “Lista mis perfiles de contexto de reunion”

GetSessionContext

Que hace: Recupera los detalles de un contexto de sesion especifico

Parametros:

• contextId (requerido) - El ID del contexto a recuperar

Ejemplos de solicitudes:

• “Muestrame los detalles de mi contexto de Trabajo”

• “¿Que hay en mi contexto de sesion predeterminado?”

CreateSessionContext

Que hace: Crea un nuevo contexto de sesion con informacion de fondo para que Hedy la use durante el analisis

Parametros:

• title (requerido) - Titulo para el contexto (maximo 200 caracteres)

• content (opcional) - La informacion de fondo e instrucciones

• isDefault (opcional) - Establecer este como su contexto predeterminado

Ejemplos de solicitudes:

• “Crear un nuevo contexto llamado Llamadas de Ventas con informacion sobre mis productos”

• “Configurar un contexto para mis reuniones del equipo de ingenieria”

• “Crear un nuevo contexto predeterminado con mi rol de trabajo y responsabilidades”

UpdateSessionContext

Que hace: Actualiza un contexto de sesion existente

Parametros:

• contextId (requerido) - El ID del contexto a actualizar

• title (opcional) - Nuevo titulo

• content (opcional) - Nueva informacion de fondo

• isDefault (opcional) - Establecer como contexto predeterminado

Ejemplos de solicitudes:

• “Actualizar mi contexto de Trabajo con mi nueva estructura de equipo”

• “Agregar informacion sobre nuestros objetivos Q2 a mi contexto predeterminado”

• “Cambiar mi contexto de Ventas para que sea el predeterminado”

DeleteSessionContext

Que hace: Elimina un contexto de sesion. Si elimina su contexto predeterminado, otro se convertira automaticamente en el predeterminado.

Parametros:

• contextId (requerido) - El ID del contexto a eliminar

Ejemplos de solicitudes:

• “Eliminar mi antiguo contexto del Proyecto X”

• “Quitar el contexto que ya no estoy usando”

Flujos de trabajo de ejemplo

Revision semanal

Pregunte a su IA: “Muestrame mis sesiones de esta semana, lista todas las tareas pendientes y destaca los elementos importantes”

Que sucede: La IA usa GetSessions con filtrado de fechas, luego GetToDos para encontrar elementos de accion, y puede profundizar en sesiones especificas para obtener detalles.

Preparacion de reuniones

Pregunte a su IA: “Encuentra todas las sesiones sobre la hoja de ruta Q4 y resume los puntos clave”

Que sucede: La IA busca entre las sesiones, usa GetSessionDetails y GetSessionHighlights para recopilar informacion, y luego crea un resumen.

Gestion de tareas

Pregunte a su IA: “Muestrame todos los elementos de accion de las reuniones con clientes de este mes”

Que sucede: La IA usa GetAllTopics para encontrar el tema de Reuniones con Clientes, GetTopicSessions para listar las sesiones, y luego GetSessionToDos para cada una para compilar la lista.

Analisis de temas

Pregunte a su IA: “Analiza mis sesiones de Standup del Equipo e identifica temas recurrentes”

Que sucede: La IA encuentra el tema, recupera todas las sesiones en el, lee transcripciones y destacados, y luego realiza el analisis.

Organizacion de sus datos

Pregunte a su IA: “Crear un nuevo tema llamado Planificacion Q2 y configurar un contexto para nuestras revisiones trimestrales”

Que sucede: La IA usa CreateTopic para crear el nuevo tema, y luego CreateSessionContext para establecer informacion de fondo para un mejor analisis de reuniones.

Privacidad y seguridad

• OAuth 2.1 con PKCE - Autenticacion segura de estandar industrial

• Usted controla el acceso - Autorice exactamente lo que la IA puede hacer con sus datos

• Los datos de sesion estan protegidos - La IA puede ayudar a organizar temas y contextos, pero no puede eliminar sus grabaciones de reuniones ni transcripciones

• Solo bajo demanda - Los datos se acceden solo cuando usted hace solicitudes

• Revoque en cualquier momento - Puede desconectar el acceso de la IA en cualquier momento desde la configuracion de Hedy

Requisitos

• Suscripcion activa de Hedy (Pro o Premium)

• Cloud Sync habilitado en su configuracion de Hedy

• Un asistente de IA que soporte MCP (como Claude)

Solucion de problemas

El cliente de IA no tiene la opcion “Add MCP Server”

• Verifique si su cliente soporta servidores MCP remotos

• Actualice a la ultima version

• Busque la configuracion de MCP en las preferencias

• Algunos clientes solo soportan servidores locales y necesitan configuracion manual

La autorizacion falla

• Asegurese de haber iniciado sesion en Hedy

• Verifique que su cuenta este activa

• Borre la cache del navegador e intente de nuevo

• Verifique la conexion a internet

• Intente abrir https://api.hedy.bot/mcp/.well-known/oauth-protected-resource para verificar que el servidor sea accesible

La IA no puede acceder a mis datos

• Confirme que la autorizacion OAuth se completo

• Verifique que tiene sesiones en su cuenta de Hedy

• Revise el estado de autorizacion en la configuracion del cliente de IA

• Intente desconectar y reconectar

La conexion dejo de funcionar

• El token de acceso puede haber expirado; vuelva a autorizar

• Si cambio su contrasena de Hedy, vuelva a autorizar

• Consulte status.hedy.bot para problemas del servicio

• Elimine y vuelva a agregar el servidor

El cliente requiere configuracion manual de OAuth

• Si su cliente no soporta descubrimiento automatico, use esta configuracion:

  • Authorization URL: https://api.hedy.bot/mcp/oauth/authorize

  • Token URL: https://api.hedy.bot/mcp/oauth/token

  • Scopes: mcp.sessions.read mcp.highlights.read mcp.todos.read mcp.topics.read mcp.topics.write mcp.contexts.read mcp.contexts.write

La IA dice que una herramienta fallo o devolvio un error

• Verifique que el ID de sesion/destacado/tema sea valido

• Compruebe que tiene permiso para acceder a esos datos

• Asegurese de que los datos solicitados existan en su cuenta

• Intente preguntar de manera mas especifica (ej. incluya titulos de sesiones en lugar de IDs)

• Verifique si hay limitacion de velocidad; espere un momento e intente de nuevo

Mejores practicas

Para mejores resultados

• Use titulos de sesion claros - Facilita que la IA los encuentre

• Organice con temas - Agrupe sesiones relacionadas

• Cree destacados durante las reuniones - Ayuda a la IA a identificar momentos clave

• Agregue notas descriptivas a las tareas - Hace que los elementos de accion sean mas faciles de buscar

• Sea especifico en sus solicitudes - Incluya fechas, temas o palabras clave

Al preguntar a su IA

• Especifique rangos de tiempo - “Mostrar sesiones de la semana pasada” es mas claro que “Mostrar sesiones recientes”

• Mencione temas cuando sea relevante - “Sesiones de reuniones con clientes” vs “todas las sesiones”

• Pida resumenes - La IA puede sintetizar datos de multiples herramientas

• Solicite formatos especificos - “Crear una lista con vinnetas” o “Hacer una tabla”

• Haga preguntas de seguimiento - La IA puede profundizar en los resultados

Consejo profesional: La IA puede combinar multiples herramientas en una sola solicitud. Intente hacer preguntas complejas como “Encontrar todas las tareas pendientes de reuniones con clientes de este mes y organizarlas por prioridad” o “Crear un nuevo tema para nuestros lanzamientos de producto y listar todas las sesiones que deberian ir ahi” para ver el poder de la integracion MCP.

¿Necesita ayuda?

• Consulte la documentacion de MCP de su cliente de IA para instrucciones especificas del cliente

• Visite modelcontextprotocol.io para informacion general sobre MCP

• Contacte al soporte de Hedy con mensajes de error y el nombre de su cliente de IA