Cómo Conectar el Asistente de IA
Conectar un asistente de IA a Core360 es una tarea de administrador, se hace una sola vez por cada asistente que se quiera usar, y siempre queda limitada a una empresa y a los permisos del plan contratado.
Ruta en el sistema: Integraciones > MCP (/integrations/mcp)
Solo los usuarios con rol Admin pueden generar claves de acceso o administrar clientes OAuth. Además, la empresa debe tener una suscripción activa que incluya el módulo MCP; de lo contrario, Core360 no permite generar credenciales.
El servidor MCP
Core360 expone su propio servidor MCP, independiente de la aplicación principal, en:
https://mcp.core360.cloud/mcp
Este es el dato que se pega en la mayoría de los clientes de IA (Claude, ChatGPT u otros compatibles con MCP) al agregar una integración o conector nuevo. El servidor también publica los puntos de descubrimiento estándar que los clientes de IA usan automáticamente para configurarse:
| Endpoint | Uso |
|---|---|
/.well-known/oauth-protected-resource | Le dice al cliente de IA dónde autenticarse |
/.well-known/oauth-authorization-server | Describe el servidor de autorización OAuth (endpoints, métodos soportados) |
/health | Verificación de que el servicio está activo |
Dos formas de autenticar
Core360 admite dos maneras de conectar un asistente. Cuál usar depende del cliente de IA:
1. Clave de API (API Key)
Pensada para clientes que permiten pegar un token fijo (por ejemplo, configuraciones manuales de MCP o integraciones a medida).
- En Core360, vaya a Integraciones > MCP.
- Haga clic en "Generar API Key".
- Póngale un nombre descriptivo (por ejemplo, "Claude – Contabilidad").
- Core360 genera una clave con el prefijo
mcp_...y la muestra una sola vez. Cópiela de inmediato: no se puede volver a consultar después. - Péguela en el asistente de IA como token de acceso (
Authorization: Bearer mcp_...).
La clave queda asociada, desde el momento en que se genera, a:
- Una empresa (la empresa activa del administrador que la generó).
- Un nivel de plan (
Tier), tomado de la suscripción MCP activa de esa empresa en ese momento.
Desde la misma pantalla se puede ver la lista de claves generadas (empresa, nombre, prefijo, plan, estado, fecha de creación, último uso) y revocar cualquiera que ya no se necesite.
Si sospecha que una clave se filtró o ya no la usa, revóquela y genere una nueva. La clave en texto plano nunca se vuelve a mostrar, ni siquiera a un administrador.
2. Inicio de sesión OAuth (recomendado para Claude.ai, ChatGPT y clientes similares)
Los clientes de IA modernos que agregan Core360 como "conector" o "aplicación" suelen usar este flujo automáticamente: usted no copia ninguna clave, sino que inicia sesión con su usuario de Core360 dentro de una pantalla que abre el propio asistente.
El flujo, en orden:
- Desde el asistente de IA, se agrega la URL del servidor MCP de Core360 como nueva conexión.
- El asistente se registra automáticamente ante Core360 (registro dinámico de cliente OAuth) si es la primera vez que se conecta.
- Se abre una pantalla de inicio de sesión de Core360, donde el usuario ingresa su correo y contraseña habituales.
- Si el usuario pertenece a más de una empresa con MCP activo, Core360 le pide elegir con cuál empresa quiere conectar el asistente.
- Se muestra una pantalla de consentimiento indicando qué aplicación se está conectando, a qué empresa, y qué alcances (
scopes) está pidiendo: lectura (mcp:read), escritura (mcp:write) y/o ejecución de endpoints (mcp:execute). - Al aprobar, Core360 emite un token de acceso al asistente (válido por 1 hora) y un token de actualización (válido por 30 días) para que la sesión se renueve sola sin pedir el usuario y contraseña cada vez.
Si el usuario no pertenece a ninguna empresa con el módulo MCP activo, el proceso se detiene con un mensaje indicando que debe contactar a su administrador para activar una suscripción con MCP.
Los clientes OAuth autorizados (qué aplicaciones se conectaron, cuándo) se administran desde Integraciones > MCP > Clientes OAuth.
Control de acceso: qué ve cada usuario
El acceso del asistente de IA está gobernado por dos ejes, y no reproduce los roles y permisos individuales que un usuario tiene dentro de las pantallas de Core360 (por ejemplo, un usuario de solo-lectura en el ERP puede, a través del asistente, usar cualquier herramienta que su plan permita, siempre dentro de la empresa a la que quedó conectado):
Aislamiento por empresa
Cada clave de API o sesión OAuth queda atada a una sola empresa desde el momento en que se genera o se aprueba el consentimiento. Toda herramienta que el asistente use —consulta o escritura— se filtra automáticamente por esa empresa; es técnicamente imposible que, con una misma conexión, el asistente vea o modifique datos de otra empresa. Si un usuario necesita usar el asistente con varias empresas, debe crear una conexión separada por cada una (una clave de API distinta, o volver a autorizar por OAuth eligiendo la otra empresa).
Permisos según el plan contratado
Cada plan de suscripción que incluye MCP define, para la empresa:
| Parámetro | Qué controla |
|---|---|
| Nivel (Tier) | Free, Basic, Pro o Enterprise — se muestra como insignia en la lista de claves |
| Límite diario de solicitudes | Cuántas llamadas puede hacer el asistente por día antes de recibir el mensaje de límite excedido (se reinicia a medianoche) |
| Herramientas de escritura habilitadas | Si el asistente puede usar las herramientas que crean o modifican datos (crear factura, crear asiento, crear cliente, crear/convertir cotizaciones, registrar factura de compra). Sin este permiso, esas herramientas responden con un rechazo indicando que no están disponibles en el plan |
| Ejecutor genérico de endpoints | Si el asistente puede usar api_ejecutar_endpoint para llamar cualquier endpoint del API (ver Herramientas Disponibles) |
Si la empresa no tiene ninguna suscripción activa con MCP incluido, Core360 ni siquiera permite generar una clave de API nueva.
La pantalla Integraciones > MCP > Dashboard muestra el consumo de solicitudes y qué herramientas se están usando, útil para detectar si conviene subir de plan o revisar una conexión que ya no se usa.