CÓMO SE HACE ⏱ 6 min 📦 Inteligencia artificial (Crol AI). Conexión con Claude y ChatGPT (MCP)

Pre-requisitos

• Ser administrador de la empresa en Crol: la configuración de APIs solo está disponible para administradores.
• Tener una cuenta de ChatGPT Plus con sesión iniciada, en el navegador o en la aplicación de escritorio: los complementos personalizados no están disponibles en el plan gratuito.
• Crol AI no está en el directorio de complementos de ChatGPT: se agrega a mano como complemento personalizado, una sola vez.
• Saber a nombre de qué usuario de Crol va a operar la consulta: el complemento responde con la información que ese usuario puede ver.
• Una API Key por empresa. Si administras varias empresas en Crol, repite el registro en cada una.

Pasos

1. En Crol, abre el menú Configuración y entra a Catálogo de APIs. Pulsa Nuevo.

La pantalla de consulta te muestra las APIs que ya existen en la empresa y su estado. El botón Nuevo está en la barra de herramientas, arriba de la tabla de documentos.

2. Captura el Proveedor con un nombre que reconozcas —el campo es texto libre, así que puedes escribir ChatGPT— y elige el Usuario de crol a nombre de quien va a operar la consulta.

Los dos campos son obligatorios y Crol los marca en amarillo mientras están vacíos. Escribe ChatGPT en el Proveedor para reconocer el registro de un vistazo —el de la captura se llama Crol Intelligence porque ya existía—. Los campos Usuario y Clave interna están bloqueados: los genera Crol al guardar. La casilla Activo viene marcada y la KEY ya viene generada.

3. En la pestaña Accesos, marca la casilla del encabezado de la columna Consultar para habilitar todos los accesos de una sola vez.

Los accesos están agrupados por módulo —Bancos, CFDI, Contabilidad, Contactos, Establecimientos, Productos y servicios y Ventas— y definen qué puede consultar ChatGPT. Lo que dejes sin marcar aquí, ChatGPT no lo ve.

4. Pulsa Guardar. Crol genera el Usuario y la Clave interna del registro. Copia la KEY completa.

La KEY es el único dato que vas a pegar en ChatGPT. Es un identificador de 36 caracteres con guiones; cópialo completo, sin espacios al inicio ni al final.

5. En ChatGPT, abre Complementos en el panel izquierdo y pulsa el botón + de la esquina superior derecha.

La pantalla Complementos reúne las herramientas con las que trabaja ChatGPT. El botón + está a la derecha del buscador y abre la ventana para dar de alta uno nuevo. Si ya agregaste Crol AI antes, aparece en Instalados y puedes saltar al paso 8.

6. Captura el nombre Crol AI y la dirección https://ai.crol.mx/mcp, elige OAuth en Autenticación, marca Entiendo y quiero continuar y pulsa Crear.

El nombre es el que verás en tu lista de complementos y la descripción es opcional. Deja la Conexión en URL del servidor —no en Túnel— y copia la dirección completa, sin espacios. La Configuración avanzada de OAuth se queda como viene: ChatGPT detecta solo los datos que necesita. El botón Crear no se habilita mientras no marques la casilla del aviso.

7. Se abre la ventana Agregar Crol AI a ChatGPT. Pulsa Iniciar sesión con Crol AI.

La ventana resume a qué va a tener acceso el complemento y te recuerda que puedes revocar el permiso cuando quieras. El botón te lleva a la pantalla de conexión de Crol.

8. Se abre la pantalla Conectar tus API Keys de Crol. Pega la KEY en el campo API KEYS, pulsa CONECTAR y espera el mensaje Cuenta conectada.

La pantalla confirma que la conexión viene de ChatGPT y avisa que las llaves se guardan cifradas. Si administras varias empresas, usa + Agregar otra API Key y pega una llave por empresa antes de conectar.

El mensaje de confirmación incluye el nombre de la empresa con la que se validó la llave. Es tu comprobación de que pegaste la KEY correcta: si el nombre no es el de la empresa que esperabas, copiaste la llave de otro registro.

Resultado esperado

De vuelta en ChatGPT, el detalle del complemento confirma la conexión. En Información aparecen la fecha en que se conectó, la URL del servidor y el tipo de Autorización admitida. Más arriba, en Permisos, eliges cuándo ChatGPT debe pedirte autorización antes de usar el complemento.

• La URL dice exactamente https://ai.crol.mx/mcp y la Autorización admitida es OAuth. Si alguno de los dos no coincide, el complemento quedó mal registrado.
• Crol AI aparece en Instalados dentro de la pantalla de Complementos de ChatGPT.
• En Crol, el registro del Catálogo de APIs queda con su Usuario y Clave interna generados, y la pestaña Bitácora guarda quién lo creó y cuándo.

La prueba definitiva es una conversación. Abre un chat nuevo y escribe Hola Crol AI: cuando el complemento está conectado, el asistente se presenta por su nombre en lugar de responder como ChatGPT. A partir de ahí puedes pedirle el saldo de un cliente, una balanza o cualquier consulta que hayas autorizado en la pestaña Accesos.

Variaciones / Notas

• Varias empresas: en la pantalla de conexión puedes pegar más de una llave con + Agregar otra API Key. Genera una API Key en cada empresa de Crol y pégalas todas antes de pulsar CONECTAR.
• Accesos limitados: si prefieres que ChatGPT solo consulte parte de la información, no marques la casilla del encabezado. Marca uno por uno los accesos que autorizas y deja el resto sin marcar.
• Complementos y Habilidades: la pantalla tiene dos pestañas. Los servidores MCP como Crol AI se dan de alta en Complementos; Habilidades es otra cosa y ahí no aparece.
• También sirve para Claude: el mismo registro del Catálogo de APIs y la misma dirección https://ai.crol.mx/mcp funcionan en Claude. Si vas a usar los dos asistentes, conviene un registro por asistente para saber cuál está consultando qué.
• Dar de baja el acceso: desde Crol, entra al registro del Catálogo de APIs y desmarca la casilla Activo: eso corta el acceso a la información de Crol, y hay que volver a marcarla para restablecerlo. Desde ChatGPT se gestiona con el menú … de la esquina superior derecha del detalle del complemento.

Errores frecuentes

«No encuentro Crol AI en la lista de complementos»

Causa: Crol AI no es un complemento público del directorio de ChatGPT. Mientras no lo agregues a mano, no aparece en ninguna lista ni en el buscador.

Solución: agrégalo con los pasos 5 y 6 de esta guía. Es un registro que se hace una sola vez por cuenta de ChatGPT.

«El botón Crear está deshabilitado»

Causa: falta marcar la casilla Entiendo y quiero continuar del aviso de riesgo, o el campo de la dirección quedó vacío o incompleto.

Solución: marca la casilla y revisa que la dirección sea exactamente https://ai.crol.mx/mcp, sin espacios al inicio ni al final.

«Agregué el complemento pero ChatGPT nunca me pidió iniciar sesión»

Causa: la Autenticación quedó en un valor distinto de OAuth. Sin OAuth no se abre la pantalla de conexión de Crol y el complemento queda sin llave.

Solución: abre el detalle del complemento, cambia la autenticación a OAuth y vuelve a conectarlo. Si no puedes editarlo, elimínalo y regístralo de nuevo con los pasos 5 y 6.

«Pegué la API Key y la pantalla no me deja conectar»

Causa: la llave se copió incompleta, con espacios, o el registro de Crol quedó sin la casilla Activo marcada.

Solución: regresa al Catálogo de APIs, abre el registro y copia otra vez la KEY completa. Verifica que Activo esté marcado. Si agregaste un campo de más con + Agregar otra API Key y lo dejaste vacío, quítalo con la × del campo.

«ChatGPT dice que no tiene acceso a esa información»

Causa: el acceso correspondiente no está marcado en la pestaña Accesos del registro.

Solución: en Crol, abre el registro, pulsa Modificar, marca el acceso que falta y guarda. Después, en ChatGPT, desconecta y vuelve a conectar el complemento: los accesos nuevos aparecen hasta que reconectas.