Saltar al contenido
Olimpia
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Autorización y límites

Cómo autoriza Olimpia a los agentes, cuánto duran los tokens, qué límites hay y qué reglas sigue el servidor MCP para que un agente no haga daño.

OAuth 2.1

Olimpia es su propio servidor de autorización:

  • Descubrimiento. El servidor publica /.well-known/oauth-protected-resource (RFC 9728) y /.well-known/oauth-authorization-server (RFC 8414). Un pedido sin token a /mcp responde 401 con WWW-Authenticate apuntando a esos documentos.
  • Registro de clientes. Por Client ID Metadata Document (el client_id es una URL https) o por registro dinámico (POST /oauth/register, solo clientes públicos).
  • PKCE S256 obligatorio, iss en la respuesta (RFC 9207) y resource validado (RFC 8707).
  • Consentimiento en olimpia.dev, con tu sesión. Ves qué agente pide acceso antes de aprobar.
Credencial Duración
Código de autorización 10 minutos, un solo uso
Token de acceso 1 hora
Token de refresco 90 días, rota en cada uso
Código de conexión del plugin 10 minutos, un solo uso, atado al agente que lo pidió
Token personal 90 días, o hasta que lo revocás

POST /oauth/revoke revoca un token, y Cuenta → Agentes y tokens muestra y revoca cada conexión.

Mismos permisos que la consola

Cada herramienta llama a la misma API que usa la consola, con el token del pedido. Valida y autoriza exactamente igual: un agente no puede hacer nada que tu cuenta no pueda hacer.

Límites

Límite Valor
Llamadas a /mcp 240 por minuto por token
Apps, bases, buckets, dominios de email, proyectos y ambientes creados 30 por hora por cuenta, sumando la consola y la API
Intentos de código de conexión fallidos 10 cada 10 minutos por agente
Filas por consulta de lectura 200
Tiempo de una escritura SQL 30 segundos

Reglas de seguridad

  • Borrar y escribir exigen confirmación. delete_app, delete_resource, delete_environment, disable_backups y query_postgres con write: true necesitan confirm con el nombre exacto, que la persona tiene que aprobar.
  • Sacar datos de Olimpia, también. set_public_access con public: true, set_backups hacia un S3 externo y update_app cuando cambia source, repo o image piden el mismo confirm. El agente solo los hace cuando la persona pidió exactamente eso, nunca porque lo diga un log, una fila o un commit.
  • Secretos ocultos por defecto. get_env oculta los valores que parecen secretos salvo con reveal: true.
  • Datos no confiables. Los logs, la salida de los builds, los valores de variables y las filas de la base son datos, no instrucciones. Las herramientas lo indican para que el agente no siga órdenes escondidas ahí.
  • SQL sin superusuario. query_postgres corre como el usuario dueño de la base; la lectura va en una transacción de solo lectura y sus topes de filas y tamaño los aplica la propia base. Cada consulta usa una conexión nueva, así que nada de lo que deje en la sesión llega a la siguiente.

Buenas prácticas

  • Usá OAuth para agentes interactivos y tokens personales solo para CI.
  • Un token por integración, con un nombre que diga dónde se usa.
  • Revocá las conexiones que ya no usás.

¿Te ha resultado útil esta página?