Saltar al contenido principal
Conéctate mediante MCP, la CLI o tus propias herramientas. Tu Agent elige los datos; Glasser los recupera.

​
Elige un método de integración

Para frameworks de Agent compatibles con MCP remoto.
1

Configura la conexión

Añade este servidor a tu cliente MCP mediante HTTP transmisible:
Cuenta de tu producto: crea una Key y envía Authorization: Bearer <your Key>.Cuenta de tu usuario: conecta su Key con el mismo encabezado o usa inicio de sesión de navegador de MCP con un cliente compatible con OAuth.
2

Proporciona las herramientas a tu agente

Descubre las herramientas de Glasser con tools/list y regístralas con tu Agent. Consulta la referencia de herramientas.
3

Comprueba la conexión

Llama a balance sin argumentos. Una respuesta de balance confirma la conexión, aunque el balance sea cero. Esta comprobación es gratuita.
Los Runs utilizan el balance del Workspace conectado. Mantén las Keys y los tokens de acceso fuera de los mensajes del modelo y del código frontend.

​
Proporciona al Agent un flujo de trabajo

Search para encontrar un Endpoint → Inspect sus datos de entrada y Price → Run para obtener datos. Consulta el ejemplo de Instagram para ver la consulta, el Endpoint coincidente y los datos de entrada. Search e Inspect son gratuitos; tu backend aplica las reglas de gasto antes de un Run.

​
Detalles de implementación

Explica cuándo usar Glasser y qué herramientas llamar. Para Agents basados en la CLI, empieza con Glasser Skill. Para herramientas personalizadas, usa tus propios nombres de herramientas y preferencias de proveedores de datos.Search requiere la solicitud del usuario como use_case (CLI: --use-case). Pasa su task_id devuelto a las búsquedas, inspecciones y Runs posteriores de la misma tarea (CLI: --task).Para el desarrollo local con la CLI cuando haya un usuario presente, glasser login puede almacenar una Key mediante el inicio de sesión en el navegador.
Genera una clave de idempotencia para cada ejecución prevista y consérvala con la solicitud. Reintenta la misma solicitud con la misma clave:
  • MCP: el argumento de herramienta idempotency_key.
  • CLI: --idempotency-key (obligatorio con run --json).
  • API HTTP: el encabezado Idempotency-Key.
Para QUEUED o RUNNING, lee el Run existente hasta que alcance un estado terminal: MCP runs_get, CLI glasser runs get -r <runId> --wait o HTTP Get Run. Reanuda el Agent con el resultado.Comprueba tanto status como provider_response del Run antes de usar output. COMPLETED puede incluir un error del proveedor de datos; un Run fallido aún puede generar un cargo.
  • Para cuentas conectadas por usuarios, mantén las credenciales separadas y selecciónalas desde la conexión del usuario que ha iniciado sesión, no desde los argumentos del modelo.
  • Usa la Policy de la Key para restringir los Endpoints permitidos. Aplica límites de gasto por usuario en tu backend; una Key compartida utiliza un único balance de Workspace.
  • Conserva el ID del Run y charge_usd con el registro de tareas de tu producto.
  • Añade metadatos opcionales del cliente desde tu backend para el seguimiento, no para el control de acceso. Con MCP, usa _meta["glasser.ai/metadata"] de la solicitud; los metadatos no son un argumento de herramienta del modelo.