Claude.ai + Scrapeless: Adicione um Conector MCP Personalizado

TL;DR:

• Scrapeless se conecta ao claude.ai como um conector personalizado. Adicione https://api.scrapeless.com/mcp na caixa de diálogo Adicionar conector personalizado e passe sua chave de API como um cabeçalho de solicitação.
• Mude a autenticação para Sem login. Claude pré-seleciona a opção que detecta, e para Scrapeless essa foi Fazer login agora, um login OAuth que o servidor não oferece.
• Adicione um cabeçalho de solicitação: x-api-token, com a chave básica como valor. Claude envia o valor exatamente como você o digita, então nada vai à frente da chave.
• Os cabeçalhos de solicitação estão em beta. A Anthropic os oferece para um conjunto limitado de organizações, e nos planos Team e Enterprise, um Proprietário adiciona o conector.
• Um conector que lista 25 ferramentas ainda não provou a chave. Scrapeless lista suas ferramentas para qualquer valor de chave, então confirme com uma chamada de ferramenta em um chat.
• Obtenha uma chave no plano gratuito do Scrapeless e conecte-a em alguns minutos.

Claude na web tem sua própria busca na web. O servidor MCP do Scrapeless adiciona um acesso diferenciado: páginas renderizadas em um navegador real e retornadas como Markdown, um navegador na nuvem que Claude pode controlar clique a clique, rastreamentos em segundo plano e dados de resultados do Google. Uma vez conectado, Claude chama essas ferramentas no meio de uma conversa.

Este guia adiciona o servidor hospedado através da caixa de diálogo Adicionar conector personalizado do claude.ai. A caixa de diálogo é um único formulário, e duas de suas configurações precisam de atenção para Scrapeless: a opção de login que Claude detecta e o cabeçalho que carrega a chave.

Como um Conector Personalizado Atinge o Scrapeless

Um conector personalizado é um servidor MCP remoto que Claude chama da nuvem da Anthropic em vez de do seu computador. O guia da Anthropic para conectores personalizados diz que isso se aplica a todos os clientes Claude, incluindo o claude.ai, então o servidor precisa ser acessível pela internet pública. Scrapeless opera em um ponto de extremidade HTTPS público, então não há nada para hospedar e nada para adicionar à lista de permissões.

A autenticação decide o resto da configuração. Muitos conectores fazem o login de cada pessoa através do OAuth. Scrapeless não tem fluxo OAuth e lê uma chave de API do cabeçalho x-api-token em cada solicitação. A documentação do Claude para conectores MCP remotos cobre esse caso com cabeçalhos de solicitação: uma credencial fixa inserida uma vez quando o conector é adicionado e enviada em cada solicitação.

O Que o Scrapeless Adiciona ao Claude

O servidor expõe 25 ferramentas, agrupadas por trabalho:

• scrape_markdown, scrape_html e scrape_screenshot retornam uma página renderizada como Markdown, HTML bruto ou uma imagem em uma chamada.
• Dezesseis ferramentas browser_*, de browser_create e browser_goto a browser_click, browser_type e browser_snapshot, controlam uma sessão de navegador na nuvem passo a passo.
• crawl_start, crawl_result e crawl_cancel executam um rastreamento em segundo plano e coletam depois.
• google_search e google_trends retornam resultados de busca e dados de tendências, e ai_scraper captura respostas de assistentes de IA como ChatGPT, Gemini e Perplexity.

Nas configurações do conector, Claude os lista sob nomes legíveis como "Raspador de IA" e "Clique de Navegador", cada um com sua própria permissão.

Pré-requisitos

• Um plano Claude com conectores personalizados. A Anthropic lista Gratuito, Pro, Max, Team e Enterprise, e limita o Gratuito a um conector personalizado.
• A seção Cabeçalhos de solicitação na caixa de diálogo Adicionar conector personalizado. A autenticação por cabeçalhos de solicitação está em beta para um conjunto limitado de organizações; se a seção estiver ausente, sua organização ainda não tem acesso.
• Em planos Team e Enterprise, um Proprietário ou Proprietário Primário para adicionar o conector.
• Uma chave de API Scrapeless do painel do Scrapeless.

Passo 1: Abrir Adicionar Conector Personalizado

Onde a caixa de diálogo se abre depende do plano:

Preencha o primeiro passo:

Mantenha a chave fora da URL. Scrapeless lê-a apenas do cabeçalho x-api-token, e o guia de autenticação da Anthropic para conectores aconselha contra credenciais em URLs de conectores, porque URLs são registradas em logs de servidor, proxies e histórico de navegação.
Configurando isso agora? O plano gratuito da Scrapeless cobre a conexão e suas primeiras chamadas de ferramenta.

Passo 2: Altere a Opção Detectada para Sem Login

Depois de continuar, Claude verifica a URL e pré-seleciona a autenticação que detecta, marcada como Detectada. Para https://api.scrapeless.com/mcp, a opção detectada foi Entrar agora. Escolha Sem login em vez disso.

As duas opções de login executam um fluxo OAuth, e a Scrapeless não oferece uma. Sua resposta 401 não contém o cabeçalho WWW-Authenticate, e seus caminhos de descoberta OAuth retornam 404. Sem login é a opção que a documentação da Anthropic denomina para servidores que usam uma chave de API, emparelhada com a chave em Cabeçalhos de solicitação. Uma vez selecionada, os campos do cliente OAuth desaparecem do diálogo.

Passo 3: Adicione o Cabeçalho x-api-token

Abra Cabeçalhos de solicitação e adicione uma linha:

Então clique em Adicionar.

Escolha o nome da lista ou escolha Cabeçalho personalizado e digite-o. A Anthropic aprova cada nome de cabeçalho personalizado antes de Claude enviá-lo a um servidor de terceiros, e o diálogo rejeita um nome que não seja aprovado. x-api-token salvo sem erro quando essa configuração foi testada.

O valor não precisa de prefixo. Claude o envia exatamente como digitado e não adiciona nenhum esquema de autenticação, que é o que a Scrapeless espera: o servidor lê o valor inteiro do cabeçalho como a chave. Um valor como Bearer <key> ou token <key> ainda passa pela negociação e pela lista de ferramentas, depois falha em cada chamada de ferramenta.

Exigido faz com que um valor ausente falhe a conexão em vez de enviar solicitações sem o cabeçalho. Claude armazena o valor de forma segura e não o mostra novamente. As configurações de autenticação não podem ser editadas mais tarde, então uma chave ou nome de cabeçalho errado significa remover o conector e adicioná-lo novamente.

Passo 4: Verifique as Ferramentas e Suas Permissões

Abra Personalizar > Conectores e selecione Scrapeless. A página do conector lista todas as 25 ferramentas sob Permissões de ferramenta, e cada ferramenta pode ser configurada como Sempre permitir, Necessita de aprovação ou Bloqueado. Nos testes, cada ferramenta Scrapeless começou como Necessita de aprovação, então Claude pergunta antes de cada chamada.

Bloqueie o que um trabalho não precisa. Um chat que apenas lê páginas pode manter scrape_markdown e google_search disponíveis e bloquear as ferramentas browser_*, que conduzem uma sessão de navegador ao vivo. O artigo da Anthropic sobre o uso de conectores descreve os mesmos três níveis de permissão para cada conector.

Passo 5: Execute Uma Chamada de Ferramenta em um Chat

Os conectores são ativados por conversa. Em um novo chat, clique em +, abra Conectores e ative a Scrapeless. Então peça um pequeno trabalho verificável:

Use the Scrapeless scrape_markdown tool to fetch https://example.com

Permita a chamada se Claude pedir aprovação. Claude mostra um passo Raspar markdown para https://example.com, depois retorna a página como Markdown, começando com:

# Example Domain

This domain is for use in documentation examples without needing permission. Avoid use in operations.

Essa chamada é o teste que conta. A Scrapeless responde ao handshake MCP e lista suas 25 ferramentas para qualquer valor de chave, então um conector conectado com uma lista completa de ferramentas mostra apenas que o cabeçalho chegou. Com uma chave errada, o resultado da ferramenta começa com Failed to fetch data.

Corrija os Problemas Comuns

Uma Chave para Toda a Organização

Um cabeçalho de solicitação é uma credencial armazenada no conector. A documentação da Claude descreve cabeçalhos de solicitação como adequados para serviços onde todos em uma organização compartilham uma credencial, e nos planos Team e Enterprise o Proprietário a insere uma vez para cada membro. Todas as chamadas Scrapeless dos membros então rodam nessa única chave e seu plano.
Use uma chave criada exclusivamente para Claude, para que possa ser rotacionada sem afetar outras integrações. Rotacioná-la significa remover o conector e adicioná-lo novamente com a nova chave, e os membros se reconectam em seguida. Defina as permissões da ferramenta tendo toda a equipe em mente.

Para mais informações sobre o que o servidor expõe, leia o anúncio do servidor Scrapeless MCP. A documentação do Browser MCP contém a referência de configuração, a página da API de Scraping aborda os atores por trás das ferramentas, e a precificação lista o custo de uma chamada.

Conclusão

Scrapeless entra no claude.ai como um conector personalizado com três configurações que importam: a URL https://api.scrapeless.com/mcp, Sem login em vez da opção de login detectada, e um cabeçalho de requisição x-api-token que contém a chave básica. Ative o conector em um chat, e Claude pode chamar todas as 25 ferramentas.

Leia a lista de ferramentas como um sinal de que o cabeçalho chegou, não de que a chave funciona. Uma chamada scrape_markdown que retorna uma página real valida a chave, e as permissões da ferramenta decidem quanto Claude pode fazer sem perguntar.

Pronto para dar a Claude um navegador na nuvem e conteúdo de página limpo? Comece com o plano gratuito do Scrapeless e adicione o conector.

FAQ

P: Posso adicionar um conector personalizado com uma chave API no claude.ai?

Sim, onde a beta de cabeçalhos de requisição está disponível. Escolha Sem login na caixa de diálogo Adicionar conector personalizado e adicione a chave em Cabeçalhos de requisição. Claude armazena o valor e o envia em cada requisição ao servidor.

P: Qual opção de autenticação devo escolher para o Scrapeless no claude.ai?

Sem login. Claude pode marcar Conecte-se agora como Detectado, mas o Scrapeless não tem login OAuth e autentica com o cabeçalho x-api-token em vez disso.

P: Que cabeçalho o Scrapeless precisa no Claude?

x-api-token, com a chave API como o valor inteiro. Claude não adiciona prefixo, então insira apenas a chave.

P: Por que não vejo cabeçalhos de requisição na caixa de diálogo Adicionar conector personalizado?

A autenticação de cabeçalho de requisição está em beta e disponível para um conjunto limitado de organizações. Sem essa seção, um servidor de chave API como o Scrapeless não pode ser adicionado através da caixa de diálogo ainda.

P: Posso mudar a chave do Scrapeless após adicionar o conector?

Não no local. Configurações de autenticação, incluindo cabeçalhos de requisição, não podem ser alteradas após um conector ser adicionado. Remova o conector e adicione-o novamente com a nova chave; os membros reconectam depois.

P: Por que o conector mostra 25 ferramentas quando minha chave está errada?

O Scrapeless lista suas ferramentas para qualquer valor de chave. A chave é verificada quando uma ferramenta é executada, e uma chave errada retorna texto começando com Failed to fetch data.

P: Posso colocar a chave API do Scrapeless na URL do conector?

Não. O Scrapeless aceita a chave apenas no cabeçalho x-api-token, e a Anthropic aconselha contra credenciais em URLs de conectores.

P: Quantas ferramentas o Scrapeless adiciona ao Claude?

25: três ferramentas scrape_*, dezesseis ferramentas browser_*, três ferramentas crawl_*, além de google_search, google_trends e ai_scraper.