認証とトランスポート
認証
Scrapeless MCP Serverへのすべてのリクエストは、ScrapelessのAPIトークンで認証されます。Scrapelessにログインし、ダッシュボードからトークンをコピーしてください。
トークンの渡し方は、使用するトランスポートによって異なります:
- Stdio —
SCRAPELESS_API_KEY環境変数として設定します。 - Streamable HTTP —
x-api-tokenリクエストヘッダーとして送信します。
トークンは秘密に保ってください:パスワードと同様に扱い、環境変数やシークレットマネージャーに保存し、ソース管理システムにコミットしないでください。
トランスポート
サーバーは2つのトランスポートモードをサポートしています。どちらも同一のツールセットを公開しますが、唯一の違いはサーバーが実行される場所と、その接続方法です。
| Stdio | Streamable 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 を選択してください。
プロファイルやタイムアウトなどのセッションごとの設定については、設定を参照してください。