Conectar tu asistente de IA a la consola

El servidor MCP de UTILIA OS para desarrolladores: su dirección, cómo autorizarlo con tu cuenta, sus herramientas y permisos, y lo que tu asistente no hace.

Actualizado el 23 de octubre de 2026. 8 min de lectura

Con el servidor MCP «UTILIA OS para desarrolladores», tu asistente de IA trabaja con tu cuenta de desarrollador: crea aplicaciones, prepara la ficha y sus imágenes, pone los planes de precio, abre empresas de prueba, instala tu aplicación para probarla y la envía a revisión. Lo hace con tus permisos y solo con lo que autorices al conectarlo. Tú intervienes donde la ley o la seguridad lo exigen.

Antes de empezar

Una cuenta de desarrollador. El servidor no admite cuentas de empresa: para trabajar con los datos de una empresa están sus propios servidores, en Primeros pasos con MCP.
Un asistente que se conecte a servidores MCP con OAuth: Claude de pago (Pro, Max, Team o Enterprise), ChatGPT de pago (Plus, Pro, Business, Enterprise o Edu), Cursor o Claude Code.
Para lo crítico (enviar a revisión, borrar una empresa de prueba y cambiar los datos fiscales), la verificación en dos pasos activada con una aplicación de autenticación: lo confirmas en la consola con su código. No hace falta el teléfono con la app de UTILIA OS.

La dirección del servidor

https://os.utilia.ai/api/mcp/developers

También la tienes en el Inicio de la consola, en Conecta tu IA, con un botón para copiarla. Es la misma desde platform.os.utilia.ai. El servidor solo acepta conexiones autorizadas con OAuth: no hay claves que copiar.

Conectarlo

claude mcp add --transport http utilia-developers https://os.utilia.ai/api/mcp/developers

Claude Code: pega el comando en tu terminal, abre Claude Code y escribe /mcp para autorizar la conexión.
Cursor: en su Configuración, entra en Herramientas y MCP, pulsa Nuevo servidor MCP, pega el bloque en el archivo mcp.json y guárdalo.
Claude: abre Personalizar, entra en Conectores, pulsa +, elige Añadir conector personalizado, pega la dirección y pulsa Añadir.
ChatGPT: en Configuración, ve a Aplicaciones y conectores y activa el Modo desarrollador. Pulsa Crear, pega la dirección, elige OAuth como autenticación y actívalo en Herramientas dentro del chat.

Autorizar la conexión

La primera vez, tu asistente abre el navegador para que entres con tu cuenta de desarrollador y apruebes la conexión.

La primera conexión

De Tu asistente a UTILIA OS:
POST /api/mcp/developers
Primera llamada, todavía sin token.
De UTILIA OS a Tu asistente:
401 y dónde autorizar (respuesta)
Con los datos para registrarse y pedir permiso.
De Tu asistente a Navegador:
Abre la autorización
En platform.os.utilia.ai, con la sesión de la consola.
Nota en Navegador:
Entras con tu cuenta de desarrollador y lees lo que podrá hacer.
De Navegador a UTILIA OS:
Autorizar UTILIA OS para desarrolladores
Con lo que hayas dejado marcado.
De UTILIA OS a Tu asistente:
Token de acceso (respuesta)
Atado a tu cuenta y a este servidor.

6 pasos

El token solo vale para este servidor: no abre ninguna empresa ni ningún otro servidor MCP.

La pantalla de autorización enseña, agrupado, lo que podrá hacer tu asistente. Solo te ofrece lo que tu rol en la cuenta te deja conceder, y puedes quitar lo que no quieras darle antes de pulsar Autorizar UTILIA OS para desarrolladores. Una empresa no puede obtener un token de este servidor, ni tu cuenta de desarrollador uno de los servidores de las empresas.

Lo que puede hacer

Herramienta	Para qué	Operaciones
`dev_account`	Estado de la cuenta, primeros pasos, perfil público, dominio, NIF y datos fiscales	10
`dev_apps`	Ver y crear tus aplicaciones; la clave de una aplicación nueva se enseña una sola vez	3
`dev_listings`	Fichas: borrador, «Antes de enviar», envío a revisión, retirada, conversación de la revisión e instalaciones	13
`dev_listing_images`	Icono y capturas, con una subida firmada en tres pasos	3
`dev_listing_plans`	Planes y precio de una ficha de pago	5
`dev_sandboxes`	Empresas de prueba y sus correos capturados	9
`dev_testing`	Instalación de prueba, diagnóstico de la aplicación y entregas de sus avisos	5
`dev_docs`	Buscar y leer esta documentación	2

Cada operación exige, a la vez, tu permiso en la cuenta y el permiso del token, que se llama ámbito. Leer y escribir van siempre en ámbitos distintos:

Ámbito	Qué permite
`developer:account:read`	Ver tu cuenta: primeros pasos, perfil público, dominio, condiciones y datos fiscales.
`developer:account:write`	Cambiar el perfil y los datos fiscales, comprobar el dominio y el NIF, y pedir a la persona titular que acepte las condiciones.
`developer:apps:read`	Ver tus aplicaciones, sus fichas, versiones, imágenes, revisiones, instalaciones, diagnóstico y entregas de avisos.
`developer:apps:write`	Crear aplicaciones y editar el borrador de sus fichas y sus imágenes.
`developer:pricing:write`	Crear, cambiar, ordenar y quitar los planes de pago. Se quedan en el borrador hasta que una persona envía la versión y UTILIA la aprueba.
`developer:listings:submit`	Enviar a revisión aceptando las Normas del catálogo, cancelar el envío, retirar del catálogo o volver a publicar, y responder o recurrir a la revisión.
`developer:sandboxes:read`	Ver tus empresas de prueba y sus correos capturados.
`developer:sandboxes:write`	Crear, renombrar, restablecer y borrar empresas de prueba.
`developer:testing:write`	Instalar la versión en preparación de una ficha en una empresa de prueba.
`developer:docs:read`	Buscar y leer la documentación para desarrolladores.

Confirmaciones

Algunas operaciones piden confirm: true, y tu asistente solo lo pone cuando tú se lo has pedido: cancelar un envío, retirar del catálogo, volver a publicar, restablecer una empresa de prueba y quitar un plan.

Tres son críticas: enviar a revisión, borrar una empresa de prueba y cambiar los datos fiscales. Esas las confirmas tú, en la consola:

Tu asistente hace la llamada y recibe APPROVAL_REQUIRED con una dirección de la consola, platform.os.utilia.ai/approvals/…. Te la pasa.
La abres con tu sesión de la consola. Ves qué asistente lo pide y qué va a hacer, con sus datos: la ficha que se envía, los datos fiscales tal y como se guardarán o la empresa de prueba que se borra.
Si estás de acuerdo, escribes el código de tu aplicación de autenticación y pulsas Confirmar. Si no lo has pedido tú, pulsa Rechazar.
Le dices a tu asistente que ya está. Repite exactamente la misma llamada con el identificador de la confirmación y la operación se hace una vez.

Una operación crítica

De Tu asistente a UTILIA OS:
Llama a la operación
Por ejemplo, enviar una ficha a revisión.
De UTILIA OS a Tu asistente:
APPROVAL_REQUIRED (respuesta)
Con la dirección de la consola donde confirmarla.
De Tu asistente a Tú, en la consola:
Te pasa la dirección
La abres con tu sesión.
De Tú, en la consola a UTILIA OS:
Confirmar con tu código
El de tu aplicación de autenticación.
De Tu asistente a UTILIA OS:
Repite la misma llamada
Con el identificador de la confirmación: se hace una vez.

5 pasos

La confirmación solo vale para esa operación, con esos datos, y para el asistente que la pidió.

Lo que conviene saber:

Caduca a los 10 minutos. Si se pasa, pide a tu asistente que lo intente otra vez y te dará una dirección nueva.
Solo tú la ves y la confirmas, en tu propia sesión de la consola: ni otra persona de tu equipo, ni una clave de API, ni el propio asistente, ni el soporte de UTILIA. Tampoco se confirma desde la app del móvil.
Va atada a lo que pidió el asistente. Si cambia cualquier dato de la llamada, la confirmación ya no vale.
Cinco códigos equivocados y la confirmación queda rechazada.
Si tu asistente te pide confirmar algo que no has pedido, recházalo. Nadie de UTILIA te pedirá nunca ese código.

Si no tienes la verificación en dos pasos con una aplicación de autenticación, tu asistente te da la dirección de Cuenta › Seguridad para añadirla o la de la pantalla donde hacer el cambio tú mismo. Cuando la consola te avisa de una confirmación pendiente, el aviso lleva a la misma pantalla.

Lo que tu asistente no hace

Hay cosas que solo hace una persona en la consola, a propósito:

aceptar las Condiciones para desarrolladores o las condiciones de venta: ningún asistente puede aceptar textos legales en tu nombre;
configurar la cuenta de cobro y verificarse con Stripe;
activar la verificación en dos pasos, traspasar la titularidad y cerrar la cuenta;
gestionar el equipo y vincular la cuenta con tu empresa;
entrar en una empresa de prueba y abrir la dirección de conexión de una instalación de prueba.

El dinero no va por MCP: ni ingresos, ni extractos, ni transferencias, ni reembolsos. Y una clave de API nunca envía una ficha a revisión: lo hace una persona, en la consola o con su asistente y su confirmación en la consola.

Cuando tu asistente necesita algo de esta lista, la operación person_steps de dev_account le da la dirección exacta de la consola, y te la pasa.

Un recorrido completo

Es el orden que sigue tu asistente para publicar una aplicación:

dev_account con get_next_steps, para ver qué falta.
dev_apps con create. Guarda tú las dos claves en tu gestor de secretos: no se repiten en la conversación.
dev_listings con create y update_draft, con los textos, los permisos y las direcciones.
dev_listing_images para el icono y las capturas y, si es de pago, dev_listing_plans para los planes.
dev_sandboxes con create y dev_testing con test_install; si algo falla, get_diagnosis.
dev_listings con get_checks hasta que todo esté en verde.
dev_listings con submit y acceptPolicy: true, cuando aceptes las Normas del catálogo.

El resultado de la revisión y sus mensajes llegan por get_review_thread. Qué comprueba UTILIA está en Revisión de la ficha.

Si algo falla

«Este servidor es de UTILIA OS para desarrolladores…» Has entrado con una cuenta de empresa. Autoriza con tu cuenta de desarrollador.
Una operación responde que falta un ámbito. No lo autorizaste al conectar. Desconecta el servidor en tu asistente y vuelve a conectarlo, dejando marcado lo que necesita.
Te falta un permiso. Tu rol en la cuenta no lo tiene: lo explica Equipo y roles.
APPROVAL_REQUIRED cada vez. Abre la dirección que te da tu asistente y confírmala antes de que repita la llamada; si caduca, pide la operación otra vez.
«Esta confirmación no está disponible». Ha caducado, ya se usó o la abriste con otra cuenta. Entra con la cuenta de desarrollador con la que conectaste el asistente o pide la operación otra vez.
Necesitas la verificación en dos pasos con una aplicación de autenticación. Añádela en Cuenta › Seguridad, o haz el cambio directamente en la consola.

En esta página