ドキュメント開発者ツールScrapeless MCP認証とトランスポート

認証とトランスポート

認証

Scrapeless MCP Serverへのすべてのリクエストは、ScrapelessのAPIトークンで認証されます。Scrapelessにログインし、ダッシュボードからトークンをコピーしてください。

トークンの渡し方は、使用するトランスポートによって異なります:

  • Stdio — SCRAPELESS_API_KEY 環境変数として設定します。
  • Streamable HTTP — x-api-token リクエストヘッダーとして送信します。

トークンは秘密に保ってください:パスワードと同様に扱い、環境変数やシークレットマネージャーに保存し、ソース管理システムにコミットしないでください。

トランスポート

サーバーは2つのトランスポートモードをサポートしています。どちらも同一のツールセットを公開しますが、唯一の違いはサーバーが実行される場所と、その接続方法です。

StdioStreamable HTTP
実行場所ローカル環境(クライアントが npx で起動)Scrapelessによるホスティング
推奨用途デスクトップクライアント(Claude Desktop、Cursor、Cline)リモートエージェント、サーバーレス、ホスティングプラットフォーム
認証SCRAPELESS_API_KEY 環境変数x-api-token ヘッダー
前提条件ローカルで Node.js と npx が利用可能api.scrapeless.com へのネットワークアクセス

Stdio(ローカル実行)

クライアントはサーバーをローカルのサブプロセスとして起動します:

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": {
        "SCRAPELESS_API_KEY": "YOUR_SCRAPELESS_API_KEY"
      }
    }
  }
}

Streamable HTTP(ホスト型APIモード)

クライアントはホストされたエンドポイントに接続します。ローカルでは何も実行されません:

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "type": "streamable-http",
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_API_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

どちらを使うべきか?

  • npx の実行が容易なローカル開発やデスクトップクライアントには、Stdio を選択してください。
  • ホスト型エージェント、CI、またはローカルのNodeプロセスを実行できない(または実行したくない)環境には、Streamable HTTP を選択してください。

プロファイルやタイムアウトなどのセッションごとの設定については、設定を参照してください。