Plan, peticiones de ampliación y llamadas por MCP
La herramienta org_plan: consultar el plan y la bolsa de IA, pedir que se amplíe el plan y reservar una videollamada de 15 minutos con UTILIA, con sus scopes y confirmaciones.
Actualizado el . 4 min de lectura
La herramienta org_plan deja que un asistente consulte el plan de tu organización, pida que se amplíe y reserve una videollamada de 15 minutos con una persona de UTILIA. Está en todos los servidores con el mismo contrato y no depende de ningún aplicativo contratado: el plan se puede consultar y ampliar precisamente cuando falta algo.
Son las mismas acciones que en la aplicación explican Pedir que se amplíe el plan y Reservar 15 minutos con UTILIA.
Consultar el plan
| Operación | Qué devuelve | Permiso | Scope |
|---|---|---|---|
get | El plan contratado y los aplicativos y capacidades del área del servidor, con su estado. | SETTINGS_ORGANIZATION_VIEW (Ver organización) | org:plan:view |
ai_usage | El consumo de la bolsa de IA, en porcentaje, y el saldo adicional comprado, en céntimos de euro. | SETTINGS_ORGANIZATION_VIEW (Ver organización) | org:plan:view |
Pedir que se amplíe el plan
| Operación | Qué hace | Permiso | Scope | confirm |
|---|---|---|---|---|
request_upgrade | Pide a quien administra la cuenta que amplíe el plan para una capacidad, un aplicativo o un plan. | Ninguno | org:plan:request | no |
list_my_requests | Lista tus peticiones. | Ninguno | org:plan:request | no |
withdraw_upgrade_request | Retira una petición tuya. | Ninguno | org:plan:request | no |
list_requests | Lista las peticiones del equipo. | SETTINGS_ORGANIZATION_VIEW (Ver organización) | org:plan:view | no |
dismiss_request | Cierra una petición del equipo, con un motivo para quien la hizo. | SETTINGS_ORGANIZATION_EDIT (Editar organización) | org:plan:manage_requests | no |
Las tres operaciones de quien pide no exigen permiso: cualquiera puede pedir una ampliación, y solo puede ver y retirar las suyas. list_my_requests es una lectura, pero va bajo org:plan:request, el mismo scope que pedir, para que un token de solo lectura no se entere de lo que ha pedido su dueño.
request_upgrade y dismiss_request reciben siempre la pareja targetKind (CAPABILITY, MODULE o PLAN) y targetKey, la clave que devuelve get. request_upgrade devuelve en una sola respuesta el estado de la petición, si ha llegado a alguien que pueda ampliar el plan, si ya tenías una igual, cuántos compañeros lo han pedido y el enlace al escaparate: no hace falta llamar antes a get. Con note (hasta 500 caracteres) puedes explicar para qué lo necesitas.
Reservar una videollamada con UTILIA
| Operación | Qué hace | Permiso | Scope | confirm |
|---|---|---|---|---|
list_sales_call_slots | Horas libres para reservar. | Ninguno | org:plan:view u org:plan:request | no |
get_my_sales_call | Tu cita, si tienes una. | Ninguno | org:plan:view u org:plan:request | no |
book_sales_call | Reserva una hora o pide que te llamen. | Ninguno | org:plan:request | sí |
cancel_sales_call | Cancela tu cita. | Ninguno | org:plan:request | sí |
reschedule_sales_call | Cambia la hora de tu cita. | Ninguno | org:plan:request | sí |
Las tres escrituras ocupan o liberan la hora de una persona del equipo de UTILIA, por eso exigen confirm: true. Ninguna exige permiso, igual que en la aplicación.
Reservar una videollamada por MCP
list_sales_call_slots
Consulta las horas libres
Cada hora llega en ISO 8601 con desfase horario: usa una de ellas como start.book_sales_call
Reserva con confirm: true
El servidor vuelve a comprobar la hora contra la agenda al reservar.Si no: llega SALES_CALL_UNAVAILABLE; repite con mode CALLBACK y tu teléfono.
Respuesta
Recibes la cita
Con el enlace para cambiarla o cancelarla.Correo
Te llega el enlace de entrada
Cuando la sala está lista, no en la respuesta de la reserva.
El modo CALLBACK, con el teléfono en phone, solo existe al reservar, no al cambiar la hora, y no puedes tener dos citas vivas a la vez.
Cómo se conceden los scopes
| Scope | Lo incluyen | No lo incluyen |
|---|---|---|
org:plan:view | Los conjuntos :read y :full de todas las áreas | — |
org:plan:request | Los conjuntos :write y :full | Los :read, porque pedir es escribir |
org:plan:manage_requests | Solo los conjuntos :full | Los demás, porque cerrar la petición de un compañero es actuar sobre otra persona |
Estos tres scopes viajan con el token de cualquier servidor y, a diferencia de los de avisos, bastan por sí solos para entrar en él: un token que solo lleve org:plan:view puede consultar el plan desde cualquier servidor, aunque no vea ninguna otra herramienta.
Lo que no está por MCP ni en los SDK
Estas acciones son de una persona con sesión iniciada: no están en la API externa con clave ni en los SDK, porque una clave de API no tiene a quién pedirle una ampliación ni puede asistir a una videollamada.
Las peticiones de plan generan avisos de la categoría planRequests («Peticiones de plan»), que puede ver cualquier persona y que se consultan y ajustan con la herramienta notifications.
Siguiente paso
Si get muestra con candado lo que necesitas, pide la ampliación con request_upgrade y, si quieres resolver dudas antes de decidir, reserva la llamada con book_sales_call. Quien administra la cuenta ve las peticiones en «Peticiones de tu equipo», en Ajustes › Mi plan, necesitas entrar con tu cuenta. El catálogo completo de scopes está en Scopes y recursos de OAuth.
Ponlo en práctica
Lo encontrarás en Mi plan. Para abrirlo, entra con tu cuenta de UTILIA OS.