Ir al contenido

Administrar los conectores

La tabla tiene una fila por conector, con su nombre, la columna Tipo (Nativo o MCP), la columna Autorización (Individual, si cada persona conecta su cuenta, o Automática), su Categoría y su Estado: Prendido, Apagado, Falta configurar, «Configurando…», «Quitando…» o Falló la configuración (los automáticos dicen Prendido, Opcional o Apagado). Arriba podés buscar por nombre o categoría, filtrar por Tipo, Categorías o Estado, y con Agregar sumar un servidor MCP propio.

En el menú ⋮ de cada fila:

  • Prender o Apagar el conector para todos. Apagarlo pregunta antes: las cuentas conectadas se ocultan y lo que las usa deja de andar hasta que lo vuelvas a prender. No se borra nada.
  • Modo… en los conectores automáticos: Apagado (nadie lo puede usar), Opcional (cada persona lo agrega) o Prendido (para todos automáticamente). La elección se aplica al tocar Listo.
  • Tipos de recurso… para elegir qué clase de recursos puede traer el agente.
  • Configurar la app… para cargar las credenciales de tu empresa (abajo). Si el conector ya funciona con la app de Nouter, dice App propia….
  • Editar… y Quitar en los servidores MCP propios.

Con Pedidos de conectores marcado, los miembros te pueden pedir que prendas un conector apagado (Pedir un conector). Cuando hay, aparecen arriba de la tabla, en N solicitudes pendientes, una fila por conector con cuántas personas lo pidieron, la fecha del último y, si lo dijeron, para qué lo necesitan. Sin pedidos pendientes, solo se ve el ajuste Pedidos de conectores.

  • Aprobar prende el conector para todos y cierra el pedido.
  • Si lo prendés por otro camino (Prender en el ⋮, o configurando su app), el pedido se cierra solo la próxima vez que la tabla lo muestra prendido.
  • Descartar pregunta antes, y después lo cierra.

En los dos casos, a quien lo pidió le llega un email; si se aprobó, el email lo lleva a Personalizar → Conectores → Descubrir para conectar su cuenta. Si Aprobar está gris, la línea de abajo dice por qué. Un conector al que todavía le falta su app muestra Configurar en su lugar, el mismo botón que su fila.

Google, Slack, Salesforce y GitHub usan una app que crea tu empresa, para que las conexiones sean tuyas y no de nouter. Mientras no la cargues, la fila dice Falta configurar, con el botón Configurar, y nadie puede conectarlo. Cuando la guardás, pasa a «Configurando…» y en alrededor de medio minuto a Prendido.

Google y GitHub pueden estar ya disponibles con la app de Nouter: la fila lo dice y cada persona conecta su cuenta sin que cargues nada. Al abrir App propia… vas a ver «Todos pueden conectar … con la app de Nouter. No hace falta configurar nada.», y el formulario plegado en Usá la app de tu empresa. Cargar la app de tu empresa es opcional y la reemplaza, pero todos tienen que volver a conectar ese conector.

Cuando cambiás la app de un conector (cargás la de tu empresa, la quitás o cambiás el Client ID), las cuentas que la gente ya tenía conectadas dejan de servir. No hace falta que nadie las desconecte: desaparecen solas la próxima vez que cada persona abre sus conectores, y cada una conecta de nuevo.

El formulario de la app muestra los pasos de cada proveedor y la URL de vuelta (callback) que hay que pegar en la app del proveedor, con Copiar al lado, y el link Guía paso a paso a esta página. Siempre es la dirección de tu organización, el camino del conector y /oauth:

https://<la dirección de tu organización>/<camino del conector>/oauth
  1. En Google Cloud, elegí un proyecto y habilitá las APIs de Gmail, Calendar, Tasks, Drive, Docs, Sheets y Slides. Si van a usar Chat o BigQuery, habilitalas también (Chat, con la People API). Un recurso cuya API falta no anda para nadie, y volver a conectar no lo arregla: Google rechaza el pedido por el proyecto, no por la cuenta.
  2. Configurá la pantalla de consentimiento de OAuth como Interno, así solo entran las cuentas de tu organización. Interno solo está disponible si la empresa usa cuentas corporativas de Google (Google Workspace o Cloud Identity); si no, elegí Externo:
    • Mientras la app está en Prueba (Testing), solo pueden conectarse los usuarios de prueba que agregues, y tienen que reconectarse cada 7 días.
    • Cuando la publicás, cualquiera puede conectarse después del aviso de Google de app no verificada, hasta 100 usuarios mientras Google no la verifique.
  3. Creá un cliente OAuth (Aplicación web) y agregá la URL de vuelta como URI de redireccionamiento autorizado.
  4. Pegá su Client ID y su Client secret en Nouter y guardá.
  1. En api.slack.com/apps, creá una app (From scratch) en el espacio de Slack de tu empresa.
  2. En OAuth & Permissions, agregá la URL de vuelta en Redirect URLs.
  3. En OAuth & Permissions → User Token Scopes, agregá estos scopes, de a uno: users:read, team:read, channels:read, channels:history, groups:read, groups:history, im:read, im:history, mpim:read, mpim:history, search:read, chat:write, reactions:write, im:write y mpim:write. Los últimos cuatro dejan que el agente publique con la aprobación de cada persona; si tu app ya estaba armada, sumalos también.
  4. En Basic Information → App Credentials, copiá el Client ID y el Client Secret, pegalos en Nouter y guardá.

Si en tu app de Slack prendés la rotación de tokens (Token Rotation, en OAuth & Permissions), Nouter renueva el token de cada persona antes de que venza, sin que tenga que volver a conectar. Sin la rotación, los tokens no vencen.

Creá una External Client App (Setup → External Client App Manager) con OAuth, la URL de vuelta, los scopes Manage user data via APIs (api) y Perform requests at any time (refresh_token), y PKCE obligatorio. Dejá apagado Issue JSON Web Token (JWT)-based access tokens for named users: con esos tokens algunos objetos, como Contact, fallan. Pegá su Consumer Key. Los otros dos campos son opcionales:

  • Client secret, solo si la app es confidencial (pide el secret para el intercambio). Una app pública, con PKCE y sin secret, anda sin él.
  • URL de login, solo si tu org entra por su My Domain (https://<tu dominio>.my.salesforce.com) o si es un sandbox (https://<tu dominio>--<sandbox>.sandbox.my.salesforce.com o https://test.salesforce.com). Si la dejás vacía, se usa https://login.salesforce.com.

Salesforce tarda unos 10 minutos en aplicar los cambios de la app. Si tu app ya existía con el scope mcp_api, sumale api: sin él, al conectar Salesforce responde «Salesforce no concedió acceso a la API».

Si la fila dice Disponible para todos con la app de Nouter, cada persona conecta su cuenta de GitHub y ve los repositorios de las organizaciones donde está instalada la app de Nouter. Para sumar una organización, instalá la app desde Organización → Git providers (Conectar GitHub a tu organización). Si la app pide permisos nuevos, el admin de la organización los acepta en GitHub.

Para usar la app de tu empresa, creá una OAuth App (Settings → Developer settings → OAuth Apps) con la URL de vuelta y pegá el Client ID y un client secret. Con ella, el conector llega a todo lo que ve cada persona, sin instalar nada. Una OAuth App acepta una sola URL de vuelta.

El secret se guarda cifrado y no se vuelve a mostrar: el campo queda como Cargado y, si lo dejás vacío, se conserva. Para rotarlo, creá el nuevo en el proveedor, pegalo acá y recién después borrá el viejo.

EmDash no usa una app de tu empresa: cada persona conecta el sitio con su propio usuario de EmDash. Los tres campos de su formulario son opcionales y van juntos o ninguno: solo hacen falta si el /_emdash de tus sitios está detrás de Cloudflare Access. En Cloudflare Zero Trust, creá un service token y una política de Service Auth que lo incluya sobre el /_emdash del sitio, y pegá acá el Host de Access (por ejemplo cms.example.com), el Client ID y el Client Secret del token. nouter manda el token solo a ese host, y la autorización en el navegador sigue pasando por Access con la cuenta de cada persona. Hay un solo host por organización. Sin los campos, los sitios sin Access funcionan igual. Guardarlos no obliga a nadie a reconectar. El paso a paso está en Conectar EmDash.

Si un cambio de estado o de modo falla, vuelve al estado anterior y aparece un aviso. Si una fila dice «Falló la configuración», guardala de nuevo para reintentar. Los problemas típicos de conexión están en Problemas al conectar.