Conecte su asistente de AI a Azumuta

Actualizado

BETA: Azumuta MCP está actualmente en beta y puede seguir evolucionando. Está disponible solo mediante participación voluntaria. Para unirse a la beta o plantear preguntas, contacte con support@azumuta.com.

Model Context Protocol (MCP) conecta su asistente de IA preferido con los datos permitidos de Azumuta. Puede hacer preguntas sobre instrucciones de trabajo, pedidos de producto, grabaciones e incidencias sin copiar manualmente esos datos a una conversación.

Las herramientas MCP de Azumuta son de solo lectura. No pueden modificar su espacio de trabajo. Consulte Uso de Azumuta MCP para ver ejemplos y limitaciones.

Antes de comenzar

  • Habilite la beta de MCP para su espacio de trabajo.
  • Utilice un asistente de IA aprobado por su organización. El asistente debe soportar conexiones MCP remotas y un encabezado Authorization.
  • Asegúrese de tener permiso para gestionar API devices, o pida al administrador de su espacio de trabajo que cree la clave.
  • Revise qué datos puede compartir con el cliente de IA y su proveedor de modelo. Los datos recuperados se envían a ese cliente y a su proveedor.

Cursor es el asistente ejemplificado en esta guía. Otros asistentes de IA tienen controles de configuración diferentes. No necesita instalar el servidor Azumuta MCP en su equipo.

Si API scopes no está disponible, o necesita ayuda con la configuración de la conexión, contacte con support@azumuta.com.

Crear una clave con acceso de lectura

Una clave API selecciona el espacio de trabajo y controla qué categorías de datos puede acceder el asistente. Su acceso no coincide necesariamente con los permisos en la aplicación web. Pida a su administrador que la revise antes de conectar.

  1. Create a dedicated API device en el espacio de trabajo que desea conectar.
  2. Abra Edit device para ese dispositivo.
  3. Abra Security.
  4. Bajo API scopes, seleccione Restrict this API key to a subset of operations.
  5. Desmarque los ámbitos seleccionados que no necesite. La selección inicial incluye todos los ámbitos.
  6. Seleccione solo las opciones Read requeridas de la tabla siguiente.
  7. Guarde el dispositivo.
  8. Copy its API key.
Scope group Read access Scope identifier
Work instructions Instrucciones de trabajo, contenido y versiones workinstructions:read
Recordings Grabaciones de instrucciones de trabajo y datos de informes estructurados recordings:read
Products Órdenes de producto y detalles de su ejecución products:read
Issues Incidencias, tableros, flujos y cambios de estado issues:read
Users Detalles de usuario users:read
Spots Zonas y estaciones spots:read

MCP requiere ámbitos explícitos. Una clave sin ámbitos seleccionados no proporciona acceso MCP ilimitado. Algunas consultas necesitan varios ámbitos, por ejemplo Work instructions y Recordings.

Alcances de API filtrados a Instrucciones de trabajo, con Read seleccionada y Write y Delete desmarcadas

Conecte su asistente de IA preferido

Para un espacio de trabajo en app.azumuta.com, utilice estos ajustes:

Setting Value
Connection type Remote MCP using Streamable HTTP
Server URL https://mcp.azumuta.com/mcp
Header name Authorization
Header value Bearer <AZUMUTA_API_KEY>

Reemplace <AZUMUTA_API_KEY> por su clave. Mantenga el espacio después de Bearer. Esta conexión usa una clave API, no un inicio de sesión de Azumuta en el navegador.

Use una clave del entorno correspondiente. Una clave sandbox no conecta con producción. Para otro entorno, use su endpoint MCP confirmado.

Ejemplo: conectar en Cursor

  1. Abra Cursor Settings.
  2. Abra Customize.
  3. Seleccione MCPs.
  4. Seleccione New MCP Server. Cursor abre el archivo de configuración a nivel de usuario mcp.json.
  5. Añada la entrada azumuta que aparece abajo dentro de mcpServers. Mantenga las entradas de servidor existentes.
  6. Reemplace <AZUMUTA_API_KEY> por su clave dedicada.
  7. Guarde el archivo.
  8. Vuelva a Customize → MCPs.
  9. Abra la configuración del servidor Azumuta.
  10. Si la conexión está deshabilitada, actívela.
  11. Compruebe que la conexión muestre Connected y liste las herramientas esperadas.
{
  "mcpServers": {
    "azumuta": {
      "url": "https://mcp.azumuta.com/mcp",
      "headers": {
        "Authorization": "Bearer <AZUMUTA_API_KEY>"
      }
    }
  }
}

El archivo a nivel de usuario es ~/.cursor/mcp.json. Puede poner esta conexión disponible en sus proyectos. No ponga una clave real en una configuración de proyecto compartida, repositorio, prompt o captura de pantalla. Cursor también soporta referencias a variables de entorno en los valores de los encabezados; consulte Cursor’s MCP documentation.

Cursor muestra la conexión Azumuta como Conectado y lista herramientas de solo lectura

Verificar la conexión

En la versión ilustrada de Cursor, el modo Agent permite estas llamadas MCP. El modo Ask puede bloquearlas. Limite la solicitud a Azumuta MCP y revise las herramientas utilizadas. Otras herramientas de Agent pueden tener acceso de escritura.

  1. Inicie una nueva conversación con su asistente de IA.
  2. Introduzca: Utilice Azumuta MCP para listar cinco instrucciones de trabajo. Incluya sus nombres e IDs.
  3. Si el cliente solicita aprobación, revise la herramienta y sus argumentos antes de aprobar la lectura.
  4. Compare las instrucciones de trabajo devueltas con el espacio de trabajo de Azumuta seleccionado.

Esta comprobación requiere Work instructions: Read. Una lista vacía no significa necesariamente que la conexión haya fallado. Compruebe la respuesta de la herramienta y si el espacio de trabajo contiene instrucciones de trabajo accesibles.

Continúe con preguntas de ejemplo y limitaciones.

Problemas de conexión

Symptom Check
Authentication error Confirme el endpoint, el entorno correspondiente, la clave API y el encabezado Bearer. Nunca incluya la clave en un mensaje de soporte.
Access denied or no expected tools Confirme el acceso a la beta y los ámbitos de Read explícitos de la clave. Tras cambiar los ámbitos, vuelva a conectar o actualice la lista de herramientas.
A record cannot be found Compruebe su nombre o ID y el espacio de trabajo seleccionado por la clave.
The response is too large or incomplete Reduzca la consulta. Especifique un registro, un filtro o un número pequeño de resultados. Pregunte si quedan más páginas.

Desconectar o revocar el acceso

Para dejar de usar la conexión en un cliente, desactive o elimine la entrada Azumuta MCP allí. Esto no invalida la clave API.

Para revocar la clave:

  1. Vaya a Management → Devices → API en Azumuta.
  2. Abra el menú de fila para el API device dedicado.
  3. Seleccione Delete device.
  4. Confirme la eliminación.

Eliminar el dispositivo invalida su clave para todas las integraciones que la usan. Compruebe que el dispositivo no esté compartido antes de eliminarlo. La revocación no elimina los datos ya devueltos a una conversación de IA.

En esta página