Conectá tu asistente de IA — Manual del operador | AI Agent Builder

Conectá tu asistente de IA

Una conexión MCP con OAuth para Codex, Claude Code y Cursor, con organizaciones y permisos explícitos.

5 min de lectura · Actualizado 23 de octubre de 2026

Usá una conexión remota llamada ai-accelerator a la URL agregada /admin/mcp que anuncia tu instalación. Esa conexión reúne los catálogos Insight, Agents y Platform. Para conectarte no necesitás instalar el Admin Kit ni ejecutar un servidor MCP local.

Conexión directa

  1. En el sitio del producto, elegí Conectá tu asistente de IA, copiá el prompt de conexión y pegalo en Codex, Claude Code, Cursor u otro cliente con soporte de HTTP MCP y OAuth. El prompt obtiene la URL real del recurso y el emisor de tu instalación; no los deduzcas de un dominio.
  2. Dejá que el cliente abra el navegador e iniciá sesión con tu cuenta existente del admin.
  3. Elegí una o varias organizaciones. Seleccionar el padre no incluye automáticamente sus hijas: marcá Incluir descendientes si querés autorizar también las actuales y futuras a las que conserves acceso.
  4. Seleccioná los scopes y el rol máximo, revisá y confirmá. El cliente recibe un token de acceso de corta duración y uno de renovación rotativo. OAuth no crea una API key. El cliente guarda y administra sus credenciales OAuth.

En Codex, una vez configurada la URL, podés iniciar la autorización con:

codex mcp login ai-accelerator --scopes admin:read,admin:write,mcp:insight,mcp:agents,mcp:platform

Solicitar estos scopes permite elegirlos durante el consentimiento; no los concede automáticamente. Claude Code y Cursor usan sus controles de autenticación MCP. Si el cliente no soporta OAuth, hay que explicar esa limitación, sin crear una key como reemplazo silencioso.

Cómo elegir los permisos

OpciónQué permite
mcp:insightAbrir el catálogo de consultas e inspección
mcp:agentsAbrir el catálogo de agentes y workflows
mcp:platformAbrir el catálogo de recursos de la plataforma
admin:readEjecutar lecturas dentro del acceso concedido
admin:writeRealizar cambios permitidos por el rol y el acceso
ViewerRol máximo de solo lectura
AdminCreación y actualización donde estén permitidas
OwnerIncluye eliminaciones permitidas; mantiene las protecciones del recurso

El consentimiento arranca en solo lectura. Agregá admin:write para que aparezcan los niveles superiores; tus permisos en las organizaciones también los limitan. Elegir todos los scopes o la organización System no concede superadmin global. Algunas operaciones exclusivas del operador seguirán sin estar disponibles. Una búsqueda vacía o un 404 de recurso no disponible no demuestran que se haya eliminado un recurso.

El acceso efectivo combina tus permisos actuales, organizaciones y descendientes seleccionados, scopes, rol máximo, pertenencia del recurso y habilitación del producto cuando corresponda. El servidor publica las herramientas y acciones permitidas para esa conexión; el catálogo de un documento no es una prueba de acceso.

Verificar y continuar

La dirección local del callback, su puerto y el mensaje Authentication complete los maneja el cliente. No hay un puerto fijo de callback que debas configurar en Accelerator.

Después de autorizar, el asistente debe continuar la tarea: actualizar el catálogo MCP con el mecanismo del cliente, listar las herramientas disponibles y ejecutar una consulta pequeña de lectura en una organización autorizada. Para una prueba controlada, usá el tenant Test existente de esa instalación. Nunca crees, modifiques ni borres datos solo para probar acceso.

El resultado debe separar OAuth, descubrimiento y consulta real; indicar qué organización se verificó; resumir las capacidades por área y si hay permiso para cambios; y proponer dos o tres pedidos útiles. Que una escritura esté disponible no significa que haya sido ejecutada y probada.

Los chats abiertos pueden conservar el catálogo anterior. Recargá sus MCP o reiniciá el cliente según corresponda y retomá la tarea. Si hace falta otro paso para cargar herramientas, hay que indicarlo y dejar la prueba pendiente. El callback por sí solo no confirma el funcionamiento completo.

Reautorizar, revocar y ordenar conexiones anteriores

Para ampliar organizaciones, scopes o rol, volvé a autorizar y aprobá explícitamente los nuevos permisos. Reiniciar no amplía el consentimiento. Para retirar el acceso, revocá la conexión en Aplicaciones conectadas del admin. Desinstalar el Kit no revoca OAuth.

Una conexión anterior con API key es independiente: el login OAuth no cambia esa key. Revisá la configuración del usuario y la del proyecto para detectar duplicados. Después de comprobar la nueva conexión, quitá o desactivá únicamente las entradas anteriores de esa instalación, con respaldo. Conservá los servidores de desarrollo, otras instalaciones y otros servicios. No imprimas credenciales. Este procedimiento externo no modifica los MCP internos.

Las API keys siguen siendo una opción explícita para automatizaciones sin intervención humana o clientes sin OAuth. Necesitan sus propios scopes, rol y acceso; una key superadmin tampoco saltea los controles de scopes. Usá almacenamiento de secretos o la entrada oculta documentada, nunca secretos en prompts ni argumentos. Un error de permisos no autoriza a cambiar de credencial para esquivarlo.

Para qué queda el Admin Kit

El Kit es un complemento opcional para proyectos: configura clientes compatibles, agrega instrucciones administradas y copia documentación de referencia. Su opción OAuth usa la misma conexión y el mismo consentimiento. No ejecuta un servidor MCP, no crea keys durante el login ni concede privilegios extra.

El instalador se autoriza por separado para descargar un producto firmado y verificar su habilitación en una organización. Esa autorización de descarga no es el permiso MCP del cliente. Instalar/actualizar el programa y autorizar el MCP son pasos diferentes. El comando status del Kit describe la configuración OAuth guardada; la ejecución real se verifica desde el cliente de IA.

update-config conserva los documentos del proyecto que ya existían. Comparalos con los del paquete actualizado y revisá instrucciones antiguas sobre keys o tres conexiones. Los respaldos de configuración pueden contener credenciales anteriores: tratálos como secretos.