> For the complete documentation index, see [llms.txt](https://boundaryai.gitbook.io/boundaryai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boundaryai.gitbook.io/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/mcp.md). # Conecta asistentes de IA (MCP) Permita que Claude, ChatGPT y otros asistentes de IA consulten sus análisis de comentarios. BAI Analytics expone un **servidor MCP** (Model Context Protocol), así que los asistentes de IA pueden responder preguntas como *"¿cuáles son las principales quejas en Customer Support EU este mes?"* directamente desde tus comentarios analizados. MCP es el estándar abierto que usan las herramientas de IA para acceder a datos externos; Claude, ChatGPT y un conjunto cada vez mayor de clientes lo hablan de forma nativa. Todo funciona desde **Integraciones → Asistentes de IA** en el panel. Hay dos formas de conectarse, y ambas son de solo lectura de principio a fin: | Forma de acceso | Ideal para | Cómo se concede el acceso | | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Inicia sesión desde tu asistente** (OAuth) | Usuarios de Claude y ChatGPT que quieren que su propio asistente se conecte sin tener que gestionar claves. | Inicias sesión en BAI Analytics desde el asistente y luego apruebas la conexión en la página de asistentes de IA. El acceso es personal y revocable por conexión. | | **Conectarse con una clave de acceso** (Configuración avanzada) | Claude Code, Claude Desktop y cualquier otro cliente MCP que pueda enviar un `Authorization` encabezado. | Un administrador crea una `mcp_read` clave; la clave hereda el acceso de la persona que la creó. | Sea cual sea la opción que uses, el asistente ve lo mismo que ve un miembro de la organización, y nada de lo que haga a través de MCP puede modificar tus datos. *** ### Qué puede hacer el asistente Siete herramientas de solo lectura, enumeradas en vivo en la página de asistentes de IA exactamente como el servidor se las informa a un cliente: | Herramienta | Respuestas | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `list_sources` | Qué grupos y fuentes de comentarios existen, y qué tamaño tienen. El punto de partida: todas las demás herramientas usan los ids que devuelve. | | `get_source_analysis` | La distribución del sentimiento, los temas y las coincidencias con monitores de una fuente, a lo largo de toda su historia (cada período analizado combinado para grupos con seguimiento temporal). | | `list_themes` | Los temas agrupados de un grupo de comentarios, primero los más comentados, con menciones, sentimiento, criticidad y un resumen de IA. Lee la misma agrupación que muestra el panel; pasa un `period_key` para leer la agrupación propia de un período. | | `get_theme_verbatims` | Los comentarios reales de clientes que el análisis asignó a un tema agrupado (los mismos que lista la vista de Evidencias), opcionalmente acotados por subtema, sentimiento o período. | | `search_feedback` | Elementos individuales de comentarios que llegaron a través de la API, filtrados por fuente o campo. Las respuestas nativas de encuestas dentro de la app no se incluyen. | | `list_monitors` | Monitores de Monitorización personalizada de un grupo de comentarios, con sus ajustes de alerta, cobertura y recuentos de coincidencias. | | `get_sentiment_trend` | Sentimiento y volumen a lo largo del tiempo para un grupo de comentarios con seguimiento de tendencias activado. | Los resultados están paginados y dimensionados para el contexto de un modelo; las descripciones de las herramientas le dicen al asistente cómo paginar y qué significa cada campo, así que una buena primera pregunta es simplemente *"Muéstrame mis grupos de comentarios y luego ayúdame a entender las principales preocupaciones de los clientes en uno de ellos."* *** ### Inicia sesión desde tu asistente (Claude, ChatGPT) Este es el camino guiado en la página de asistentes de IA. Recorre cuatro pasos: **Elegir → Conectar → Aprobar → Preguntar**. 1. **Actívalo una vez para la organización.** Un administrador de la organización activa *Activar para esta organización*. Hasta entonces, los miembros verán que un administrador debe habilitar el acceso al asistente. Las conexiones basadas en inicio de sesión también tienen que estar habilitadas para tu entorno por el equipo de BAI Analytics; si la página dice que el asistente aún no está disponible, contacta con soporte y di qué asistente quieres. 2. **Elige** tu asistente (Claude o ChatGPT) y di si BAI Analytics ya aparece en él. Si el administrador de tu espacio de trabajo ya ha añadido BAI Analytics, solo necesitas abrirlo en tu asistente y seleccionar *Conectar*. 3. **Conectar.** Para una configuración inicial, la página muestra cada valor que el asistente solicita: el nombre de la conexión, la dirección del servidor que debes pegar y los ajustes de autenticación (OAuth; la página te indica si debes dejar vacíos los ajustes del cliente o pegar un ID de cliente, y nunca hay un secreto de cliente). En Claude eso es *Personalizar → Conectores → + → Añadir conector personalizado*; en ChatGPT en la web es *Plugins → Añadir → Añadir servidor MCP* después de activar el modo de desarrollador en *Configuración → Seguridad e inicio de sesión*. Cuando el asistente te lo pida, inicia sesión en BAI Analytics, elige la misma organización que usas en el panel y अनुमति la solicitud de inicio de sesión. 4. **Aprueba.** Vuelve a la página de asistentes de IA. La nueva conexión aparece como *Pendiente de tu aprobación*; revísala y elige *Permitir acceso de solo lectura*. Iniciar sesión por sí solo nunca expone ningún comentario: hasta que apruebes, el asistente solo puede inicializar y listar las herramientas. Solo la persona que conectó puede aprobar su propia conexión; los administradores pueden desconectar cualquier conexión, pero no pueden aprobarla en nombre de otra persona. 5. **Preguntar.** De vuelta en tu asistente, habilita BAI Analytics para la conversación y empieza con la primera pregunta sugerida. Las conexiones se enumeran en la página con su estado (*Pendiente de tu aprobación*, *Acceso autorizado*, *Desconectado*) y la hora de la última solicitud exitosa. Desconectar una conexión deniega de inmediato la siguiente solicitud del asistente; desactivar el acceso del asistente para la organización desconecta todas las conexiones basadas en inicio de sesión, y volver a activarlo no las restaura. Las claves de acceso son independientes de todo esto. {% hint style="info" %} BAI Analytics no es un conector preinstalado en estos asistentes, así que el paso en el asistente anterior es una configuración única. Para un espacio de trabajo de empresa, la página también ofrece un **Publicar BAI en tu espacio de trabajo** kit: valores paso a paso que un administrador de ChatGPT, Claude, Gemini Enterprise o Microsoft 365 Copilot introduce una sola vez para que cada miembro pueda conectarse, además de un mensaje listo para enviar si tú no eres ese administrador. {% endhint %} *** ### Conectarse con una clave de acceso (Configuración avanzada) Para Claude Code, Claude Desktop, agentes que ejecutas tú mismo o cualquier cliente que pueda enviar un encabezado bearer. Abre **Configuración avanzada** en la página de asistentes de IA: 1. **Crea una clave para tu asistente** (solo administrador). La clave obtiene solo el `mcp_read` permiso y se muestra una sola vez; etiquétala con el asistente y la persona que la usa (por ejemplo, *Claude Desktop, Marketing*). También puedes crearla en *Herramientas de desarrollo → Claves de API* con el permiso *Asistente de IA (Solo lectura)* . 2. **Configura tu cliente.** La página muestra la URL del servidor y un bloque listo para copiar para cada cliente con tu clave ya incluida. La URL del servidor de producción es: ``` https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp ``` {% tabs %} {% tab title="Claude Code" %} ```bash claude mcp add --transport http --scope user bai-analytics \ https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp \ --header "Authorization: Bearer inpk_live_..." ``` Compruébalo con `claude mcp list`. El ámbito de usuario mantiene la clave fuera de cualquier archivo comprometido en tu repositorio. {% endtab %} {% tab title="Claude Desktop" %} El archivo de configuración de Claude Desktop solo inicia programas locales, así que `mcp-remote` lo conecta con el servidor. Añade esto a `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`; Windows: `%APPDATA%\Claude\`) y reinicia la aplicación: ```json { "mcpServers": { "bai-analytics": { "command": "npx", "args": [ "-y", "mcp-remote", "https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp", "--transport", "http-only", "--header", "Authorization: Bearer inpk_live_..." ] } } } ``` {% endtab %} {% tab title="Cualquier cliente MCP" %} Configura un **HTTP transmisible** servidor (revisión del protocolo 2025-06-18, sin estado, sin flujos SSE, sin agrupación JSON-RPC): ```json { "url": "https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp", "headers": { "Authorization": "Bearer inpk_live_..." } } ``` Una comprobación técnica rápida desde una terminal: ```bash curl -sS https://boundaryai-backend-279197672085.europe-west9.run.app/api/mcp \ -H "Authorization: Bearer inpk_live_..." \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` {% endtab %} {% endtabs %} 3. **Comprueba el acceso.** Pega la clave en *Comprobar acceso* en la página: ejecuta una verdadera `initialize` y `tools/list` contra el servidor e informa de las herramientas disponibles. Confirma que la clave funciona, no que tu asistente esté configurado. Luego solo pregunta: *"Usando BAI Analytics, ¿qué cambió en el sentimiento de los clientes desde el mes pasado y qué monitor está disparándose más?"* ChatGPT no puede usar una clave de acceso: su formulario de conexión personalizada no tiene un campo para un encabezado estático, así que usa el camino de inicio de sesión de arriba. #### Cómo se comportan las claves de acceso * Un `mcp_read` la clave puede consultar analíticas, pero puede **nunca publicar, crear ni enviar**. Los demás ámbitos deliberadamente no incluyen MCP, así que una clave de integración existente no se convierte silenciosamente en la superficie de consulta de un asistente. Una clave sin acceso a MCP obtiene 403 `MCP_NOT_ALLOWED`. * **Las claves heredan el acceso de la persona que las creó**, se vuelve a comprobar en cada solicitud. Si la cuenta de esa persona se desactiva o abandona la organización, la clave deja de funcionar de inmediato (403 `MCP_KEY_UNBOUND`) y la página la muestra como detenida; un administrador la revoca en las herramientas de desarrollador y crea un reemplazo si hace falta. * La **Claves MCP** La lista de la página muestra cada clave, de quién hereda el acceso y su estado; el **Uso** panel muestra solicitudes por herramienta durante los últimos días, incluidas las comprobaciones técnicas. * Se aplican límites de tasa como en cualquier clave (60 solicitudes/minuto por defecto); consulta [Autenticación y claves de API](/boundaryai-docs/boundaryai-docs-es/api-y-webhooks/authentication.md). *** ### Buenas prácticas * **Crea una `mcp_read` clave dedicada por asistente** y etiquétala en consecuencia, para que puedas revocar el acceso de un asistente sin tocar tus integraciones. * **Trata el acceso del asistente como el acceso de lectura de un miembro del equipo.** Puede ver todo lo que contienen las analíticas de la organización, y lo que recupera se comparte con el proveedor del asistente que elegiste. * **El texto de los comentarios es contenido no confiable.** El servidor le indica al asistente que trate los verbatims como datos para analizar, nunca como instrucciones; ten eso en cuenta si construyes tu propio agente encima.