Grok Bot e Scrapeless: Adicionar um Conector MCP Personalizado

TL;DR:

• Scrapeless não está no catálogo de Plugins do Grok Bot, então ele é adicionado como um conector personalizado. Uma pesquisa no Marketplace por ele não retorna nada; um Bot registra um servidor MCP remoto personalizado quando você pede.
• Uma mensagem em inglês faz a configuração. Nomeie o servidor, forneça a URL https://api.scrapeless.com/mcp e diga ao Bot para autenticar com um cabeçalho x-api-token.
• O Grok Bot mostra um cartão de aprovação antes de qualquer coisa ser salva. Verifique o nome, o tipo Remote HTTPS, a URL do servidor e o cabeçalho, então salve.
• O nome do cabeçalho é x-api-token. Um cabeçalho Bearer é rejeitado com 401 Unauthorized: Missing x-api-token header.
• Prove com uma chamada de ferramenta, não com o distintivo de status. Scrapeless responde ao handshake para qualquer valor de chave, e conectores de chave de API podem mostrar um distinto "Precisa de autenticação" enquanto funcionam.
• Obtenha uma chave no plano gratuito do Scrapeless e conecte em poucos minutos.

O Grok Bot dá a cada Bot seu próprio computador em nuvem, um navegador e um conjunto de conectores. O que falta é uma maneira direta de transformar uma página renderizada em Markdown limpo, executar uma busca em segundo plano ou puxar resultados do Google de uma chamada de ferramenta. O servidor Scrapeless MCP adiciona isso como ferramentas que cada Bot em sua conta pode chamar.

A conexão é um servidor MCP remoto personalizado, e no Grok Bot você cria um pedindo a um Bot, em vez de preencher uma página de configurações. Este guia cobre a mensagem a ser enviada, o que verificar no cartão de aprovação e como distinguir um conector funcional de um que parece conectado.

Por que Scrapeless não está no Marketplace de Plugins

O Grok Bot mostra conectores como Plugins, e esse catálogo é do Cursor. o guia do Grok Bot da xAI para equipes diz que não há uma lista separada de conectores do Grok Bot: conectores aparecem como plugins no aplicativo, e o Grok Bot herda a política de conectores do Cursor da equipe. Scrapeless não está publicado nesse catálogo, então a pesquisa no Marketplace por ele retorna vazia.

Qualquer coisa fora do catálogo é adicionada como um conector personalizado, e um Bot faz isso por você. Você fornece a URL HTTPS do servidor remoto e os cabeçalhos necessários; ele registra o servidor com sua ferramenta Adicionar MCP após você confirmar. Um conector personalizado é de toda a conta, então uma vez que um Bot adiciona Scrapeless, os outros Bots na mesma conta também podem usá-lo.

O que Scrapeless adiciona aos seus Bots

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 única chamada.
• Dezesseis ferramentas browser_*, de browser_create e browser_goto a browser_click, browser_type e browser_snapshot, controlam uma sessão de navegador em nuvem passo a passo.
• crawl_start, crawl_result e crawl_cancel executam uma busca 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.

Um Bot já possui um navegador próprio. A diferença é a saída: essas ferramentas devolvem conteúdo de página que o modelo pode ler diretamente, em vez de uma sessão que ele precisa navegar.

Pré-requisitos

• Grok Bot em um plano elegível. xAI lista SuperGrok Plus, SuperGrok Heavy, Cursor Pro+, Cursor Ultra e Cursor Teams Standard ou Premium. Este guia usou o aplicativo de desktop do Grok Bot, versão 0.47.0, no Windows.
• Uma chave de API Scrapeless do painel do Scrapeless.
• Em uma equipe Cursor, uma política de conectores que permita o servidor. Quando a política bloqueia um, os membros veem o plugin como Desativado pelo admin da equipe.

Passo 1: Peça a um Bot para adicionar Scrapeless

Abra qualquer Bot e envie esta mensagem, com sua chave no lugar do espaço reservado:

Add a custom remote MCP server.
Name: scrapeless
URL: https://api.scrapeless.com/mcp
Authentication: HTTP header "x-api-token" with the value YOUR_SCRAPELESS_API_KEY
Do not use an Authorization or Bearer header.

A última linha faz o trabalho real. A maioria dos conectores se autentica com OAuth ou um token Bearer, e um Bot que assume Bearer constrói um cabeçalho que Scrapeless rejeita. O endpoint responde a tal solicitação com 401 Unauthorized: Missing x-api-token header.

Saiba onde a chave termina quando faz parte da mensagem. Ela permanece na conversa desse Bot, e compartilhar um Bot com sua equipe mostra aos colegas seu histórico completo, incluindo conversas passadas. A página de ajuda do Grok Bot sobre segredos recomenda manter as chaves de API fora do chat. Para um Bot compartilhado, envie a mesma mensagem sem o valor e digite a chave no cartão de aprovação no Passo 2 em vez disso; é assim que a chave foi inserida quando esta configuração foi testada.

Configurando isso agora? O plano gratuito do Scrapeless cobre a conexão e suas primeiras chamadas de ferramenta.

Passo 2: Verifique o cartão de aprovação e salve

Antes que o Bot registre qualquer coisa, o Grok Bot mostra um Adicionar Servidor MCP. Compare cada campo com o que você pediu:

Deixe ID do Cliente OAuth e Segredo do Cliente em branco, porque o Scrapeless não usa OAuth. Se o valor do cabeçalho estiver em branco, digite a chave lá, e então escolha Salvar. O cartão também oferece Editar JSON, que contém o mesmo servidor como um objeto JSON indexado pelo seu nome, um servidor por vez.

A chave salva permanece com o conector. A documentação da xAI diz que os tokens OAuth permanecem no backend do conector do Cursor e os Bots invocam ferramentas sem recebê-los. A documentação do Cursor para seus agentes hospedados acrescenta que os valores dos cabeçalhos nos servidores MCP HTTP são criptografados em repouso, redigidos após o salvamento, e nunca são colocados na máquina do agente; as chamadas de ferramenta passam pelo backend do Cursor.

Etapa 3: Executar uma Chamada de Ferramenta

Peça ao Bot por um trabalho pequeno e verificável:

Use the scrapeless MCP server's scrape_markdown tool to fetch https://example.com
and reply with the first heading of the returned page, quoted exactly.

Um conector funcional retorna com o título da página:

"# Example Domain"

Uma chamada de ferramenta é o teste que conta, porque o status do conector não pode distinguir uma boa chave de uma ruim. O Scrapeless responde ao handshake MCP e lista suas 25 ferramentas para qualquer valor de chave. A diferença só se mostra quando uma ferramenta é executada: com uma chave errada, o texto do resultado começa com Failed to fetch data.

O distintivo de status também pode enganar na outra direção. O distintivo de plugin do Grok Bot conta apenas um login OAuth como autenticado, então um conector que usa uma chave API pode mostrar Necessita de autenticação enquanto suas ferramentas funcionam. A equipe do Cursor confirmou que o distintivo Necessita de autenticação é cosmético para conectores como esse. Pressionar Autenticar não muda isso; a chamada de ferramenta acima é a verificação.

Corrija os Problemas Comuns

A última linha vale a pena saber antes que aconteça. O Grok Bot descobre todos os conectores de uma conta sob um orçamento de tempo compartilhado, então um único servidor que nunca responde ao seu handshake pode fazer com que todos os conectores retornem vazios. O Scrapeless respondeu ao seu handshake em menos de meio segundo em testes, então não é o conector que fica em silêncio.

Compartilhe Scrapeless em uma Equipe do Cursor

Pedir a um Bot adiciona o conector para uma conta. Uma equipe que deseja o mesmo conector para todos os membros pode publicá-lo como um plugin em um marketplace de equipe do Cursor, que os planos Teams e Enterprise suportam. Os membros então o encontram no catálogo de Plugins sob plugins da equipe, e ninguém copia uma chave para um chat.

O mcp.json do plugin mantém apenas um espaço reservado:

{
  "mcpServers": {
    "scrapeless": {
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "${SCRAPELESS_API_KEY}"
      }
    }
  }
}

Seu .cursor-plugin/plugin.json declara que espaço reservado como uma variável, então um administrador de equipe define a chave real no painel do Cursor sob Plugins → Configurar:

{
  "name": "scrapeless",
  "variables": {
    "type": "object",
    "properties": {
      "SCRAPELESS_API_KEY": {
        "type": "string",
        "title": "Scrapeless API key",
        "description": "Sent as the x-api-token header to https://api.scrapeless.com/mcp."
      }
    },
    "required": ["SCRAPELESS_API_KEY"]
  }
}

Um plano Teams permite um marketplace de equipe, então uma equipe que já importou um adiciona o plugin Scrapeless a esse repositório em vez de criar um segundo.
Para saber mais sobre o que o servidor expõe, leia o anúncio do servidor Scrapeless MCP. O guia de configuração do Cursor cobre o mesmo servidor no editor do Cursor, a documentação do Browser MCP traz a referência de configuração, a página da API de Scraping cobre os atores por trás das ferramentas, e preços lista o custo de uma chamada.

Conclusão

Adicionar o Scrapeless ao Grok Bot leva uma mensagem e uma aprovação. O Bot registra https://api.scrapeless.com/mcp como um servidor MCP remoto personalizado, o cartão de aprovação confirma o nome, tipo, URL e cabeçalho x-api-token, e cada Bot na conta pode então chamar as 25 ferramentas.

Duas verificações mantêm a configuração honesta. Leia o resultado de uma chamada de ferramenta real em vez do distintivo de status, já que uma chave errada e um conector de chave API funcional podem parecer inacabados. E decida onde a chave deve residir antes de enviar a mensagem: no chat para um Bot privado, ou no cartão de aprovação quando os colegas de equipe podem ler a conversa.

Pronto para dar aos seus Bots uma visão ao vivo da web? Comece com o plano gratuito do Scrapeless e envie a mensagem do Passo 1.

FAQ

P: Posso adicionar um servidor MCP personalizado ao Grok Bot?

Sim. Peça a um Bot para adicionar um servidor MCP remoto personalizado e forneça a URL HTTPS do servidor e quaisquer cabeçalhos que precisar. O Grok Bot mostra um cartão de aprovação Adicionar Servidor MCP com o nome, tipo, URL e cabeçalhos, e salva o conector quando você confirma.

P: Por que o Scrapeless não aparece quando procuro nos Plugins do Grok Bot?

O catálogo de Plugins lista plugins publicados, e o Scrapeless não é um deles. Ele se conecta como um conector personalizado em vez disso, que não aparece na pesquisa do Marketplace.

P: Qual cabeçalho o Scrapeless precisa no Grok Bot?

x-api-token, com sua chave API Scrapeless como valor. Um cabeçalho Authorization: Bearer é rejeitado com 401 Unauthorized: Missing x-api-token header.

P: Por que meu conector Scrapeless diz Que precisa de autenticação?

O distintivo do Grok Bot conta apenas sign-ins OAuth como autenticados, e o Scrapeless usa uma chave API. A equipe do Cursor descreve o distintivo como cosmético para conectores assim. Execute uma chamada de ferramenta para confirmar se o conector funciona.

P: Devo colocar minha chave API na mensagem do chat?

Funciona, mas a chave fica na conversa do Bot, e os colegas de equipe veem esse histórico em um Bot compartilhado. Para Bots compartilhados, deixe o valor fora da mensagem e digite a chave no cartão de aprovação.

P: Todos os meus Bots recebem as ferramentas do Scrapeless?

Sim. Servidores MCP personalizados são em toda a conta, então um conector que um Bot adiciona está disponível para os outros Bots na mesma conta.

P: Quantas ferramentas o Scrapeless adiciona ao Grok Bot?

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