> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Potencia el Agent de tu producto

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

> [tab] MCP
>
> Para frameworks de Agent compatibles con MCP remoto.
>
> Tu producto
>
> Agent
> →
> cliente MCP
>
> →
> **Glasser**herramientas MCP
>
> **1. Configura la conexión**
>
> Añade este servidor a tu cliente MCP mediante **HTTP transmisible**:
>
> ```text wrap theme={null}
> https://api.glasser.ai/mcp
> ```
>
> **Cuenta de tu producto:** crea una [Key](https://app.glasser.ai/keys)
> 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](https://glasser.ai/docs/es/mcp-server/other.md) 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](https://glasser.ai/docs/es/mcp-server.md#tools).
>
> **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.

> [tab] CLI
>
> Para Agents que pueden ejecutar comandos de shell.
>
> Tu entorno de ejecución
>
> Agent
> →
> **Glasser CLI**mediante shell
>
> →
> **Glasser**API HTTP
>
> **1. Instala la CLI**
>
> Instálala en el entorno de ejecución de tu Agent. Requiere Node.js 22 o posterior.
>
> ```bash wrap theme={null}
> npm install -g @glasser-ai/cli
> ```
>
> **2. Conecta una cuenta**
>
> Configura `GLASSER_API_KEY` mediante el almacén de secretos de tu entorno de ejecución.
>
> **Cuenta de tu producto:** usa una [Key](https://app.glasser.ai/keys) de
> tu Workspace.\\
>
> **Cuenta de tu usuario:** carga la Key de ese usuario en su entorno de ejecución aislado.
>
> **3. Comprueba la conexión**
>
> Proporciona al Agent una herramienta de shell y ejecuta esta comprobación gratuita:
>
> ```bash wrap theme={null}
> glasser balance --json
> ```
>
> Usa `--json` para obtener resultados legibles por máquinas.
>
> **Referencia:** [Configuración de la CLI](https://glasser.ai/docs/es/cli.md) · [Search](https://glasser.ai/docs/es/cli/search.md) ·
> [Inspect](https://glasser.ai/docs/es/cli/inspect.md) · [Run](https://glasser.ai/docs/es/cli/run.md)

> [tab] Herramientas personalizadas · API
>
> Para productos con sus propias herramientas o proveedores de datos existentes.
>
> Tu backend
>
> Agent
> →
> Tus herramientas
>
> →
> **Glasser**API HTTP
>
> →
> **proveedores de datos**Tus API existentes
>
> **1. Conecta tu backend**
>
> **URL base:** `https://api.glasser.ai`\\
>
> **Encabezado:** `Authorization: Bearer <your Key>`
>
> **Cuenta de tu producto:** usa la [Key](https://app.glasser.ai/keys) de tu Workspace.\\
>
> **Cuenta de tu usuario:** selecciona la Key de ese usuario para cada solicitud.
>
> **2. Define las herramientas de tu agente**
>
> Integra las [solicitudes a la API de Glasser](https://glasser.ai/docs/es/api-reference/overview.md#search-inspect-run)
> en una herramienta como `get_instagram_posts(username)` y regístrala con
> tu Agent. Tu backend controla la selección del proveedor de datos y el formato de salida.
>
> **3. Comprueba la conexión**
>
> Envía una solicitud autenticada [GET /v1/balance](https://glasser.ai/docs/es/api-reference/balance/get.md).
> Esta comprobación es gratuita.
>
> **Referencia:** [Autenticación de la API](https://glasser.ai/docs/es/api-reference/overview.md#authenticate) ·
> [Flujo de trabajo de la API](https://glasser.ai/docs/es/api-reference/overview.md#search-inspect-run)

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](https://glasser.ai/docs/es/integrations/overview.md#example-check-an-instagram-creator)
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

> [accordion] Instrucciones para Skill y el agente
>
> Explica cuándo usar Glasser y qué herramientas llamar. Para Agents basados en la CLI,
> empieza con [Glasser Skill](https://glasser.ai/SKILL.md). 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](https://glasser.ai/docs/es/cli/login.md)
> puede almacenar una Key mediante el inicio de sesión en el navegador.

> [accordion] Reintentos y Runs sin terminar
>
> 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](https://glasser.ai/docs/es/api-reference/runs/get.md). 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.

> [accordion] Acceso, gasto y seguimiento del uso
>
> * 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.