> ## 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.

# Potencialize o Agent do seu produto

Conecte-se pelo MCP, pela CLI ou pelas suas próprias ferramentas. Seu Agent escolhe os dados;
o Glasser os recupera.

## Escolha um método de integração

> [tab] MCP
>
> Para frameworks de Agent compatíveis com MCP remoto.
>
> Seu produto
>
> Agent
> →
> cliente MCP
>
> →
> **Glasser**ferramentas MCP
>
> **1. Configure a conexão**
>
> Adicione este servidor ao seu cliente MCP usando **Streamable HTTP**:
>
> ```text wrap theme={null}
> https://api.glasser.ai/mcp
> ```
>
> **Conta do seu produto:** crie uma [Key](https://app.glasser.ai/keys)
> e envie `Authorization: Bearer <your Key>`.
>
> **Conta do seu usuário:** conecte a Key dele com o mesmo cabeçalho ou use
> o [login do navegador MCP](https://glasser.ai/docs/pt/mcp-server/other.md) com um cliente compatível com OAuth.
>
> **2. Disponibilize as ferramentas para o seu Agent**
>
> Descubra as ferramentas do Glasser com `tools/list` e registre-as no seu
> Agent. Consulte a [referência de ferramentas](https://glasser.ai/docs/pt/mcp-server.md#tools).
>
> **3. Verifique a conexão**
>
> Chame `balance` sem argumentos. Uma resposta de saldo confirma a
> conexão, mesmo que o saldo seja zero. Essa verificação é gratuita.

> [tab] CLI
>
> Para Agents capazes de executar comandos do shell.
>
> Seu runtime
>
> Agent
> →
> **Glasser CLI**via shell
>
> →
> **Glasser**API HTTP
>
> **1. Instale a CLI**
>
> Instale no runtime do seu Agent. Requer Node.js 22 ou posterior.
>
> ```bash wrap theme={null}
> npm install -g @glasser-ai/cli
> ```
>
> **2. Conecte uma conta**
>
> Defina `GLASSER_API_KEY` por meio do armazenamento de segredos do seu runtime.
>
> **Conta do seu produto:** use uma [Key](https://app.glasser.ai/keys) do
> seu Workspace.\\
>
> **Conta do seu usuário:** carregue a Key desse usuário no runtime isolado dele.
>
> **3. Verifique a conexão**
>
> Dê ao Agent uma ferramenta de shell e execute esta verificação gratuita:
>
> ```bash wrap theme={null}
> glasser balance --json
> ```
>
> Use `--json` para obter resultados legíveis por máquina.
>
> **Referência:** [Configuração da CLI](https://glasser.ai/docs/pt/cli.md) · [Search](https://glasser.ai/docs/pt/cli/search.md) ·
> [Inspect](https://glasser.ai/docs/pt/cli/inspect.md) · [Run](https://glasser.ai/docs/pt/cli/run.md)

> [tab] Ferramentas personalizadas · API
>
> Para produtos com suas próprias ferramentas ou Providers de dados existentes.
>
> Seu backend
>
> Agent
> →
> Suas ferramentas
>
> →
> **Glasser**API HTTP
>
> →
> **Providers**Suas APIs existentes
>
> **1. Conecte seu backend**
>
> **URL base:** `https://api.glasser.ai`\\
>
> **Cabeçalho:** `Authorization: Bearer <your Key>`
>
> **Conta do seu produto:** use a [Key](https://app.glasser.ai/keys) do seu Workspace.\\
>
> **Conta do seu usuário:** selecione a Key desse usuário em cada solicitação.
>
> **2. Defina as ferramentas do seu Agent**
>
> Envolva [solicitações à API do Glasser](https://glasser.ai/docs/pt/api-reference/overview.md#search-inspect-run)
> em uma ferramenta como `get_instagram_posts(username)` e registre-a no seu
> Agent. Seu backend controla a seleção do Provider e o formato da saída.
>
> **3. Verifique a conexão**
>
> Envie uma solicitação autenticada [GET /v1/balance](https://glasser.ai/docs/pt/api-reference/balance/get.md)
> . Essa verificação é gratuita.
>
> **Referência:** [Autenticação da API](https://glasser.ai/docs/pt/api-reference/overview.md#authenticate) ·
> [Fluxo de trabalho da API](https://glasser.ai/docs/pt/api-reference/overview.md#search-inspect-run)

As execuções usam o saldo do Workspace conectado. Mantenha Keys e tokens de acesso fora das
mensagens do modelo e do código do frontend.

## Dê um fluxo de trabalho ao Agent

Use **Search** para encontrar um endpoint → **Inspect** para verificar sua entrada e seu preço → **Run** para obter os dados.

Veja o [exemplo do Instagram](https://glasser.ai/docs/pt/integrations/overview.md#example-check-an-instagram-creator)
para consultar a consulta, o endpoint correspondente e a entrada. Search e Inspect são gratuitos;
seu backend aplica as regras de gastos antes de um Run.

## Detalhes da implementação

> [accordion] Instruções de Skill e do Agent
>
> Explique quando usar o Glasser e quais ferramentas chamar. Para Agents baseados em CLI,
> comece com o [Glasser Skill](https://glasser.ai/SKILL.md). Para ferramentas personalizadas,
> use seus próprios nomes de ferramentas e preferências de Provider.
>
> Search requer a solicitação do usuário como `use_case` (CLI: `--use-case`). Passe
> o `task_id` retornado para pesquisas, inspeções e Runs posteriores da mesma
> tarefa (CLI: `--task`).
>
> Para desenvolvimento local com CLI e um usuário presente, [glasser login](https://glasser.ai/docs/pt/cli/login.md)
> pode armazenar uma Key por meio do login no navegador.

> [accordion] Retentativas e Runs não concluídos
>
> Gere uma chave de idempotência para cada execução pretendida e mantenha-a junto
> da solicitação. Tente novamente a mesma solicitação com a mesma chave:
>
> * MCP: o argumento da ferramenta `idempotency_key`.
> * CLI: `--idempotency-key` (obrigatório com `run --json`).
> * API HTTP: o cabeçalho `Idempotency-Key`.
>
> Para `QUEUED` ou `RUNNING`, leia o Run existente até que ele atinja um estado
> terminal: MCP `runs_get`, CLI `glasser runs get -r <runId> --wait` ou
> [HTTP Get Run](https://glasser.ai/docs/pt/api-reference/runs/get.md). Retome o Agent com o resultado.
>
> Verifique `status` e `provider_response` do Run antes de usar `output`.
> `COMPLETED` pode incluir um erro de Provider; um Run com falha ainda pode gerar uma cobrança.

> [accordion] Acesso, gastos e acompanhamento do uso
>
> * Para contas conectadas por usuários, mantenha as credenciais separadas e selecione-as
>   na conexão do usuário conectado, não nos argumentos do modelo.
> * Use a Policy da Key para restringir os Endpoints permitidos. Aplique limites de gastos
>   por usuário no seu backend; uma Key compartilhada usa o saldo de um único Workspace.
> * Mantenha o ID do Run e `charge_usd` no registro da tarefa do seu produto.
> * Anexe metadados opcionais do cliente pelo seu backend para fins de acompanhamento, não
>   de controle de acesso. Com MCP, use `_meta["glasser.ai/metadata"]` da solicitação;
>   metadados não são um argumento de ferramenta do modelo.


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