Olostep MCPサーバー

Olostep MCPサーバーは、MCP互換のAIクライアント（Claude、Cursor、Windsurf、VS Code、Claude Codeなど）に、ライブウェブ用の10個のすぐに使えるツールを提供します。これには、スクレイピング、検索、引用付きAI回答、バッチジョブ、サイトクロール、URL発見が含まれます。

スクレイプ＆抽出

任意のURLからMarkdown、HTML、JSON、またはテキストをオプションのJSレンダリングで取得

AI回答

ソースと構造化出力を伴うウェブに基づいた回答

バッチ＆クロール

最大10万のURLを並行して処理、または自律的にサイト全体を発見

マップ＆検索

サイト上のすべてのURLを見つけるか、パーサーベースのウェブ検索を実行

始める前に

Olostep APIキーが必要です。Olostepダッシュボードから取得してください。無料プランは個人利用をカバーしています。

セットアップパスを選ぶ

すべてのクライアントにとって最速のパスは、https://mcp.olostep.com/mcpのホストされたエンドポイントです。インストール不要、Node不要、Docker不要—URLとAPIキーを貼り付けるだけです。完全にローカルで実行する必要がある場合（オフライン使用、企業プロキシ、エアギャップ）、すべてのクライアントはnpxを介したローカルstdioインストールもサポートしています。以下の各セクションで両方を示しています。

ホストされたエンドポイントはAuthorization: Bearer YOUR_API_KEYを使用します。ローカルstdioは環境変数としてOLOSTEP_API_KEYを使用します。これらを混同しないでください—誤った認証モードはオンボーディングエラーの第1位です。

クライアントセットアップ

ワンクリックインストール（推奨）:

結果として得られる設定のYOUR_API_KEYを実際のキーに置き換えてください。手動セットアップ:プロジェクトのルートに.cursor/mcp.jsonを作成または編集します（またはグローバルには~/.cursor/mcp.json）:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルstdioインストール（オプション）

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

マシンにNode.js 18+が必要です。

確認: Cursorを開く → 設定 → MCP。olostepがscrape_websiteを含む10ツールでリストされているはずです。“Connected, 0 tools”と表示される場合、APIキーが間違っています。

CLIインストール（推奨）:

claude mcp add --transport http olostep https://mcp.olostep.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

手動セットアップ:Claude Code MCP設定に追加します（プロジェクトルートの.mcp.json、またはグローバルには~/.claude.json）:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルstdioインストール（オプション）

claude mcp add --transport stdio --env OLOSTEP_API_KEY=YOUR_API_KEY olostep \
  -- npx -y olostep-mcp

またはJSONとして:

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

確認: Claude Codeで/mcpを実行します。olostepが10ツールで接続されているはずです。

設定ファイルの場所:

OS	パス
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

ホスト（推奨）:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルstdioインストール（オプション）

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

またはSmitheryを介してインストール:

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Claude Desktopは設定変更を反映するために完全に終了して再起動する必要があります—ウィンドウを閉じるだけでは不十分です（メニューバー/システムトレイで実行され続けます）。

確認: Claude Desktopを開く → チャット入力で🔨（ハンマー）アイコンを探します。それをクリックすると、10個のOlostepツールがリストされているはずです。

VS CodeのMCPサポートはGitHub Copilot（エージェントモード）に組み込まれています。プロジェクト内の.vscode/mcp.jsonまたはユーザーのsettings.jsonにこれを追加します:

{
  "servers": {
    "olostep": {
      "type": "http",
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルstdioインストール（オプション）

{
  "servers": {
    "olostep": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

確認: Copilotチャットパネルを開く → エージェントモードに切り替える → ツールのポップオーバーにOlostepツールがリストされるはずです。

~/.codeium/windsurf/mcp_config.jsonに追加:

{
  "mcpServers": {
    "olostep": {
      "serverUrl": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルstdioインストール（オプション）

{
  "mcpServers": {
    "olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

確認: Cascade → 設定 → MCP。olostepが10ツールで表示されるはずです。

サーバーをコンテナで実行したい場合（CI、隔離された環境、ホストにNodeがない場合）:

docker pull olostep/mcp-server

docker run -i --rm \
  -e OLOSTEP_API_KEY="YOUR_API_KEY" \
  olostep/mcp-server

MCPクライアント設定内（stdio）:

{
  "mcpServers": {
    "olostep": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OLOSTEP_API_KEY=YOUR_API_KEY",
        "olostep/mcp-server"
      ]
    }
  }
}

linux/amd64およびlinux/arm64をサポートします。GitHubでソースを確認できます。

Metorialダッシュボードを開く
MCPサーバーに移動
Olostepを検索
インストールをクリックしてAPIキーを貼り付け

手動設定の場合:

{
  "olostep": {
    "command": "npx",
    "args": ["-y", "olostep-mcp"],
    "env": {
      "OLOSTEP_API_KEY": "YOUR_API_KEY"
    }
  }
}

適切なツールを選ぶ

MCPサーバーは10個のツールを公開しています。この意思決定ツリーを使用して適切なものを選んでください—エージェントも同じ理由付けを使用します:

あなたが望むもの…	使用するツール	メモ
特定のページのコンテンツ	`scrape_website`または`get_webpage_content`	SPAには`wait_before_scraping=2000–5000`を設定
ソース付きの自然言語ウェブ回答	`answers`	AI合成+引用を返す
クエリの検索結果	`search_web`	パーサーベース、非AI、構造化
サイト上のURLリスト	`create_map`	URL発見のみ—スクレイプしない
クエリでフィルタリングされたURL	`get_website_urls`	`search_query`に対する関連性でランク付け
既知の多数のURLを一度に	`batch_scrape_urls` + `get_batch_results`	非同期—開始後にポーリング
サイト全体またはセクション	`create_crawl` + `get_crawl_results`	非同期—開始URLからリンクをたどる

サイト全体をスクレイプしますか？ create_crawlを使用してください。batch_scrape_urlsではありません。クロールは発見とスクレイプを行います。バッチはすでに持っている既知のURLリスト用です。

ツールの詳細

scrape_website

単一のURLからコンテンツを抽出します。markdown、html、json、textをサポート。地理ターゲットリクエスト用のオプションのcountry、JSが多いサイト用のwait_before_scraping（0–10000 ms）、構造化抽出用のparser（例: @olostep/amazon-product）をサポート。

get_webpage_content

scrape_websiteの軽量なMarkdown専用バージョン。クリーンなMarkdownだけが欲しい場合に使用し、フォーマットオプションは不要です。

search_web

クエリに対する構造化（パーサーベース）のウェブ検索結果。ローカライズされた結果用のオプションのcountry。JSONを返し、AIの文章ではありません。

answers

ソースと引用付きのtaskに対するAI駆動の回答。特定の形状で回答を得るためにjson引数を渡します—JSONスキーマまたは短い自然言語の説明。

batch_scrape_urls

すでに持っている2–10万のURLの非同期スクレイプ。batch_idを返し、その後get_batch_resultsを呼び出してコンテンツを取得します。単一のブロッキングコールを希望する場合はwait_for_completion_seconds（最大900）を設定します。推奨: 50未満のURLのバッチには60、50–1kには300–600、より大きなバッチには0（別途ポーリング）。

get_batch_results

batch_idのステータスとスクレイプされたコンテンツを取得します。完了するまでprocessingを返し、その後completedとアイテム配列を返します。

create_crawl

start_urlからリンクをたどる非同期クロール。範囲を指定するためにinclude_url_patterns / exclude_url_patterns（グロブ構文、例: /blog/**）を使用します。crawl_idを返し、その後get_crawl_resultsを呼び出します。

get_crawl_results

crawl_idのステータスとページを取得します。cursorとitems_limit（1回の呼び出しで最大100）を使用してページネーションをサポートします。完了するまでin_progressを返します。

create_map

サイト上のURLリストを取得します。URL発見のみ—スクレイプしません。候補URLを浮き彫りにしたい場合に使用します（例: ユーザーにサブセットを選ばせる）。include_url_patterns / exclude_url_patternsおよびsearch_queryをサポートします。

get_website_urls

create_mapと似ていますが、URLは必須のsearch_queryに対する関連性でランク付けされます。サイト上の上位N個の一致するリンクが欲しい場合に使用します。

トラブルシューティング

サーバーが表示されるが0ツールと表示される

APIキーが無効またはレート制限されています。APIキーのダッシュボードを開いてキーを確認してください。ホストされたエンドポイントを使用している場合、ヘッダーは正確にAuthorization: Bearer sk_...でなければなりません—値の周りに引用符はなく、余分なスペースもありません。

npx: command not foundまたはcommand not found: olostep-mcp

Node.jsがインストールされていない（またはPATHにない）状態です。nodejs.orgからNode 18+をインストールし、その後ターミナルとMCPクライアントを再起動してください。Windowsでは、NodeがPATHにあるCMD/PowerShellに切り替えてください。

mcp.olostep.comで接続拒否またはDNSエラー

おそらく企業プロキシまたはホストをブロックするファイアウォールの背後にいます。ローカルstdioインストール（npx -y olostep-mcp）に切り替えてください—これは通常許可されるapi.olostep.comへのアウトバウンドリクエストを行います。

設定を編集したがツールリストが古い

クライアントが古い設定をキャッシュしています。完全に終了して再起動してください—ウィンドウを閉じるだけでは不十分です。特にClaude Desktopはメニューバー/システムトレイで実行され続けます。

Windows固有のnpxの失敗

Windowsでサーバーを起動する際にnpxがエラーを出す場合、CMDラップされた形式を使用してください:

{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "olostep-mcp"],
  "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY" }
}

401 Missing Authorization: Bearer <OLOSTEP_API_KEY>

認証ヘッダーなしでホストされたエンドポイントにアクセスした（または間違った形式で）。クライアント設定にセットアップタブで示された通りにヘッダーを追加してください。

レシピ

ツールでうまく機能するコピーペーストプロンプト:

商品URLのリストをスクレイプ: “200のAmazon商品URLのCSVがあります。parser=@olostep/amazon-productでバッチスクレイプし、JSONとして返してください。”
ドキュメントサイトをクロール: “https://stripe.com/docsを`max_pages=50`と`include_url_patterns=[‘/docs/**’]`でクロールします。各セクションをMarkdownとして要約してください。”
競合他社を見つける: “技術ドキュメントサイトのためのNotionの上位5つの競合他社を見つけるためにanswersを使用します。名前、ホームページ、1行のポジショニングを返してください。”
マップしてからスクレイプ: “https://example.comで`/blog/**`にフィルタリングされた`create_map`を実行し、上位20の結果で`batch_scrape_urls`を実行します。“

統合

Olostep MCPサーバー

スクレイプ＆抽出

AI回答

バッチ＆クロール

マップ＆検索

始める前に

セットアップパスを選ぶ

クライアントセットアップ

適切なツールを選ぶ

ツールの詳細

トラブルシューティング

レシピ

ソース＆バージョン

スクレイプ＆抽出

AI回答

バッチ＆クロール

マップ＆検索

​始める前に

​セットアップパスを選ぶ

​クライアントセットアップ

​適切なツールを選ぶ

​ツールの詳細

​トラブルシューティング

​レシピ

​ソース＆バージョン

始める前に

セットアップパスを選ぶ

クライアントセットアップ

適切なツールを選ぶ

ツールの詳細

トラブルシューティング

レシピ

ソース＆バージョン