Pular para o conteúdo principal
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

Para frameworks de Agent compatíveis com MCP remoto.
1

Configure a conexão

Adicione este servidor ao seu cliente MCP usando Streamable HTTP:
Conta do seu produto: crie uma Key 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 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.
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.
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 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

Explique quando usar o Glasser e quais ferramentas chamar. Para Agents baseados em CLI, comece com o Glasser Skill. 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 pode armazenar uma Key por meio do login no navegador.
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. 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.
  • 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.