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 Claude con sesión iniciada, en el navegador o en la aplicación de escritorio. Crol AI no está en el directorio de conectores de Claude: se agrega a mano como conector personalizado, una sola vez.
• Saber a nombre de qué usuario de Crol va a operar la consulta: el conector 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 Claude— y elige el Usuario de crol a nombre de quien va a operar la consulta.

Los dos campos son obligatorios y se marcan en amarillo. Los campos Usuario y Clave interna están bloqueados: los genera Crol cuando guardas. 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 Claude. Lo que dejes sin marcar aquí, Claude 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 Claude. Es un identificador de 36 caracteres con guiones; cópialo completo, sin espacios al inicio ni al final.

5. En Claude, abre Personalizar › Conectores, pulsa Agregar y elige Agregar conector personalizado.

El apartado Conectores está en el bloque Personalizar del panel izquierdo. El botón Agregar está arriba a la derecha y despliega dos opciones; la que necesitas es la segunda. Si ya agregaste Crol AI antes, aparece en la lista con la etiqueta Personalizado y puedes saltar al paso 7.

6. Captura el nombre Crol AI y la dirección https://ai.crol.mx/mcp. Deja vacía la Configuración avanzada y pulsa Agregar.

El nombre es el que verás en tu lista de conectores. La dirección es la del servidor de Crol AI: cópiala completa, sin espacios. Los campos de OAuth son opcionales y aquí no se usan.

7. Localiza Crol AI en la lista de conectores y pulsa Conectar.

El conector recién agregado aparece con el tipo Web y la etiqueta Personalizado.

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 Claude 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 y la pantalla regresa sola a Claude. 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 Claude, el detalle del conector muestra la dirección del servicio, el botón para desconectarlo y la lista de herramientas de solo lectura disponibles. Cada herramienta corresponde a un acceso que marcaste en Crol, y decides si Claude la usa siempre, si te pregunta antes o si no la usa.

• Crol AI aparece con marca de conectado en la lista de conectores de Claude.
• En el chat, el conector aparece con su interruptor encendido y Claude puede consultar la información de la empresa.
• 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.

Para comprobarlo desde una conversación nueva, abre el menú + del cuadro de mensaje y entra a Conectores: Crol AI debe estar en la lista con el interruptor encendido.

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 Claude 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.
• Aplicación de escritorio: funciona igual que en el navegador. La ruta es la misma —Configuración › Conectores— y la pantalla de la API Key se abre en tu navegador.
• Dar de baja el acceso: desde Claude, el detalle del conector tiene el botón Desconectar. 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.

Errores frecuentes

«No encuentro Crol AI en la lista de conectores»

Causa: Crol AI no es un conector público del directorio de Claude. Mientras no lo agregues como conector personalizado, 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 Claude.

«La opción Agregar conector personalizado está deshabilitada»

Causa: el plan gratuito de Claude permite un solo conector personalizado y ya tienes otro registrado.

Solución: elimina el conector personalizado que ya no uses o cambia a un plan con más conectores.

«No encuentro Conectores en la configuración de Claude»

Causa: estás en el apartado de Configuración, que ya no administra los conectores y solo muestra un aviso.

Solución: entra a Conectores desde el bloque Personalizar del panel izquierdo. También llegas desde el chat: menú + › Conectores › Administrar conectores.

«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.

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

Causa: el acceso correspondiente no está marcado en la pestaña Accesos del registro, o la herramienta está bloqueada en los permisos del conector.

Solución: en Crol, abre el registro, pulsa Modificar, marca el acceso que falta y guarda. Después, en Claude, pulsa Desconectar y vuelve a conectar el conector: los accesos nuevos aparecen hasta que reconectas. Revisa también que la herramienta no esté en No permitir dentro de Permisos de herramientas.