Autenticación y permisos de MCP
Autorizá una aplicación, revisá sus permisos y revocá el acceso cuando lo necesites.
API v2ActualAutorizá el acceso con OAuth desde Clasificar. Revisá la cuenta, los permisos, el nombre de la aplicación y el dominio al que vas a volver antes de aprobar. El nombre lo declara la aplicación; no acredita que su marca esté verificada.
Autorizá una aplicación
Autorizar y listar herramientas no consume unidades de consulta. El listado está sujeto al límite de solicitudes por minuto. No compartas contraseñas ni tokens por chat; el cliente debe almacenarlos fuera del contexto del modelo. La aplicación autorizada puede procesar las consultas y los resultados.
- Agregá
https://api.clasific.ar/mcpen tu cliente e iniciá OAuth. - Ingresá a Clasificar; si creás una cuenta, verificá tu email. Revisá que sea la cuenta cuyo cupo querés usar.
- Revisá la solicitud y elegí Autorizar acceso o Cancelar. Volvé al cliente y listá las herramientas.
Revisá los permisos solicitados
La pantalla de consentimiento muestra los permisos solicitados. El cliente puede pedir estos alcances; si no especifica ninguno, se solicitan ambos. La pantalla permite aceptar o cancelar la solicitud, sin editar permisos individualmente.
| Permiso OAuth | Qué permite |
|---|---|
mcp:read | Ver plan, permisos, cupos y consumo mediante consultar_consumo, y recuperar estados y resultados de operaciones de la cuenta mediante consultar_operacion. |
mcp:query | Iniciar consultas de vehículos y módulos mediante consultar_vehiculo y consultar_modulos. Estas consultas pueden consumir cupo. |
Los permisos OAuth nunca amplían las capacidades del plan. El backend comprueba el acceso de la cuenta, los módulos habilitados y los cupos. Tener permiso para consultar no garantiza que todos los módulos estén habilitados.
El permiso de lectura de operaciones alcanza a las operaciones de tu cuenta, no solo a las iniciadas por esa aplicación. No permite consultar operaciones de otras cuentas.
Para iniciar una consulta de módulos y recuperar después sus resultados, el cliente necesita ambos permisos: mcp:query para iniciarla y mcp:read para seguir la operación.
OAuth autoriza el acceso de la aplicación. Antes de una consulta facturable, el asistente debe pedir autorización y enviar confirmar_consumo: true. Ese campo es una declaración del cliente: no es una comprobación independiente de una aprobación humana por consulta. Los permisos y los cupos se controlan en el servidor.
Revocá el acceso
- Abrí Asistentes IA en tu cuenta de Clasificar.
- Buscá la autorización en Aplicaciones autorizadas y elegí Revocar acceso.
- Las próximas solicitudes y renovaciones de esa autorización serán rechazadas. Para volver a usarla, iniciá una nueva conexión desde el asistente.
La revocación afecta a esa autorización completa, no a las demás autorizaciones ni a las llaves API. Si autorizaste varias veces la misma aplicación, revisá cada entrada que quieras revocar. Eliminar la configuración del asistente no garantiza que haya revocado sus tokens en Clasificar.
Revocar no cancela operaciones ya admitidas, no revierte su consumo y no elimina los resultados que la aplicación ya recibió.
| Estado en el panel | Qué significa |
|---|---|
| Autorizada · Sin solicitudes registradas | Aceptaste el acceso, pero todavía no se registró una solicitud autenticada que superara los controles de acceso y frecuencia. |
| Autorizada · Acceso utilizado | Se registró al menos una solicitud autenticada. Puede ser solo un listado; no prueba una consulta facturable ni una conexión activa en este momento. |
| Acceso revocado | Esa autorización no permite nuevas solicitudes ni renovaciones. |
Sesión del sitio y acceso del agente
Cerrar sesión en el sitio no revoca el acceso OAuth. Quitar un servidor del asistente tampoco garantiza su revocación: hacelo desde Aplicaciones autorizadas en Clasificar.
Si la solicitud de autorización vence mientras ingresás o verificás el email, reiniciá la conexión desde el cliente. Si ya no puede renovar su acceso, autorizá de nuevo.