> ## Documentation Index > Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectar un agente de IA con Remote MCP > Usa Alter como servidor MCP remoto para reuniones, actions guardadas y conversaciones en tu Mac MCP Gateway permite que un agente de IA compatible invoque las herramientas de Alter mediante una URL HTTPS privada. Úsalo para buscar reuniones, leer transcripciones, ejecutar actions guardadas permitidas e iniciar o continuar conversaciones de Alter. Alter ejecuta las herramientas en tu Mac. Un relay de Alter conecta el agente de IA con la app en ejecución. No hace falta exponer un puerto de tu Mac ni ejecutar un comando MCP local independiente. > [!TIP] > > ¿Usas ChatGPT para escritorio? Sigue [Usar Alter en ChatGPT](/es/apps-tools/gateways-chatgpt.md) para instalar el plugin. Esta guía describe la conexión Remote MCP para agentes compatibles. ## Antes de empezar * Inicia sesión en Alter en tu Mac. * Usa un agente de IA que permita añadir la URL de un **servidor MCP HTTPS remoto**. Un cliente que solo admite un comando local no puede usar esta URL directamente. * Mantén tu Mac conectado a Internet y Alter en ejecución mientras usas la conexión. > [!NOTE] > > ChatGPT es la primera integración probada. La compatibilidad de otros clientes con el endpoint Remote MCP de Alter aún no se ha verificado de extremo a extremo. La compatibilidad con herramientas y suscripciones a eventos puede variar dentro del mismo cliente. ## Activar MCP Gateway **1. Abrir Gateways en Alter** Pulsa **⌘,** para abrir **Settings** y selecciona **Gateways** en **Integrations**. Elige **Add gateway → MCP Gateway** o abre un MCP Gateway existente. **2. Elegir el acceso y guardar** Activa **Enabled**. En **Allowed access**, activa las funciones que quieras que use el agente. Para una prueba de lectura de reuniones, activa **Read meeting transcripts**. Elige **Save and restart** y espera a que la conexión esté lista. ![Ajustes de MCP Gateway de Alter con Enabled activado y los controles de conexión](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9) Activa MCP Gateway y guarda la conexión antes de añadirla a tu agente de IA. **3. Copiar la URL de conexión** Elige **Copy connection URL** en la sección **Connection**. Este es tu endpoint Remote MCP privado. Mantén en privado la URL completa, incluida la clave del final. ## Añadir Alter a tu agente de IA Abre los ajustes MCP o de integraciones del agente y añade un servidor remoto con estos valores: | Campo | Valor | | - | - | | Nombre | **Alter** | | Server URL | Pega la URL completa de **Copy connection URL**. | | Authentication | **No authentication** o la opción equivalente del cliente. El acceso ya está incluido en la URL privada. | Guarda la conexión y actualiza o descubre sus herramientas. Las etiquetas exactas dependen del cliente. No necesitas una clave API adicional ni iniciar sesión con OAuth para esta conexión. Empieza con una solicitud de solo lectura: > Enumera mis reuniones recientes de Alter. Es posible que el agente te pida aprobar una llamada a una herramienta. Si no aparecen reuniones, confirma que tengas reuniones guardadas en Alter y que el acceso a las transcripciones esté activado. ## Elegir el acceso permitido ![Sección Allowed access de MCP Gateway de Alter con los controles de reuniones, actions, chat e historial](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec) Activa solo las funciones que quieras permitir al agente conectado. | Ajuste | Herramientas y comportamiento | | - | - | | **Read meeting transcripts** | `list_meetings`, `search_meetings` y `get_meeting_transcript` enumeran y buscan reuniones guardadas, y luego leen una transcripción seleccionada. | | **Run saved actions** | `list_actions` y `run_action` descubren y ejecutan actions guardadas permitidas para este gateway. | | **Chat with Alter** | `create_conversation` y `send_message` inician y continúan conversaciones con las actions permitidas. | | **Read conversation history** | `list_conversations`, `search_conversations` y `get_conversation` buscan y leen conversaciones cuyas actions estén permitidas para este gateway. | | **Notify when transcripts are ready** | Permite eventos de transcripción lista para clientes compatibles que tengan una suscripción activa. Consulta [Compatibilidad con eventos](#compatibilidad-con-eventos) para conocer las restricciones actuales. | Las funciones desactivadas se quitan de las herramientas disponibles y no se pueden usar invocándolas directamente. Después de cambiar el acceso, elige **Save and restart** y actualiza las herramientas del agente. Al reiniciar el gateway se cancelan las tareas activas que lo usan. ### Action predeterminada y actions guardadas En **Behavior**, elige la **Default action** para los chats nuevos. **Ask Anything** suele ser la opción predeterminada. Para otra action guardada, abre **Action Editor → Gateways** y activa **MCP Gateway** o **All**. La lista **Available actions** del gateway muestra cuáles están permitidas. El agente también necesita acceso **Run saved actions** para descubrirlas y ejecutarlas. Las conversaciones nuevas de **Ask Anything** usan el espacio de trabajo predeterminado de Alter. Las demás actions usan el espacio de trabajo configurado para ellas. Al continuar una conversación se conservan su espacio de trabajo y los permisos de sus actions. ## Prueba estas solicitudes | Objetivo | Ejemplo de solicitud | | - | - | | Buscar una reunión por tema | «Busca en mis reuniones de Alter menciones a los precios y resume las conversaciones que coincidan». | | Revisar reuniones recientes | «Enumera mis reuniones recientes de Alter y luego lee la transcripción más reciente». | | Descubrir actions guardadas | «¿Qué Alter Actions puedes ejecutar con esta conexión?» | | Iniciar un chat de Alter | «Pide a Alter que revise los archivos recientes de su espacio de trabajo actual sin modificarlos». | | Buscar conversaciones anteriores | «Encuentra mis conversaciones anteriores de Alter sobre incorporación de personal». | La búsqueda de reuniones encuentra términos en el contenido indexado de las reuniones. La búsqueda de conversaciones encuentra títulos y mensajes indexados. Si necesitas más detalles, pide al agente que lea la transcripción o conversación coincidente. ### Preguntas y permisos Los chats y las actions pueden devolver un ID de tarea mientras Alter trabaja. El agente usa `get_task` para recuperar el resultado y puede usar `cancel_task` para detener una tarea en curso. Una tarea de Alter puede pausarse para hacer una pregunta o solicitar acceso a un archivo. El agente debe mostrarte la pregunta y las opciones, esperar tu respuesta y enviársela a Alter antes de continuar. Las opciones de permiso pueden incluir **Allow once**, **Always allow** o rechazar el acceso. La conexión no aprueba estas solicitudes automáticamente. Si el agente sigue esperando sin mostrarte una pregunta, pídele que revise la pregunta pendiente de la tarea y que use la herramienta disponible `answer_questions` después de que respondas. ## Compatibilidad con eventos El acceso a herramientas remotas no crea automáticamente una suscripción a eventos. La compatibilidad con eventos también depende del agente de IA y del modo seleccionado. Actualmente, Alter solo acepta destinos de webhook de transcripción lista en dominios de ChatGPT/OpenAI. Otros agentes MCP pueden usar herramientas compatibles, pero no se admiten destinos de eventos arbitrarios de terceros. Consulta [Avisos de reuniones en ChatGPT](/es/apps-tools/gateways-chatgpt.md#recibir-avisos-de-reuniones-nuevas) para configurar la suscripción compatible. ## Privacidad y disponibilidad La URL de conexión concede los permisos que habilites para este gateway. Trátala como una contraseña y guárdala solo en clientes de confianza. Las herramientas se ejecutan en Alter en tu Mac. Las solicitudes y los resultados pasan por el relay de Alter, incluido el texto de las transcripciones cuando el agente lo solicita. Tus reuniones y conversaciones guardadas permanecen en Alter; el agente conectado recibe los datos que devuelvan sus llamadas permitidas. Mantén Alter en ejecución y tu Mac conectado a Internet. Al desactivar el gateway se detiene el acceso y se cancelan sus tareas activas. Si lo eliminas y vuelves a crear, se generará una URL de conexión nueva; sustitúyela en cada cliente conectado. ## Solución de problemas | Síntoma | Qué comprobar | | - | - | | El cliente solo ofrece un campo de comando o ejecutable | Elige un cliente o tipo de conexión compatible con una URL MCP HTTPS remota. | | El servidor no se conecta | Confirma que Alter esté en ejecución y que MCP Gateway esté activado y conectado. Prueba **Reconnect** en la sección **Connection** de Alter y actualiza el cliente. Reconectar cancela las tareas activas del gateway. | | Faltan herramientas | Activa la opción correspondiente en **Allowed access**, guarda los cambios y actualiza la lista de herramientas del agente. Para las actions, comprueba también **Action Editor → Gateways**. | | Una tarea está esperando | Comprueba si Alter necesita una respuesta explícita o una decisión sobre el acceso a un archivo. | | Las herramientas funcionan, pero los eventos no | Comprueba el cliente y el modo. Los destinos de eventos actuales se limitan a dominios de ChatGPT/OpenAI y requieren una suscripción activa. | | Se perdió el acceso tras cambiar la cuenta de Alter o volver a crear un gateway | Copia la URL de conexión actual y sustitúyela en el agente. | ## Páginas relacionadas * [Usar Alter en ChatGPT](/es/apps-tools/gateways-chatgpt.md) * [Resumen de Gateways](/es/apps-tools/gateways.md) * [Alter Actions](/es/workflows/alter-actions.md) * [Datos locales y privacidad](/es/references/local-data-and-privacy.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.