Como fazer login

O servidor precisa saber em qual conta cada busca deve ser debitada. Há duas maneiras de informar isso, e as duas resultam no mesmo tipo de token.

Login via OAuth

Para o Claude, o ChatGPT e outros assistentes que oferecem essa opção. Nada para copiar:

1. Adicione a URL do servidor https://api.publicwww.com/mcp e escolha OAuth se o assistente perguntar como autenticar.
2. Deixe o client ID e o client secret do OAuth em branco, se o formulário tiver esses campos: o PublicWWW não registra clientes, ele reconhece cada assistente por um documento que o próprio assistente publica no seu site.
3. O assistente abre o PublicWWW. Entre com o código de uso único que enviamos por e-mail, se ainda não estiver logado.
4. Você vê qual aplicativo está pedindo acesso, o site que responde por ele e para onde você vai voltar. Clique em Permitir.

A conexão passa a aparecer na sua página de perfil, na aba API / MCP, em Apps conectados.

Ou use um token

Para editores de código, agentes de linha de comando e seus próprios scripts. Gere um token na sua página de perfil e configure o cliente com este cabeçalho:

Authorization: Bearer <token>

É o mesmo token que a API usa, e podem existir até dez ao mesmo tempo, então dê a cada cliente o seu próprio token: se um vazar, exclua só ele. Mantenha os tokens fora dos arquivos que você versiona: a maioria dos clientes consegue ler o token de uma variável de ambiente ou pedi-lo uma única vez; as páginas dos clientes mostram como.

Um cliente que oferece OAuth ainda pode falhar no login aqui: alguns se registram antes em cada servidor, ou esperam voltar para um endereço com esquema próprio, como myapp://. Nenhum dos dois casos é suportado. Com esses clientes, use um token.

Quanto tempo o acesso dura

Até você revogá-lo. Tokens e apps conectados não expiram, então um assistente que funciona hoje continua funcionando amanhã sem precisar fazer login de novo. Para cortar o acesso, na sua página de perfil:

• Desconecte um app em Apps conectados: ele perde o acesso na hora e precisa pedir de novo;
• Exclua um token: o que o utiliza para de funcionar na hora.

Remover o PublicWWW no próprio assistente nem sempre nos avisa; se quiser ter certeza de que o acesso foi cortado, desconecte-o aqui também.

O que o assistente recebe

A busca e o resumo da conta: as duas ferramentas. As duas apenas leem: nada na sua conta pode ser alterado por meio delas. As buscas do assistente contam na cota diária de buscas do seu plano, exatamente como se você mesmo as fizesse.

Está criando um aplicativo que faz login de usuários? O fluxo OAuth, o documento de metadados do cliente e os endpoints estão em OAuth 2.1 para aplicativos.