Pular para o conteúdo principal
O MCP permite que sua ferramenta de IA use o Glasser diretamente. Conecte sua conta para pesquisar dados, consultar preços e recuperar resultados em suas conversas. Não é necessário instalar a CLI do Glasser.

Escolha sua ferramenta de IA

Claude Code

Adicione o Glasser pelo terminal e entre pelo Claude Code.

Codex

Conecte clientes Codex locais com uma configuração MCP compartilhada.

Claude.ai

Conecte o Claude na Web ou no desktop, incluindo o Cowork.

ChatGPT

Conecte o Glasser como um plugin e use dados pagos no ChatGPT.

Manus

Conecte o Glasser e use dados pagos em suas pesquisas e relatórios.

Cursor

Adicione o Glasser ao Cursor e ative-o para seu agente.

OpenCode

Adicione o Glasser à sua configuração do OpenCode e entre pelo terminal.

VS Code

Adicione o Glasser ao GitHub Copilot Chat no VS Code.

Outros clientes

Conecte-se pela URL do servidor ou use uma Glasser Key existente.

Já conhece a configuração do seu cliente?

Use esta URL do servidor e escolha o login com OAuth:
Entre no Glasser, escolha o Workspace cujo saldo o cliente pode usar e selecione Permitir. Você pode criar uma conta e um Workspace durante o login. Se o cliente não puder usar OAuth, siga Outros clientes para se conectar com uma Key.

Verifique a conexão

Pergunte à sua ferramenta de IA:
Uma resposta de saldo confirma que a conexão funciona, mesmo que o saldo disponível seja zero. A verificação é gratuita. Se o saldo disponível não cobrir a tarefa, adicione fundos no console do Glasser.

Primeira tarefa e recompensas

Após a configuração, seu agente recomenda uma tarefa pequena e aguarda sua escolha. Em seguida, ele segue as regras de preço e aprovação da ferramenta antes de um Run pago. Se você já solicitou uma tarefa, ele dá continuidade a essa tarefa. Uma resposta de saldo pode incluir first_run_reward com amount_usd, expires_at e um description gerado pelo servidor para o estado atual da sua recompensa. O agente retransmite essa mensagem no seu idioma junto com a sugestão de tarefa. Se o campo estiver ausente, ele não menciona recompensas. Ele usa a resposta de saldo da configuração em vez de fazer chamadas adicionais apenas para consultar recompensas.

Gerencie o acesso

O login pelo navegador cria uma Key chamada MCP · <client> no seu Workspace. Para remover o acesso do cliente, revogue essa Key na página de Keys. Desconectar ou remover o Glasser apenas no cliente não revoga a Key.

Endpoint

Use Streamable HTTP. Autentique-se pelo login no navegador ou envie uma Glasser Key no cabeçalho Authorization: Bearer.
O servidor não mantém estado e retorna respostas JSON. Cada solicitação inclui uma Key ou um token de acesso OAuth que resolve para uma Workspace Key.Clientes OAuth descobrem o servidor de autorização a partir de resource_metadata no cabeçalho WWW-Authenticate de uma resposta 401. Eles precisam apenas da URL do servidor para iniciar esse fluxo.

Ferramentas

O Glasser expõe sete ferramentas. O Agent usa search para descobrir Endpoints e, em seguida, inspect e run para recuperar dados. Cada Endpoint não exige uma ferramenta MCP separada.

Regras para manter os gastos seguros

O servidor fornece estas instruções ao Agent, assim como a Skill faz para agentes da CLI:
  • Use primeiro as conexões existentes. Use o Glasser quando suas próprias Keys e integrações não atenderem à solicitação.
  • Verifique antes de gastar. Inspecione o Price, comece com solicitações pequenas e obtenha aprovação antes de Runs especulativos, repetidos ou em massa.
  • Repita com a mesma Key. Mantenha o idempotency_key e os parâmetros de execução para recuperar o Run original sem uma segunda cobrança.
  • Leia o status e a cobrança separadamente. Verifique provider_response e charge_usd, mesmo em um Run COMPLETED.
Um Run MCP reproduzido inclui replayed: true. Os valores em charge_usd são strings decimais exatas em USD. Um erro 404 do provedor de dados pode ser um Run COMPLETED cobrado de acordo com a regra NO_RESULT do Endpoint.Erros do provedor de dados permanecem em provider_response.http_status e provider_response.error do Run. Verifique esses campos mesmo quando o resultado da ferramenta não tiver a flag isError. Use runs_get para obter o corpo completo do erro; runs_list retorna resumos.Recusas acionáveis, como insufficient_balance, rate_limited e restrições de Policy, retornam resultados da ferramenta com isError. Elas não são erros de protocolo. Para limites de taxa, leia retry_after_ms antes de tentar novamente.

Quando preferir a CLI

Para agentes locais como Claude Code, Codex e Cursor, a Skill junto com a CLI é o caminho recomendado. A Skill orienta a configuração e contém as regras operacionais. Para Claude Chat e Cowork, siga o guia do conector.