Kobi
Conectores de nube
Deja que Kobi lea los recursos de AWS y Azure de los que depende un workload, en solo lectura, a través de servidores MCP seleccionados. Qué incluye cada edición, cómo configurarlos y qué queda fuera.
En esta página
Kobi ve dentro del clúster. Cuando un workload falla por algo que está fuera de él (una base de datos detenida, una regla de firewall eliminada, una cola llena de mensajes fallidos, una cuota que bloquea un node pool), la evidencia en Kubernetes se queda en “cannot connect”. Los conectores de nube permiten a Kobi leer esos recursos en tu cuenta de la nube. En KubeBolt Cloud, el investigador, el planificador y el postmortem de Autopilot también los leen.
Los conectores llegaron con KubeBolt 2.5.0 (open source) y 2.5.0-e2 (Cloud y EE autoalojado).
Qué incluye cada edición
| Open source | KubeBolt Cloud | EE autoalojado | |
|---|---|---|---|
| Amazon Web Services | ✅ | ✅ Desde el plan Team | ✅ |
| Microsoft Azure | ✅ A través de un sidecar | Soon | Soon |
| Google Cloud | Soon | Soon | Soon |
- Planes. En KubeBolt Cloud, los conectores empiezan en Team. En Free la tarjeta muestra un candado, y Preview abre lo que lee el conector y cómo se configura. Las instalaciones autoalojadas nunca están limitadas por plan.
- Por qué Azure aparece como Soon (próximamente) fuera de open source. El Azure MCP Server inicia sesión con una entidad de servicio (service principal) por instancia, así que no puede darle a cada organización su propia identidad. Un conector marcado como Soon no tiene nada que configurar, y Kobi y Autopilot no tienen herramientas para él.
Qué lee
- AWS: EKS y el EC2 y el Auto Scaling que hay detrás de sus nodos; RDS, Aurora y DocumentDB; métricas, alarmas y logs de CloudWatch; Application Signals y X-Ray; los balanceadores de carga y el estado de sus destinos, las VPC, los grupos de seguridad, las ACL de red, las tablas de rutas, NAT y los endpoints de VPC, y Route 53; ElastiCache, MemoryDB, SQS, SNS y MSK; el estado de DynamoDB y Redshift; EBS, EFS y la configuración de los buckets de S3; el estado de las claves de KMS; la configuración de Lambda; los eventos de administración de CloudTrail; AWS Health y Service Quotas; los roles de IAM y ECR; los metadatos de Secrets Manager. Kobi también lee Cost Explorer y las recomendaciones de rightsizing, y los nombres de Parameter Store. El panel lateral lista cada familia y lo que nunca hace.
- Azure: el registro de actividad, las métricas de la plataforma, Resource Health, los servidores de PostgreSQL, MySQL y Azure SQL, AKS, las cuotas, Service Bus, Event Hubs, Container Registry, la caducidad de Key Vault, la configuración del almacenamiento, Log Analytics y Advisor (solo de la suscripción configurada).
Lo que ningún conector lee: el contenido de las bases de datos (ni SQL, ni ítems de DynamoDB), los valores de los secretos, el contenido de los objetos de S3, el contenido de los mensajes, las capas de las imágenes ni el código de las funciones. En Azure, el Azure MCP Server no tiene herramientas de red (NSG, tablas de rutas, balanceadores de carga, endpoints privados) ni de Microsoft Entra ID: Kobi solo ve un cambio de red a través del registro de actividad.
Una credencial rotada, rastreada hasta su origen. Cuando la credencial de un workload viene de un almacén de la nube a través de External Secrets, Kobi lee el ExternalSecret y su store: la clave remota, el proveedor y la región, y cuándo funcionó la última sincronización. Con el conector de AWS pregunta después a Secrets Manager cuándo rotó ese secreto exacto, y a CloudTrail quién lo rotó. Pregunta por ese único secreto en lugar de listar los de la cuenta, y nunca lee un valor.
Una dependencia a la que se llega a través de un Service ExternalName se sigue hasta donde sale del clúster, así que una base de datos gestionada que esté detrás de uno se busca en la nube.
Solo lectura, por capas
La solo lectura se impone, no se promete:
- Solo existen herramientas seleccionadas. Cada conector tiene una lista de herramientas permitidas que se vuelve a comprobar en el momento de la llamada. Una herramienta que no está en la lista no está en el catálogo del modelo.
- El modelo no escribe código. En AWS, Kobi pide una operación tipada, y KubeBolt la convierte en un script de lectura fijo y comprueba después que se ejecutó exactamente esa API. En Azure, cada valor se comprueba por tipo y por ruta antes de llegar al sidecar.
- Tu rol también dice que no. La política de permisos de AWS que imprime la guía de configuración deniega los valores de los secretos, el contenido de los objetos de S3, las consultas a bases de datos y las lecturas de ítems, y los datos de usuario de las instancias, aunque más adelante se adjunte una política más amplia al rol, y deniega cualquier otra cosa que llegue a través del AWS MCP Server.
- Los resultados son datos. Llegan al modelo con la información sensible oculta (claves, tokens, contraseñas, claves privadas), limitados a 32 KiB y marcados como datos, nunca como instrucciones.
- Las credenciales nunca llegan al modelo. KubeBolt guarda la sesión del rol de AWS; en Azure, el sidecar guarda la entidad de servicio y KubeBolt nunca ve su secreto.
- Cada llamada queda registrada. Cada una deja un registro de acceso
(
mcp_tool_call: conector, herramienta, operación, duración y resultado; nunca los argumentos ni la respuesta) en el registro de auditoría de acciones,GET /api/v1/admin/actions?class=access. Desde la 2.7.0, el registro nombra la operación también en una llamada que falló en el proveedor, que se retuvo o que estaba bloqueada. Consulta Acciones y gobernanza.
Límites: 12 llamadas a la nube por pregunta a Kobi, 40 por ejecución de Autopilot,
4 a la vez por conector y 30 s por llamada. Las llamadas a la nube también tienen un
presupuesto por minuto, con una cuarta parte de él a la vez: en open source, el de
Kobi es de 120 por minuto y 30 a la vez. En KubeBolt Cloud, Kobi y Autopilot tienen
cada uno su propio presupuesto, fijado por tu plan, así que un chat que agota su
minuto nunca retiene una corrección. AWS, por su parte, permite 10 peticiones por
segundo por cuenta y región a su MCP Server. Autopilot solo va a una cuenta de la nube por lo que la
ejecución ha situado allí: una dependencia que encontró su propio
get_external_connections, el propio clúster o el store que hay detrás de un
External Secret. Hasta entonces, sus llamadas a la nube se rechazan.
Una llamada que retuvo el presupuesto es un límite, no un fallo. La tarjeta de
Kobi la muestra en ámbar, con un reloj (Not read — cloud call limit: 120/min,
30 at once); cuenta entre las lecturas que no se pudieron hacer, una
conversación reabierta la muestra igual, y a Kobi se le dan las mismas cifras.
Una llamada que KubeBolt rechazó antes del proveedor muestra Not sent. Las dos
cuentan como rate_limited y not_sent en
kubebolt_kobi_copilot_tool_results_total, no como errores, así que
Administration → AI (Kobi) → Health no las muestra como herramientas que
fallan.
Configurar AWS
Los conectores están en Administration › AI & Autopilot › Connectors en Cloud y EE, y en Administration › AI (Kobi) › Connectors en open source.
- Abre Amazon Web Services y elige IAM role. El panel lateral imprime las políticas de permisos y de confianza del rol, con el External ID de tu organización ya incluido, y los comandos de la CLI que lo crean.
- Crea el rol en tu cuenta de AWS.
- Pega el ARN del rol, elige la Region en la que están los recursos de tus
workloads y la AWS MCP Server location (
us-east-1oeu-central-1; las llamadas siguen yendo a tu región) y luego haz clic en Test connection. - Si quieres, configura Who can use it in Kobi (ver más abajo) y después haz clic en Save and enable.
El External ID se genera una vez por organización y se muestra en solo lectura. Se conserva cuando eliminas el conector, así que al configurarlo de nuevo se imprime el mismo ID y el rol sigue funcionando.
En KubeBolt Cloud
El rol asumido es el único modo, y se rechazan dos tipos de rol:
- Un rol en la propia cuenta de AWS de KubeBolt.
- Un rol que no exige el External ID. AWS ignora un External ID que la política de confianza no pide, así que un rol así quedaría abierto, a través de KubeBolt, a cualquier organización que conociera su ARN.
Para comprobar lo segundo, KubeBolt intenta asumir tu rol sin el External ID
y con una política de sesión que lo deniega todo, antes de usarlo por primera vez
y cada hora a partir de entonces. AWS tiene que rechazarlo. Tu CloudTrail muestra
cada comprobación como un AssumeRole denegado desde la sesión
kubebolt-external-id-check. Es lo esperado.
Cuando lo autoalojas
Los dos modos parten de la identidad de AWS con la que funciona la API: el modo IAM role la usa para asumir tu rol.
- En EKS: asigna un rol de IAM a la ServiceAccount de la API (IRSA o Pod Identity)
y configura
mcpConnectors.aws.principalArncon ese rol, para que la política de confianza impresa lo nombre. Para el modo IAM role entre cuentas, ese rol también necesitasts:AssumeRolesobre el rol lector. - Fuera de EKS (AKS, GKE, on-premises): registra el emisor OIDC del clúster como
proveedor de identidad en IAM, crea un rol que confíe en él para
system:serviceaccount:<namespace>:<the API's ServiceAccount>con la audienciasts.amazonaws.com, y configuramcpConnectors.aws.principalArncon ese rol ymcpConnectors.aws.webIdentity.enabled=true. Solo el pod de la API monta el token. - Docker Compose: el archivo compose monta
~/.awsen el contenedor de la API; el modo IAM role firma con su perfil por defecto. - O usa This machine’s credentials: KubeBolt firma con la identidad con la que funciona (entorno, un perfil que indiques en el panel lateral, IRSA, Pod Identity o un rol de instancia). Solo envía las lecturas de la lista, pero IAM no restringe esa identidad, así que dale una dedicada y de solo lectura.
| Variable | Valor de Helm | Por defecto | Significado |
|---|---|---|---|
KUBEBOLT_MCP_CONNECTORS | mcpConnectors.enabled | activado | false quita la pestaña Connectors y las herramientas de nube |
KUBEBOLT_MCP_AWS_PRINCIPAL_ARN | mcpConnectors.aws.principalArn | (ninguno) | La identidad de AWS con la que funciona la API, impresa como principal de la política de confianza |
| (ninguna) | mcpConnectors.aws.webIdentity.enabled | false | Intercambia el token de la ServiceAccount de la API por principalArn fuera de EKS |
KUBEBOLT_MCP_TOOL_TIMEOUT | extraEnv | 30s | Tiempo límite por llamada |
KUBEBOLT_MCP_AZMCP_URL | (ninguno) | http://127.0.0.1:5001/ | Dónde escucha el sidecar de Azure. Solo loopback |
Detrás de un firewall de salida, permite AWS STS y aws-mcp.us-east-1.api.aws, o
aws-mcp.eu-central-1.api.aws, la otra región de alojamiento del conector.
La primera llamada de una sesión tarda 9–12 s mientras AWS arranca su sandbox. Las siguientes tardan 2–3 s.
Configurar Azure (open source)
El Azure MCP Server funciona junto a la API y guarda una entidad de servicio de solo lectura con los roles Reader, Monitoring Reader y Log Analytics Reader. Un servidor guarda una sola identidad, así que una instalación lee un solo tenant de Azure. La guía de configuración del conector te da los comandos con tu suscripción ya puesta:
-
Crea la entidad de servicio y guarda el
appId, elpasswordy eltenantque imprime:SUB=<subscription-id> az ad sp create-for-rbac --name kubebolt-azure-reader --role Reader --scopes /subscriptions/$SUB APP_ID=<appId from the output> az role assignment create --assignee $APP_ID --role "Monitoring Reader" --scope /subscriptions/$SUB az role assignment create --assignee $APP_ID --role "Log Analytics Reader" --scope /subscriptions/$SUBOpcional, limitado a los recursos que Kobi debe leer: Azure Service Bus Data Receiver en un namespace (mensajes pendientes y mensajes fallidos) y Key Vault Reader en un vault (caducidad de claves y certificados). Nunca concedas Key Vault Secrets User.
-
Ejecuta el sidecar:
- Helm: configura
mcpConnectors.azure.sidecar.enabled=true, conexistingSecretapuntando a un Secret que tengatenant-id,client-idyclient-secret. Se ejecuta como segundo contenedor del pod de la API, solo en loopback, con un sistema de archivos raíz de solo lectura y sin token de ServiceAccount. La imagen está fijada por digest a la versión contra la que se revisó la lista de permitidas de KubeBolt, Azure MCP Server 4.0.0-beta.6 desde la 2.6.6; cámbiala solo con una versión de KubeBolt. Si la replicas en un registro privado, replica esa versión. - Docker Compose: pon
AZURE_TENANT_ID,AZURE_CLIENT_IDyAZURE_CLIENT_SECRETendeploy/.envy luego ejecutadocker compose --profile azure up -d.
- Helm: configura
-
Abre Microsoft Azure en Connectors, introduce el ID de la suscripción (y el ID del tenant solo si la entidad de servicio ve varios directorios), haz clic en Test connection y después en Save and enable.
Para ver el estado actual de Resource Health, alguien con Owner o Contributor en la suscripción registra el proveedor una vez. Registrarlo no crea ningún recurso y es gratis:
az provider register --namespace Microsoft.ResourceHealth --subscription <id>
Sin ese registro, Kobi sigue viendo los eventos de salud en el registro de actividad.
Quién puede usar un conector
Cada conector tiene un rol mínimo para la persona que le pregunta a Kobi, que se configura en su panel lateral en Who can use it in Kobi: Editors and admins (por defecto), Everyone o Admins only. Un usuario por debajo de ese rol no recibe las herramientas del conector; Kobi le dice que el conector existe y qué rol necesita, y una llamada que se haga de todos modos se rechaza y se registra como denegada. Configurar un conector requiere el rol Admin.
Un conector lee la cuenta de la nube de la organización para todos los que estén por encima de ese rol. No se limita por equipo. Autopilot no está sujeto al rol mínimo. El servidor MCP nunca sirve herramientas de conectores.
Cómo se usa
Pregunta como siempre: “orders-api no está listo, ¿por qué?”. Cuando la evidencia
apunta fuera del clúster, Kobi clasifica la dirección con get_external_connections y
usa el conector correspondiente. Los pasos marcan dónde sale del clúster (“Leaves the
cluster → AWS us-east-2 · read-only”), y la respuesta termina con una nota que dice lo
que leyó.
Para que las preguntas dentro de un clúster se queden en un modelo pequeño, configura un modelo de escalamiento.
Desactivarlo
mcpConnectors.enabled=false (KUBEBOLT_MCP_CONNECTORS=false) quita la pestaña
Connectors y las herramientas de nube. Los conectores guardan su configuración en el
almacén de ajustes de KubeBolt, así que necesitan la autenticación activada: si está
desactivada, no hay pestaña Connectors.
Bloquear una operación
Lo que puede ejecutar un conector es una lista en el código. Para detener una operación sin esperar a una versión (una lectura que resulta exponer datos, o una que Kobi pide una y otra vez), un admin la añade en Administration → AI (Kobi) → Blocked operations:
- Una lista por conector: para AWS,
service.operation(s3.getobject); para Azure, el nombre del comando; para Google Cloud, el nombre de la herramienta.s3.*bloquea un servicio o grupo entero, y*pausa el conector. Las entradas se guardan en minúsculas. - Se aplica desde la siguiente llamada, sin reiniciar. Una llamada bloqueada
nunca se envía: la tarjeta de Kobi muestra Not sent, y el registro de
acceso la guarda con el resultado
blocked. - Una entrada que no bloquearía nada (una operación de AWS sin su servicio, un conector que esta instalación no tiene) se rechaza al guardar, con el motivo bajo el conector.
- Falla en cerrado: cuando la lista no se puede leer, se rechaza toda llamada a los conectores.
- Solo para admins, y auditado con el resto de ajustes
(
GET/PUT /api/v1/admin/settings/blocked-operations).
Una alerta ante rechazos repetidos
La pasarela de conectores rechaza una llamada antes de que llegue al proveedor
cuando Kobi pide una herramienta que su conjunto no incluye
(tool_not_allowed) o envía una entrada que el conector rechaza
(input_refused). Cada rechazo se detiene y se audita, y una serie de ellos
tiene la forma de una inyección de prompt. Desde la 2.7.0:
kubebolt_kobi_mcp_refusals_total{consumer, connector, reason}, en el/metricspropio de la API, los cuenta. La denegación del propio proveedor no se cuenta. La etiquetatenant_idsiempre está vacía en la edición open source.KobiKeepsAskingForWhatItMayNotDo, en el grupokubebolt-kobide las reglas de alerta del chart (metrics.alertRules.enabled), salta con 5 o más rechazos en una hora sobre un mismo conector. Las series empiezan en 0, así que la primera serie de rechazos también alerta. Cada llamada rechazada queda en el registro de acceso comomcp_tool_call.
Solución de problemas
| Síntoma | Causa |
|---|---|
| ”This role can be assumed without your organization’s External ID.” | A la política de confianza le falta la condición sts:ExternalId. Añádela desde la política impresa y vuelve a probar |
| La prueba de AWS no puede asumir el rol después de una actualización | La política de confianza todavía tiene un external ID antiguo. Copia el generado desde el panel lateral |
| La tarjeta muestra un candado y una insignia de plan | El plan de la organización está por debajo del mínimo del conector |
| No aparece la pestaña Connectors | mcpConnectors.enabled=false, o la autenticación está desactivada |
| La prueba de AWS falla en el pod de la API por falta de credenciales | La ServiceAccount no tiene rol de IAM: añade la anotación de IRSA o una asociación de Pod Identity, o activa webIdentity fuera de EKS |
| Prueba de Azure: “Nothing answers at…” | El sidecar no está en ejecución (mcpConnectors.azure.sidecar.enabled, o el perfil azure de compose) |
El contenedor azure-mcp falla con CreateContainerConfigError | Falta el Secret, o no tiene tenant-id, client-id o client-secret |
En OpenShift, el pod se rechaza por el runAsUser del sidecar | Quita mcpConnectors.azure.sidecar.securityContext.runAsUser: restricted-v2 asigna uno |
| El botón de prueba dice “Test again in Ns” | Las pruebas tienen un ritmo limitado por conector |
| Una tarjeta de herramienta dice STS AssumeRole refused KubeBolt (AccessDenied) | La política de confianza del rol no deja que la identidad de KubeBolt lo asuma. El texto del SDK de AWS queda en el log de la API, y la llamada cuenta como unauthorized |
| Una tarjeta de herramienta dice Not read — cloud call limit… | El presupuesto por minuto retuvo la llamada. Kobi sigue sin ella; vuelve a preguntar en unos segundos |
| Una tarjeta de herramienta dice Not sent | KubeBolt rechazó la llamada antes del proveedor: una operación bloqueada, una herramienta que el conector no incluye, o una pregunta que ya usó sus 12 llamadas a la nube |
| Se rechazan todas las llamadas a los conectores | No se puede leer la lista de operaciones bloqueadas, así que la pasarela falla en cerrado. El log de la API dice por qué |
resourcehealth responde 409 | Microsoft.ResourceHealth todavía no está registrado, o se está registrando. En nuestra prueba tardó unos diez minutos |
| Kobi no usa un conector para un usuario concreto | El rol de ese usuario está por debajo del mínimo del conector |
| Kobi no usa un conector en absoluto | No está activado y verificado, o la evidencia del clúster respondió antes, que es lo previsto |