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

認証とトランスポート

認証

Scrapeless MCPServerへのすべてのリクエストは、お客様のScrapeless APITokenによる認証が必要です。 Scrapeless にログインし、ダッシュボードからトークンをコピーしてください。

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

  • Stdio — これを SCRAPELESS_KEY 環境変数として設定します。
  • StreamableHTTP — これを x-api-token リクエストヘッダーとして送信します。

トークンは秘密にしてください。パスワードのように扱い、環境変数またはシークレットマネージャーに保存し、ソース管理に絶対にコミットしないでください。

トランスポート

サーバーは2つのトランスポートモードをサポートしています。どちらも同じツールセットを提供します。唯一の違いは、サーバーがどこで実行され、どのようにアクセスされるかです。

StdioStreamable HTTP
実行場所ローカルで、クライアントが npxScrapelessがホスト
最適な用途デスクトップクライアント(Claude Desktop、Cursor、Cline)リモートエージェント、サーバーレス、ホスト型プラットフォーム
認証SCRAPELESS_KEY 環境変数x-api-token ヘッダー
前提条件Node.js+ npx がローカルで利用可能へのネットワークアクセス api.scrapeless.com

Stdio(ローカル実行)

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

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

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

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

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

どちらを使えばよいですか?

  • 接続方式として Stdio を選ぶのは、ローカル開発や、 npx を容易に実行できるデスクトップクライアントを使用する場合です。
  • ホスト型エージェント、CI、またはローカルNodeプロセスの実行ができない(あるいは好まない)環境では、 StreamableHTTP を選択してください。

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