Conectar un Agente de IA

Dale a cualquier agente de IA una frase, y podrá trabajar en mindzieStudio por ti. Claude Cowork, Claude Code, Codex, Cursor o cualquier otro: configura proyectos y usuarios, carga datos y trabaja en AI Process Intelligence y BPM Studio, todo escuchando instrucciones en lenguaje natural.

Esa frase es todo lo que le das. La página a la que apunta está escrita para el agente: el agente pregunta a qué mindzieStudio te conectas y qué quieres hacer, calcula cómo puede conectarse y te indica dónde crear tu clave. La clave nunca se introduce en la conversación: la pones en la configuración del conector de tu agente, o en una página que el agente abre en tu navegador.

Qué Puede Hacer Tu Agente y Qué Necesita

Quieres que el agente...	Qué agentes	Clave
Trabaje en mindzieStudio: crear proyectos, añadir usuarios y decidir quién ve qué proyecto, cargar datos	Cualquier agente, incluyendo Claude Cowork y claude.ai	Clave de tenant
Trabaje en AI Process Intelligence y BPM Studio: crear, iniciar y detener proyectos, cargar datos, trabajar dentro de un proyecto, generar informes de IA, calendarios y alertas, editar diagramas	Todo lo anterior, en cualquier agente: Claude Cowork y claude.ai mediante el servidor MCP alojado, y agentes que puedan ejecutar comandos, como Claude Code y Codex, mediante la herramienta mz o el servidor alojado	Clave de tenant
Crear tenants para otras empresas	Cualquier agente	Clave global: solo administradores del servidor y socios

Detrás de la frase hay dos formas de acceso, y el agente elige la correcta: el servidor MCP alojado que ejecuta cada servidor mindzieStudio (no requiere instalación), y la herramienta mz que un agente que pueda ejecutar comandos se instala a sí mismo. No tienes que elegir. Para detalles de mz, consulta Conecta Tu Propio Agente.

Tu Clave

Una clave de tenant sirve para todo lo anterior. En mindzieStudio, abre el menú bajo tu nombre, luego Administración > Configuración > Claves API, y haz clic en Crear nueva clave secreta. Necesitas el rol de administrador en el tenant. La clave se muestra una vez, así que cópiala de inmediato.

Una clave API global abre todos los tenants en el servidor y puede crear nuevos tenants. Solo un administrador del servidor puede crear una (menú bajo tu nombre, Configuración del servidor > Claves API globales), y solo socios que configuran tenants para sus clientes la necesitan. Consulta Configurar un Cliente en Un Paso.

Configurar el Servidor MCP Alojado Manualmente

El agente te guía por esto solo. Esta sección es para cuando quieres hacerlo sin ayuda del agente.

La URL

Servidor	URL MCP
mindzieStudio (EE.UU.)	https://www.mindziestudio.com/mcp
mindzieStudio Europa	https://europe.mindziestudio.com/mcp
Tu propio servidor	https://<tu servidor>/mcp

Hay dos formas de pasar la clave:

Tu agente puede...	Introducir
Enviar un encabezado con una URL (Claude Cowork, Claude Code, Cursor, VS Code, APIs de agentes)	URL https://www.mindziestudio.com/mcp y encabezado Authorization: Bearer <tu clave API>
Solo aceptar una URL	https://www.mindziestudio.com/mcp/k/<tu clave API>

Trata la segunda forma como una contraseña. La clave es parte de la URL, por lo que quien vea la URL puede usar la clave. No la pegues en documentos compartidos ni chats. Si se filtra, elimina la clave en mindzieStudio y crea una nueva.

Agregarla a Tu Agente

Claude Cowork / aplicación de escritorio Claude

1. Abre Configuración > Conectores (en claude.ai: Personalizar > Conectores), elige Agregar, luego Agregar conector personalizado. Los conectores pertenecen a tu cuenta Claude, por lo que Cowork, la app de escritorio y claude.ai lo comparten.
2. Nómbralo mindzie y pega como URL https://www.mindziestudio.com/mcp.
3. En Autenticación, elige Sin inicio de sesión. Claude sugiere primero "Iniciar sesión ahora"; mindzieStudio usa clave API, y el encabezado de autorización solo puede añadirse tras seleccionar Sin inicio de sesión.
4. En Encabezados de la solicitud, añade el encabezado authorization con el valor Bearer <tu clave API> (la palabra Bearer, un espacio y luego la clave).
5. Guarda. Claude lista las herramientas mindzie. Inicia una conversación nueva y pregunta: "Usando mindzie, ¿con quién estoy conectado?" Claude pide permiso antes de cada llamada a una herramienta.

Si tu versión de Claude no muestra opción de encabezados, usa https://www.mindziestudio.com/mcp/k/<tu clave API> como URL.

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <tu clave API>"

Cursor / VS Code

Agrega a tu configuración MCP (.cursor/mcp.json o .vscode/mcp.json):

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <tu clave API>" }
    }
  }
}

Grok, OpenAI y otras APIs de agentes

Las APIs de agentes que soportan servidores MCP remotos toman una URL de servidor y un valor de autorización. Usa https://www.mindziestudio.com/mcp como URL y Bearer <tu clave API> como autorización. Si la API acepta solo URL, usa la forma /mcp/k/<tu clave API>.

Verificar la conexión

Pide a tu agente ejecutar mindzie_whoami. Responde con el servidor alcanzado y si la clave es global (canManageTenants: true) o limitada a un tenant (keyTenantId: el tenant que abre).

Configurar un Cliente en Un Paso

Esto requiere una clave API global, y es para socios que crean tenants para sus clientes. Con una clave de tenant, tu agente trabaja dentro de tu propio tenant.

La herramienta mindzie_provision_tenant configura un cliente completamente en una llamada:

• crea el tenant,
• activa o desactiva sus módulos (Process Mining, Data Designer, BPM Studio, AI Process Intelligence),
• da acceso al usuario administrador (se reutiliza una cuenta existente; se crea una nueva si no existe),
• crea los proyectos, con el admin como propietario, para que el admin los vea al instante.

Ejemplo de solicitud:

Usando mindzie, provisiona un tenant llamado acme-corp con nombre para mostrar "Acme Corporation", 5 usuarios y 2 analistas. Activa Process Mining y Data Designer, y desactiva BPM Studio y AI Process Intelligence. El admin es jane@acme.com (Jane Smith). Crea los proyectos "Purchase to Pay" y "Order to Cash".

No se envía ningún correo. Se crea una cuenta admin sin contraseña; el admin inicia sesión eligiendo Olvidé mi contraseña en la página de login, o le comunicas la contraseña inicial si defines una.

Muchos clientes a la vez

Dale al agente la lista (por ejemplo, una hoja de cálculo con nombres de empresa, correos admins y módulos) y pídele que provisione cada uno y reporte el resultado por cliente. Si la ejecución se detiene a medio camino, pídele que continúe con resumeExisting para los clientes ya existentes: los pasos ya hechos se reportan como existentes y no se duplican.

Cargar datos

Usa mindzie_upload_dataset_from_url con un enlace https a un archivo CSV de hasta 1 GB, por ejemplo un enlace de almacenamiento en cloud con token de lectura. El servidor mindzieStudio descarga el archivo directamente, por lo que archivos grandes nunca pasan por el chat. El enlace debe ser accesible públicamente; se rechazan enlaces a direcciones privadas o internas.

Para unos pocos miles de filas también puedes pegar el texto CSV con mindzie_upload_dataset_csv_text.

Herramientas Disponibles

Herramienta	Qué hace	Clave necesaria
mindzie_whoami	Información del servidor y clave	Cualquiera
mindzie_provision_tenant	Tenant, módulos, admin y proyectos en una llamada	Global
mindzie_list_projects, mindzie_get_project, mindzie_create_project, mindzie_update_project, mindzie_delete_project	Proyectos mindzieStudio	Global o tenant
mindzie_list_project_members, mindzie_add_project_member	Quién puede ver un proyecto	Global o tenant
mindzie_list_datasets, mindzie_upload_dataset_csv_text, mindzie_upload_dataset_from_url	Conjuntos de datos	Global o tenant

Además, el servidor ofrece las mismas herramientas que la línea de comandos mz, generadas desde las mismas especificaciones, por lo que nunca se desincronizan. Cada una es un grupo de comandos, llamados con un method y sus params; el método describe lista los parámetros de un método.

Herramienta	Qué hace	Clave necesaria
projects, projects_backups, projects_keys, projects_reports	Proyectos AI Process Intelligence: crear, iniciar, detener, renombrar, cambiar tamaño, eliminar, importar desde archivo; respaldos y restaurar; ejecutar nuevamente un informe publicado	Tenant
cube_log, cube_files, cube_data, cube_eventlogs, cube_schema, cube_build, cube_filters, cube_enrichments, cube_rules, cube_calendar, cube_costs, cube_jobs, cube_reports, cube_schedules, cube_alerts, cube_styles y otros	Todo dentro del cubo de un proyecto: subir y cargar datos, consultar el registro de eventos, filtros, enriquecimientos, reglas, esquema, trabajos de informes de IA, informes publicados, calendarios y alertas. Cada uno recibe pi_project_id; el proyecto debe estar activo	Tenant
bpmn_diagrams, bpmn_comments, bpmn_approvals, bpmn_audit, bpmn_ai, bpmn_ai_files	BPM Studio: modelos, revisiones, comentarios, aprobaciones, registro de auditoría, investigaciones AI desde una imagen o un SOP	Tenant, o global con tenant_id
studio_projects, studio_projects_members	Proyectos en que BPM Studio trabaja, y sus miembros	Tenant, o global con tenant_id
tenants, tenants_settings, users, users_tenant	Tenants, su configuración y módulos, usuarios	Global

Las eliminaciones requieren el nombre exacto de lo que se borra. El trabajo con IA — un informe de IA, ejecutar un informe otra vez, una investigación IA en BPM Studio — consume los créditos IA del tenant.

Cada herramienta sigue exactamente las mismas reglas que la REST API: mismos permisos, validaciones y mensajes de error.

Bueno Saber

• Un tenant vacío tiene los módulos por defecto del servidor, que puede no ser lo que espera un cliente. Usa mindzie_provision_tenant, o configura los módulos explícitamente con el método update de tenants_settings.
• Un proyecto solo es visible para sus miembros. Un proyecto creado con mindzie_create_project no tiene miembros hasta que los añades con mindzie_add_project_member. mindzie_provision_tenant lo hace por ti.
• Eliminar es permanente. Un buen agente confirma primero contigo; las herramientas de borrar requieren los nombres exactos.
• Cada llamada a herramienta queda registrada en el servidor con el nombre de la clave API que la hizo.

Solución de Problemas

Lo que ves	Por qué	Qué hacer
HTTP 401 / "sin autorización" al conectar	La clave es incorrecta, fue borrada o es para otro servidor (cada región tiene sus propias claves)	Crea una clave en el servidor al que te conectas
"requiere una clave API global"	Se usó clave de tenant para una herramienta que trabaja entre tenants (listar, crear, modificar o eliminar tenants, configuraciones o módulos)	Esas herramientas son para administradores de servidor y socios que configuran tenants. Trabaja dentro de tu tenant con herramientas de proyecto, usuario y dataset. Si creas tenants para otras empresas, ve Configurar un Cliente en Un Paso
"controlado con clave API TENANT, nunca una global"	Se usó clave global en una herramienta de Process Intelligence o cube_	Crea una clave de tenant en el tenant donde está el proyecto, y conéctate con esa
"no tiene acceso al tenant"	El id del tenant no coincide con el tenant de la clave	Usa keyTenantId de mindzie_whoami
El admin inicia sesión y no ve proyectos	No es miembro de los proyectos	Usa mindzie_add_project_member, o provisiona con mindzie_provision_tenant
"ya existe" al provisionar	El nombre del tenant está ocupado	Si es el mismo cliente, ejecuta de nuevo con resumeExisting; si no, elige un nombre distinto
"dirección no pública" al cargar datos	El enlace apunta a una dirección privada o interna	Usa un enlace https accesible públicamente