Claude.ai + Scrapeless: カスタムMCPコネクタを追加する

TL;DR:

• Scrapelessは、claude.aiにカスタムコネクタとして接続します。 Add custom connectorダイアログにhttps://api.scrapeless.com/mcpを追加し、APIキーをリクエストヘッダーとして渡します。
• 認証を「サインインなし」に切り替えます。 Claudeは検出したオプションを自動的に選択し、Scrapelessの場合は今すぐサインインが選択されましたが、サーバーはOAuthサインインを提供していません。
• 1つのリクエストヘッダーを追加します：x-api-token、値はベアキーとします。 Claudeは入力したままの値を正確に送信するため、キーの前に何も追加しません。
• リクエストヘッダーはベータ版です。 Anthropicは限られた組織に対してこれを提供しており、チームおよびエンタープライズプランではオーナーがコネクタを追加します。
• 25のツールをリストするコネクタは、まだキーを証明していません。 Scrapelessは任意のキー値でそのツールをリストするため、チャット内で1つのツーリストコールで確認してください。
• Scrapelessの無料プランでキーを取得し、数分以内に接続します。

Web上のClaudeには独自のウェブ検索があります。Scrapeless MCPサーバーは、実際のブラウザでレンダリングされたページを返し、Markdownとして戻します。Claudeはクリックごとに操作できるクラウドブラウザを駆動し、バックグラウンドでクロールし、Googleの結果データを取得します。一度接続されると、Claudeは会話の最中にこれらのツールを呼び出します。

このガイドでは、claude.aiのAdd custom connectorダイアログを介してホストされたサーバーを追加します。ダイアログは単一のフォームであり、Scrapelessには注意が必要な設定が2つあります：Claudeが検出するサインインオプションと、キーを運ぶヘッダーです。

How a Custom Connector Reaches Scrapeless

カスタムコネクタは、ClaudeがAnthropicのクラウドから呼び出すリモートMCPサーバーです。 Anthropicのカスタムコネクタに関するガイドによると、これはすべてのClaudeクライアント、包括的にclaude.aiに当てはまるため、サーバーはパブリックインターネットを介して到達可能である必要があります。Scrapelessは公共のHTTPSエンドポイントで実行されるため、ホスティングやホワイトリスト設定は必要ありません。

認証がセットアップの残りを決定します。多くのコネクタはOAuthを通じて各人をサインインさせます。ScrapelessにはOAuthフローがなく、すべてのリクエストでx-api-tokenヘッダーからAPIキーを読み取ります。 ClaudeのリモートMCPコネクタに関するドキュメントは、コネクタが追加された際に一度だけ入力され、すべてのリクエストで送信される固定資格情報のケースをカバーしています。

What Scrapeless Adds to Claude

サーバーは25のツールを公開しており、仕事に応じてグループ化されています：

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

コネクタの設定で、Claudeは「AIスクレイパー」や「ブラウザクリック」といった読みやすい名称の下にそれらをリストします。それぞれには独自の権限があります。

Prerequisites

• カスタムコネクタ付きのClaudeプラン。AnthropicはFree、Pro、Max、Team、およびEnterpriseをリストし、Freeを1つのカスタムコネクタに制限します。
• Add custom connectorダイアログ内のリクエストヘッダーセクション。リクエストヘッダー認証は限られた組織に対してベータ版であり、セクションが欠けている場合はあなたの組織はまだアクセス権を持っていません。
• チームおよびエンタープライズプランでは、オーナーまたは主要オーナーがコネクタを追加します。
• ScrapelessダッシュボードからのScrapeless APIキー。

Step 1: Open Add Custom Connector

ダイアログが開く場所はプランによって異なります：

最初のステップに入力します：

URLにキーを含めないでください。Scrapelessはx-api-tokenヘッダーからのみそれを読み取り、Anthropicのコネクタ用認証ガイドは、URLに資格情報を含めないことを推奨します。なぜなら、URLはサーバーログ、プロキシ、ブラウジング履歴に記録されるからです。
今、これを設定していますか？Scrapeless 無料プランは接続と最初のツール呼び出しをカバーします。

ステップ 2: 検出されたオプションをサインインなしに変更

続行すると、ClaudeはURLをチェックし、検出された認証を事前に選択します。これは検出されたとマークされています。https://api.scrapeless.com/mcpの場合、検出されたオプションは今すぐサインインでした。代わりにサインインなしを選択してください。

2つのサインインオプションはOAuthフローを実行しますが、Scrapelessはそれを提供していません。401レスポンスにはWWW-Authenticateヘッダーが含まれておらず、OAuth発見経路は404を返します。サインインなしは、AnthropicのドキュメントがAPIキーを使用するサーバーのためのオプションとして名前付けしており、そのキーはリクエストヘッダーの下にあります。これが選択されると、OAuthクライアントフィールドはダイアログから消えます。

ステップ 3: x-api-token ヘッダーを追加

リクエストヘッダーを開き、1行を追加します：

次に、追加をクリックします。

リストから名前を選択するか、カスタムヘッダーを選択して入力します。Anthropicは、Claudeがサードパーティサーバーに送信する前に各カスタムヘッダー名を承認します。未承認の名前はダイアログで拒否されます。x-api-tokenはテスト時にエラーなしで保存されました。

値にはプレフィックスは必要ありません。Claudeは入力された通りに送信し、認証スキームを追加しません。これはScrapelessが期待するもので、サーバーはヘッダー値全体をキーとして読み取ります。Bearer <key>やtoken <key>のような値もハンドシェイクとツールリストを通過するものの、ツール呼び出しではすべて失敗します。

必須は、欠けている値がヘッダーなしでリクエストを送信するのではなく、接続を失敗させます。Claudeは値を安全に保存し、再度表示しません。認証設定は後で編集できないため、誤ったキーやヘッダー名の場合はコネクタを削除して再追加する必要があります。

ステップ 4: ツールとその権限を確認

カスタマイズ > コネクタを開いてScrapelessを選択します。コネクタページには、ツールの権限の下にすべての25ツールがリストされ、各ツールは常に許可、承認が必要、またはブロックに設定できます。テストでは、すべてのScrapelessツールは承認が必要で始まるため、Claudeは各呼び出しの前に確認を求めます。

ジョブに必要ないものはブロックしてください。ページを読み取るだけのチャットはscrape_markdownやgoogle_searchを利用可能とし、ライブブラウザセッションを駆動するbrowser_*ツールをブロックできます。コネクタの使用に関するAnthropicの記事は、すべてのコネクタに対する同じ3つの権限レベルを説明しています。

ステップ 5: チャットでツール呼び出しを1回実行

コネクタは会話ごとに有効化されます。新しいチャットで、**+**をクリックし、コネクタを開いてScrapelessを有効にします。次に、小さく検証可能なジョブを依頼します：

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

Claudeが承認を求めた場合はその呼び出しを許可します。Claudeはhttps://example.comに対するマークダウンをスクレイピングステップを示し、次にページをマークダウンとして返します。最初は：

# Example Domain

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

この呼び出しが重要なテストです。ScrapelessはMCPハンドシェイクに応答し、任意のキー値のために25のツールをリストアップします。したがって、完全なツールリストを持つ接続されたコネクタは、ヘッダーが到着しただけを表示します。誤ったキーの場合、ツールの結果はFailed to fetch dataから始まります。

一般的な問題を解決する

組織全体のための1つのキー

リクエストヘッダーはコネクタに保存される1つの認証情報です。Claudeのドキュメントは、全員が認証情報を共有するサービスにリクエストヘッダーが適していると説明しています。チームおよびエンタープライズプランでは、オーナーがすべてのメンバーのために1回入力します。その後、すべてのメンバーのScrapeless呼び出しはその1つのキーとそのプランで実行されます。
使うキーはClaude専用のものを作成してください。これにより、他の統合に触れずにローテーションすることができます。ローテーションとは、コネクタを削除し、新しいキーで再度追加することを意味し、その後メンバーは再接続します。全チームを考慮してツールの権限を設定してください。

サーバーがどのような情報を公開しているかについては、Scrapeless MCPサーバーのお知らせを読んでください。Browser MCPドキュメントには設定の参照があり、Scraping APIページにはツールの背後にいるアクターについて説明されています。また、価格には呼び出しのコストが記載されています。

結論

Scrapelessは、URL https://api.scrapeless.com/mcp、検出されたサインインオプションの代わりにNo sign-in、および bare key を保持するx-api-tokenリクエストヘッダーという3つの設定を持つカスタムコネクタとしてclaude.aiに統合されます。チャットでコネクタをオンにすると、Claudeはすべての25ツールを呼び出すことができます。

ツールリストはヘッダーが到着したサインとして読み取られ、キーが機能することを示すものではありません。実際のページを返す1回のscrape_markdown呼び出しがキーを確定し、ツールの権限がClaudeが許可なくどれだけ行えるかを決定します。

Claudeにクラウドブラウザとクリーンなページコンテンツを提供する準備はできましたか？Scrapelessの無料プランから始めるためにコネクタを追加してください。

FAQ

Q: claude.aiにAPIキーを使ってカスタムコネクタを追加できますか？

はい、リクエストヘッダーのベータ版が利用可能な場合です。カスタムコネクタ追加ダイアログでNo sign-inを選択し、リクエストヘッダーの下にキーを追加します。Claudeは値を保存し、サーバーへのすべてのリクエスト時に送信します。

Q: claude.aiでScrapelessのどの認証オプションを選べばよいですか？

No sign-in。ClaudeはSign in nowを検出としてマークする可能性がありますが、ScrapelessにはOAuthサインインがなく、x-api-tokenヘッダーを使って認証します。

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

x-api-token、APIキーを全体の値として使用します。Claudeはプレフィックスを追加しないので、キーのみを入力してください。

Q: カスタムコネクタの追加ダイアログでリクエストヘッダーが見えないのはなぜですか？

リクエストヘッダー認証はベータ版であり、限られた組織に提供されています。そのセクションがない場合、ScrapelessのようなAPIキーを持つサーバーはダイアログから追加できません。

Q: コネクタを追加した後にScrapelessキーを変更できますか？

その場ではできません。コネクタが追加された後、認証設定（リクエストヘッダーを含む）は変更できません。コネクタを削除し、新しいキーで再度追加してください。その後メンバーは再接続します。

Q: 間違ったキーを使用しているとコネクタが25ツールを表示するのはなぜですか？

Scrapelessはどのキー値でもツールをリストします。ツールを実行するときにキーが確認され、間違ったキーはFailed to fetch dataで始まるテキストを返します。

Q: コネクタのURLにScrapeless APIキーを入れられますか？

いいえ。Scrapelessはx-api-tokenヘッダーでのみキーを受け入れ、AnthropicはコネクタのURL内での資格情報を推奨していません。

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

25個：3つの scrape_* ツール、16のbrowser_* ツール、3つのcrawl_* ツール、加えて google_search、google_trends、ai_scraper。