Grok Bot と Scrapeless: カスタム MCP コネクタを追加する

TL;DR:

• ScrapelessはGrok Botのプラグインカタログには含まれていないため、カスタムコネクタとして追加されます。 マーケットプレイスでの検索結果は何も返ってきません。ボットに依頼するとカスタムリモートMCPサーバーを登録します。
• 英語のメッセージ1つでセットアップが完了します。 サーバーの名前を付け、URL https://api.scrapeless.com/mcp を指定し、ボットに x-api-token ヘッダーで認証するよう指示します。
• Grok Botは何かが保存される前に承認カードを表示します。 名前、Remote HTTPSタイプ、サーバーURL、ヘッダーを確認し、次に保存します。
• ヘッダー名は x-api-token です。 Bearerヘッダーは 401 Unauthorized: Missing x-api-token header で拒否されます。
• ツールコールで証明します。ステータスバッジではありません。 Scrapelessは任意のキー値のためのハンドシェイクに応答し、APIキーコネクタは動作中に「認証が必要」という装飾的なバッジを表示できます。
• Scrapelessの無料プランでキーを取得し、数分で接続できます。

Grok Botはすべてのボットに自分専用のクラウドコンピュータ、ブラウザ、およびコネクタのセットを提供します。レンダリングされたページをクリーンなMarkdownに変換したり、バックグラウンドでクロールしたり、ツールコールからGoogleの結果を取得したりする直接的な方法が不足しています。Scrapeless MCPサーバーは、あなたのアカウント上のすべてのボットが呼び出せるツールとしてそれらを追加します。

接続はカスタムリモートMCPサーバーであり、Grok Botでは設定ページを記入するのではなく、ボットに依頼することで作成します。このガイドでは、送信するメッセージ、承認カードで確認すること、および作動しているコネクタを、見た目だけ接続されているコネクタから区別する方法を説明します。

Scrapelessがプラグインマーケットプレイスにない理由

Grok Botはコネクタをプラグインとして表示し、そのカタログはCursorのものです。xAIのチーム向けGrok Botガイドによると、別のGrok Botコネクタリストは存在せず、コネクタはアプリ内でプラグインとして表示され、Grok BotはチームのCursorコネクタポリシーを継承します。Scrapelessはそのカタログに発表されていないため、マーケットプレイスでの検索結果は空になります。

カタログ外のものはカスタムコネクタとして追加され、ボットがそれを行います。リモートサーバーのHTTPS URLと必要なヘッダーを提供し、確認の後にAdd MCPツールでサーバーを登録します。カスタムコネクタはアカウント全体で利用可能で、一度1つのボットがScrapelessを追加すると、同じアカウント内の他のボットもそれを使用できます。

Scrapelessがあなたのボットに追加する機能

サーバーは25のツールを公開し、タスクごとにグループ化されています：

• scrape_markdown、scrape_htmlおよびscrape_screenshotは、一度の呼び出しでレンダリングされたページをMarkdown、生のHTMLまたは画像として返します。
• browser_*ツールは16個あり、browser_create、browser_gotoからbrowser_click、browser_typeおよびbrowser_snapshotまで、クラウドブラウザセッションを段階的に実行します。
• crawl_start、crawl_resultおよびcrawl_cancelは、バックグラウンドでクロールを実行し、後で収集します。
• google_searchおよびgoogle_trendsは検索結果とトレンドデータを返し、ai_scraperはChatGPT、GeminiおよびPerplexityなどのAIアシスタントからの回答をキャプチャします。

ボットはすでに自分のブラウザを持っています。違いは出力です：これらのツールは、モデルが直接読み取れるページコンテンツを返し、クリックしなければならないセッションではありません。

前提条件

• 対象プランにあるGrok Bot。xAIはSuperGrok Plus、SuperGrok Heavy、Cursor Pro+、Cursor UltraおよびCursor Teams StandardまたはPremiumをリストしています。このガイドではWindows上のGrok Botデスクトップアプリ、バージョン0.47.0を使用しました。
• ScrapelessダッシュボードからのScrapeless APIキー。
• Cursorチーム内では、サーバーを許可するコネクタポリシー。ポリシーがブロックすると、メンバーはプラグインをチーム管理者によって無効にされていますとして見ることになります。

ステップ1: ボットにScrapelessを追加するよう依頼する

任意のボットを開き、以下のメッセージを送信してください。プレースホルダーの代わりにあなたのキーを入れてください。

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.

最後の行が実際の作業を行います。ほとんどのコネクタはOAuthまたはBearerトークンで認証し、Bearerを想定するボットはScrapelessが拒否するヘッダーを構築します。そのエンドポイントはそのリクエストに 401 Unauthorized: Missing x-api-token header で応答します。

メッセージの一部としてキーがどこに送信されるかを知ってください。それはそのボットの会話に留まり、他のチームメンバーとボットを共有すると、過去の会話を含む完全な履歴が表示されます。Grok Botの秘密に関するヘルプページはAPIキーをチャットから外しておくことを推奨しています。共有ボットの場合は、値なしで同じメッセージを送信し、ステップ2で承認カードにキーを入力してください。これが、このセットアップがテストされたときにキーが入力された方法です。

今これを設定していますか？ Scrapelessの無料プランでは接続と最初のツールコールがカバーされています。

ステップ2: 承認カードを確認して保存する

ボットが何かを登録する前に、Grok BotはAdd MCP Serverカードを表示します。各フィールドを要求した内容と比較してください：

OAuthクライアントIDとクライアントシークレットは空のままにしてください。なぜなら、ScrapelessはOAuthを使用しないからです。ヘッダー値が空白の場合は、そこにキーを入力し、Saveを選択します。このカードにはEdit JSONもあり、サーバーの同じ内容を名前によってキー付けされたJSONオブジェクトとして保持します。サーバーは一度に一つです。

保存されたキーはコネクターに残ります。xAIのドキュメントによれば、OAuthトークンはCursorのコネクターバックエンドに残り、ボットはそれらを受け取ることなくツールを呼び出します。ホステッドエージェントのためのCursorのドキュメントは、HTTP MCPサーバー上のヘッダー値が静止状態で暗号化され、保存後に非表示になり、エージェントの機械に配置されることはないと追加しています。ツール呼び出しはCursorのバックエンドを通過します。

ステップ3: ツール呼び出しを実行する

ボットに小さく、チェック可能なジョブを依頼します：

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.

動作するコネクターはページの見出しを返します：

"# Example Domain"

ツール呼び出しは重要なテストです。なぜなら、コネクターのステータスは良いキーと悪いキーを区別できないからです。ScrapelessはMCPハンドシェイクに応答し、任意のキー値に対して25のツールをリストします。違いは、ツールが実行されるときにのみ表示されます：無効なキーでの結果テキストはFailed to fetch dataから始まります。

ステータスバッジも逆方向に誤解を招くことがあります。Grok Botのプラグインバッジは、OAuthサインインのみを認証済みとしてカウントするため、APIキーを使用しているコネクターはツールが機能しているのにNeeds authを読み取ることがあります。CursorのスタッフはNeeds authバッジはこのようなコネクターに対してコスメティックであると確認しました。Authenticateを押してもそれは変わりません；上記のツール呼び出しがチェックです。

よくある問題を解決する

最後の行は、起こる前に知っておく価値があります。Grok Botはアカウントのすべてのコネクターを共有の時間予算の下で発見するため、ハンドシェイクに応答しない単一のサーバーがすべてのコネクターを空にする可能性があります。Scrapelessはテストでハンドシェイクに0.5秒未満で応答したため、沈黙するコネクターではありません。

Cursorチーム全体でScrapelessを共有する

ボットに依頼することで、一つのアカウントにコネクターが追加されます。すべてのメンバーのために同じコネクターを望むチームは、Cursorチームマーケットプレイスにプラグインとして公開することができます。これはTeamsおよびEnterpriseプランでサポートされています。メンバーはその後、チームプラグインの下のプラグインカタログでそれを見つけ、誰もチャットにキーをコピーすることはありません。

プラグインのmcp.jsonはプレースホルダーだけを保持します：

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

その.cursor-plugin/plugin.jsonは、そのプレースホルダーを変数として宣言します。したがって、チーム管理者はCursorダッシュボードでPlugins → Configureの下に実際のキーを設定します：

{
  "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"]
  }
}

Teamsプランでは1つのチームマーケットプレイスが許可されているため、すでにインポートされたチームは、2つ目を作成するのではなく、そのリポジトリにScrapelessプラグインを追加します。
より詳細な情報は、Scrapeless MCPサーバー発表をお読みください。カーソル設定ガイドは、カーソルエディタでの同じサーバーをカバーしており、ブラウザMCPドキュメントが設定リファレンスを持ち、スクレイピングAPIページがツールの背後にいるアクターをカバーし、価格が呼び出しのコストを示します。

結論

ScrapelessをGrok Botに追加するには、1つのメッセージと1つの承認が必要です。Botはhttps://api.scrapeless.com/mcpをカスタムリモートMCPサーバーとして登録し、承認カードは名前、タイプ、URL、x-api-tokenヘッダーを確認し、アカウント内のすべてのBotが25のツールを呼び出すことができるようになります。

2つのチェックにより、セットアップが誠実になります。正しいキーと動作中のAPIキーコネクタの両方が未完成に見える可能性があるため、ステータスバッジではなく、実際のツール呼び出しの結果を読みます。そして、メッセージを送信する前にキーがどこにあるべきかを決めてください：プライベートBotの場合はチャット内、またはチームメイトが会話を読むことができる承認カード内です。

あなたのBotにウェブのライブビューを提供する準備はできましたか？ Scrapelessの無料プランから始めるを選び、ステップ1からメッセージを送信してください。

FAQ

Q: Grok BotにカスタムMCPサーバーを追加できますか？

はい。BotにカスタムリモートMCPサーバーを追加するように依頼し、サーバーのHTTPS URLと必要なヘッダーを提供してください。Grok Botは追加MCPサーバー承認カードを表示し、名前、タイプ、URL、ヘッダーを含み、確認するとコネクタを保存します。

Q: Grok Botのプラグインを検索してもScrapelessが表示されないのはなぜですか？

プラグインカタログには公開されたプラグインが一覧表示されており、Scrapelessはその1つではありません。代わりにカスタムコネクタとして接続され、市場の検索には表示されません。

Q: Grok BotでScrapelessにはどのヘッダーが必要ですか？

x-api-tokenを、あなたのScrapeless APIキーを値として持ちます。Authorization: Bearerヘッダーは401 Unauthorized: Missing x-api-token headerと共に拒否されます。

Q: なぜ私のScrapelessコネクタは「Needs auth」と表示されるのですか？

Grok Botのバッジは、OAuthサインインのみを認証されたものとしてカウントし、ScrapelessはAPIキーを使用します。カーソルスタッフは、このようなコネクタに関してバッジを装飾的なものとして説明しています。コネクタが機能するかを確認するためにツール呼び出しを実行してください。

Q: APIキーをチャットメッセージに入れるべきですか？

機能しますが、その場合、キーはBotの会話に残り、チームメイトは共有Botでその履歴を見ることになります。共有Botの場合、メッセージから値を省き、承認カードにキーを入力してください。

Q: すべてのBotにScrapelessツールは提供されますか？

はい。カスタムMCPサーバーはアカウント全体で利用可能で、1つのBotが追加したコネクタは同じアカウントの他のBotでも利用できます。

Q: ScrapelessはGrok Botにいくつのツールを追加しますか？

25：3つのscrape_*ツール、16のbrowser_*ツール、3つのcrawl_*ツール、さらにgoogle_search、google_trends、ai_scraperです。