> ## 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. # Configure com MCP > Conecte o Glasser à sua ferramenta de IA e entre com sua conta. 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 > [card] [Claude Code](https://glasser.ai/docs/pt/mcp-server/claude-code.md) > > Adicione o Glasser pelo terminal e entre pelo Claude Code. > [card] [Codex](https://glasser.ai/docs/pt/mcp-server/codex.md) > > Conecte clientes Codex locais com uma configuração MCP compartilhada. > [card] [Claude.ai](https://glasser.ai/docs/pt/mcp-server/claude.md) > > Conecte o Claude na Web ou no desktop, incluindo o Cowork. > [card] [ChatGPT](https://glasser.ai/docs/pt/mcp-server/chatgpt.md) > > Conecte o Glasser como um plugin e use dados pagos no ChatGPT. > [card] [Manus](https://glasser.ai/docs/pt/mcp-server/manus.md) > > Conecte o Glasser e use dados pagos em suas pesquisas e relatórios. > [card] [Cursor](https://glasser.ai/docs/pt/mcp-server/cursor.md) > > Adicione o Glasser ao Cursor e ative-o para seu agente. > [card] [OpenCode](https://glasser.ai/docs/pt/mcp-server/opencode.md) > > Adicione o Glasser à sua configuração do OpenCode e entre pelo terminal. > [card] [VS Code](https://glasser.ai/docs/pt/mcp-server/vscode.md) > > Adicione o Glasser ao GitHub Copilot Chat no VS Code. > [card] [Outros clientes](https://glasser.ai/docs/pt/mcp-server/other.md) > > 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: ```text theme={null} https://api.glasser.ai/mcp ``` 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](https://glasser.ai/docs/pt/mcp-server/other.md) para se conectar com uma Key. ## Verifique a conexão Pergunte à sua ferramenta de IA: ```text wrap theme={null} Suggest one small task I can try with Glasser. Check my available balance and mention any first-run reward returned. Explain what the task will do, then wait for me to choose it before a paid Run. ``` 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](https://app.glasser.ai). ## 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 · ` no seu Workspace. Para remover o acesso do cliente, revogue essa Key na [página de Keys](https://app.glasser.ai/keys). Desconectar ou remover o Glasser apenas no cliente não revoga a Key. ## Endpoint ``` POST https://api.glasser.ai/mcp ``` Use **Streamable HTTP**. Autentique-se pelo login no navegador ou envie uma Glasser Key no cabeçalho `Authorization: Bearer`. > [accordion] Detalhes de transporte e autenticação > > 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. | Ferramenta | Finalidade | | - | - | | `search` | Encontra os Endpoints que sua Key pode executar. | | `inspect` | Obtém o esquema de entrada, o Price atual, a versão e o modo de execução de um Endpoint. | | `run` | Executa um Endpoint. Requer um `idempotency_key`. | | `runs_get` | Lê o status, a resposta do provedor de dados e a cobrança de um Run. | | `runs_list` | Consulta Runs, do mais recente ao mais antigo, com paginação. | | `runs_stop` | Solicita uma interrupção. Verifique o status retornado para saber se ele foi interrompido. | | `balance` | Consulta os fundos disponíveis e confirma a conexão. | ## Regras para manter os gastos seguros O servidor fornece estas instruções ao Agent, assim como a [Skill](https://glasser.ai/docs/pt/setup-skill.md) 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`. > [accordion] Repetições e respostas de erro > > 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](https://glasser.ai/docs/pt/setup-skill.md) junto com a [CLI](https://glasser.ai/docs/pt/cli.md) é 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](https://glasser.ai/docs/pt/mcp-server/claude.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.