Conectar una integración con Dogesti

Qué lograrás

Conectar una integración a la empresa con el método que corresponda: una clave API con permisos escogidos, una configuración para un cliente MCP o una conexión OAuth ya autorizada.

Quién puede hacerlo y qué necesitas

La página Ajustes → API y conexión a MCP está disponible para Administrador. Antes de crear una clave, acuerda qué información o acciones necesita la integración y quién será responsable de guardarla.

Crear y entregar una clave

1. En Ajustes → API y conexión a MCP, abre Nueva clave y asigna un nombre que identifique integración y propósito.

2. Selecciona el conjunto mínimo de permisos que necesita la integración. En la opción personalizada, elige lectura y, solo si corresponde, edición por recurso.

3. Crea la clave y copia el token y la configuración que muestra la pantalla. Entrega el secreto por el canal seguro acordado y guárdalo en el servidor de la integración.

4. Configura el cliente MCP con la URL y el bloque que ofrece la pantalla. Para consultar el catálogo desde una integración propia, usa la sección de API de productos y concede el permiso de catálogo necesario.

5. Regresa a la lista de claves para revisar nombre, estado y permisos. Revoca una clave que ya no uses o que haya quedado expuesta y crea otra con el alcance necesario.

Revisar una conexión OAuth

En Conexiones OAuth, comprueba el nombre del cliente, quién autorizó, los permisos y la fecha de vencimiento. Si la conexión ya no debe acceder a la empresa, usa Revocar. La acción detiene esa autorización; no revoca las claves API independientes.

El secreto no es un nombre de usuario

La clave se muestra al crearla y después la lista solo identifica su prefijo. No pegues el token en un navegador, documento público, chat ni repositorio. Si no puedes comprobar quién lo recibió, revócalo y crea otro.

Resultado esperado

La clave queda registrada con nombre, estado y permisos identificables, y el administrador conserva una forma de revocarla cuando deje de ser necesaria. La pantalla de conexiones muestra el estado de las autorizaciones OAuth. Crear una clave o copiar la configuración no comprueba por sí solo que la integración ya esté conectada: verifica la conexión desde el cliente que la utilizará.

Problemas frecuentes

• No aparece API y conexión a MCP: confirma que la sesión sea de Administrador y que estés en la empresa correcta.
• La integración no puede leer el catálogo: revisa que tenga el permiso de catálogo requerido.
• El token no está disponible en la lista: revoca esa clave y crea una nueva; la lista no vuelve a mostrar el secreto completo.
• La conexión OAuth no aparece: confirma si el cliente se autorizó con OAuth o con una clave API; son accesos distintos.
• Una clave dejó de funcionar: revisa si está revocada y si el cliente envía la configuración vigente.

Temas relacionados

• Usar el asistente del panel
• Auditoría de la organización
• Configurar empresa y equipo