認証とトランスポート
認証
Scrapeless MCPServerへのすべてのリクエストは、お客様のScrapeless APITokenによる認証が必要です。 Scrapeless にログインし、ダッシュボードからトークンをコピーしてください。
トークンの渡し方はトランスポートによって異なります:
- Stdio — これを
SCRAPELESS_KEY環境変数として設定します。 - StreamableHTTP — これを
x-api-tokenリクエストヘッダーとして送信します。
トークンは秘密にしてください。パスワードのように扱い、環境変数またはシークレットマネージャーに保存し、ソース管理に絶対にコミットしないでください。
トランスポート
サーバーは2つのトランスポートモードをサポートしています。どちらも同じツールセットを提供します。唯一の違いは、サーバーがどこで実行され、どのようにアクセスされるかです。
| Stdio | Streamable HTTP | |
|---|---|---|
| 実行場所 | ローカルで、クライアントが npx | Scrapelessがホスト |
| 最適な用途 | デスクトップクライアント(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を参照してください。