CapSolver MCPの公式MCPレジストリからのインストール方法

TL;DR

• CapSolver MCPは、オフィシャルMCPレジストリにio.github.capsolver-ai/capsolver-mcpとして掲載されています。 現在の最新リリースは0.1.3で、PyPI経由で配布され、ローカルでstdio経由で起動されます。
• インストールの最短パスはuvx capsolver-mcpです。 uvxは隔離された環境を作成し、永続的なグローバルパッケージのインストールを必要とせずに公開されたコマンドを実行します。
• すべてのクライアント設定にはCAPSOLVER_API_KEYが必要です。 実際のキーはクライアントの環境または承認されたシークレットストアに保管し、パブリックリポジトリに含めないでください。
• 正常な接続では5つのツールが公開されます。 これらはトークンベースの解決、ページ検出、ページレベルの解決、残高チェック、およびサポートされるチャレンジタイプをカバーします。
• ブラウザベースのツールにはオプションのbrowserエクストラとPlaywright Chromiumが必要です。 トークンベースの基本ツールにはこの追加のブラウザインストールは必要ありません。
• CapSolverは、所有しているまたはテスト・自動化を許可されたワークフローでのみ使用してください。 レジストリの利用可能性は、プライベートまたは制限付きシステムへのアクセス権を保証するものではありません。

オフィシャルMCPレジストリからCapSolver MCPをインストールする

オフィシャルMCPレジストリは、MCPクライアントと開発者に、CapSolver MCPのパッケージ、トランスポート、必要な環境変数、リポジトリ、および現在のバージョンを検索するための標準的な記録を提供します。レジストリはPythonパッケージをホストしておらず、代わりに確認済みのcapsolver-mcpリリースをPyPIにポイントしています。

このチュートリアルでは、検索、インストール、設定、および最初の接続チェックの手順を説明します。これは、法的な、許可されたAIエージェント、QA、RPA、およびブラウザ自動化ワークフローでのみCapSolverを使用します。

オフィシャルレジストリエントリが提供する内容

CapSolver MCPエントリは、互換性のあるクライアントが必要とする正確なメタデータを公開します。これにより、ローカルのstdio設定が構築されます。

現在のエントリは、オフィシャルMCPレジストリの検索インターフェースで確認できます。レジストリは上流カタログであり、実際のパッケージはPyPIにあります。MCPレジストリのリリースドキュメントは、このカタログと配布モデルについて説明しています。

前提条件

CapSolver MCPにはPython 3.10以降、互換性のあるMCPクライアント、およびCapSolver APIキーが必要です。

クライアント設定を編集する前に以下の準備をしてください:

1. Python 3.10以降をインストールしてください。
2. 推奨されるuvxワークフローを使用する場合はuvをインストールしてください。
3. CapSolverアカウントを作成し、ダッシュボードからAPIキーを取得してください。
4. MCPクライアントがローカルstdioサーバーをサポートしていることを確認してください。
5. トークンベースのツールのみが必要か、オプションのブラウザツールが必要かを決定してください。

CapSolver MCPサービスドキュメントはサポートされる統合パスを説明し、CapSolver AIエージェント概要はMCP、エージェントツール、およびCore SDKの選択を補助します。

ステップ1: 正しいレジストリ記録を検索する

オフィシャルMCPレジストリでcapsolverを検索し、以下の正確な名前を選択してください:

io.github.capsolver-ai/capsolver-mcp

表示されているバージョンが0.1.3またはそれ以降で、状態がアクティブであることを確認してください。パブリッシャー、リポジトリ、権限、およびソースコードを別途確認していない限り、類似した名前のコミュニティパッケージは避けてください。

APIレベルのチェックには、以下のコマンドを実行してください:

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"

レジストリ名のスラッシュは%2Fにエンコードされています。応答はcapsolver-mcpがPyPIパッケージであり、uvxがランタイムヒント、stdioがトランスポートであることを示しているはずです。

ステップ2: CLIをインストールして確認する

推奨されるパスは隔離された環境でCapSolver MCPを実行することです:

uvx capsolver-mcp --help

マネージドされた仮想環境を好む場合は、パッケージを明示的にインストールしてください:

python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --help

現在のCLIはstdio、sse、streamable-httpのランタイムモードをサポートしています。オフィシャルMCPレジストリエントリはstdioを使用しているため、クライアントがローカルパッケージをサブプロセスとして起動します。このパッケージは、独自のインフラストラクチャでHTTP対応プロセスを起動することもできますが、CapSolverは現在レジストリにホストされたリモートMCPエンドポイントを公開していません。

uvxのアプローチは、公式uvツールガイドに記載されている隔離されたツール実行モデルに従っています。

CapSolverボーナスコードを取得する

自動化予算を即座に増やす！
CapSolverアカウントにチャージする際にボーナスコードCAP26を使用すると、毎回5%のボーナスが追加されます—制限なし。
現在、CapSolverダッシュボードで取得してください

ステップ3: ローカルMCPクライアントを設定する

ローカルクライアントはuvx capsolver-mcpを起動し、CAPSOLVER_API_KEYをサブプロセスに渡す必要があります。

Claude Desktopや互換性のあるローカルサーバー設定を持つクライアントでmcpServersオブジェクトを受け入れる場合、以下の構成を使用してください:

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

プレースホルダーをローカルで置き換えてください。実際のAPIキーをGitにコミットしたり、問題報告に貼り付けたり、スクリーンショットに含めないでください。

デスクトップアプリケーションがuvxを見つからない場合、以下のコマンドで返される絶対パスを使用してください:

which uvx

Windows PowerShellでは:

Get-Command uvx

設定を保存した後、MCPクライアントを完全に再起動してください。ウィンドウの閉じる操作はアプリケーションをバックグラウンドで実行し続ける可能性があるため、設定を編集した後でもサーバーが表示されない場合はプロセスを終了してください。

ステップ4: MCPハンドシェイクとツールを確認する

正常な接続では、クライアントに5つのCapSolver MCPツールが公開されます。

ブラウザベースのチェックではなく、以下の手順から始めます:

CapSolver MCPサーバーを使用してサポートされるCAPTCHAタイプをリストします。

アカウント認証を確認するには:

CapSolver MCPサーバーを使用してアカウント残高を確認します。

これらのチェックは、クライアントがstdioプロセスを起動し、ツールを検出、環境変数を渡すことができることを確認します。実際の解決リクエストには、認可されたターゲットパラメータと十分なアカウント残高が必要です。

ステップ5: 必要に応じてブラウザベースのツールを有効にする

ブラウザベースの検出とページ操作には、オプションのパッケージエクストラとPlaywright Chromiumが必要です。

専用の環境では、以下のコマンドを実行してください:

python -m pip install "capsolver-mcp[browser]==0.1.3"
playwright install chromium

MCPクライアントがuvxを起動する場合、パッケージ引数にブラウザエクストラを含めてください:

{
  "mcpServers": {
    "capsolver-browser": {
      "command": "uvx",
      "args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Playwrightは同じマシンに互換性のあるChromiumバイナリが必要です。本番ワークフローではバージョンをピン止めし、ステージングでアップグレードをテストし、ブラウザインストールをアプリケーションシークレットとは別に管理してください。

一般的な設定問題

CapSolver MCP接続エラーの多くは、ランタイムパス、Pythonバージョン、欠落した資格情報、またはオプションのブラウザ依存関係に起因します。

クライアントがspawn uvx ENOENTを報告する

デスクトップアプリケーションがプロセスのPATHにuvxを見つけることができません。commandフィールドに絶対パスのuvxを使用し、アプリケーションを完全に再起動してください。

サーバーは起動するがツールは認証に失敗する

CAPSOLVER_API_KEYの値が欠落している、不正な形式、または子プロセスに届いていない可能性があります。変数名を正確に確認し、プレースホルダーを置き換え、JSON値内で余分な引用符を避けてください。

detect_captchasまたはsolve_on_pageが利用できない

ベースパッケージはPlaywrightをインストールしていません。capsolver-mcp[browser]をインストールし、Chromiumをインストールし、クライアントを再起動して更新された環境を起動してください。

レジストリに複数のCapSolverの結果が表示される

レジストリ検索APIは、同じサーバーの複数の公開バージョンを返す可能性があります。isLatestがtrueのレコードを選択するか、結果数を一意性のチェックとして扱わず、正確なバージョンエンドポイントを照会してください。

クライアントは接続するが解決リクエストが失敗する

接続問題とタスク問題を分離してください。まずツールの検出とget_balanceを確認し、その後タスクタイプ、ウェブサイトURL、サイトキー、オプションのフィールド、アカウント残高をCapSolverドキュメントと照合してください。

操作および責任ある利用制限

CapSolver MCPはローカルツールインターフェースであり、ターゲットの自動化を許可するものではありません。所有しているまたはテスト・自動化を許可されたウェブサイトやシステムでのみ使用してください。適用可能な利用規約、プライバールール、レートリミット、データ保持ルールに従ってください。

オフィシャルレジストリはパブリッシャー制御のメタデータとパッケージ場所を確認しますが、それ自体があなたのセキュリティレビューを置き換えるものではありません。CapSolver MCPソースリポジトリを確認し、変更プロセスでバージョンをピン止めし、APIキーを保護し、広範な展開前にアップデートをテストしてください。

単一のクライアントを超えるアーキテクチャの決定については、エンタープライズAIエージェントチームが認可されたチャレンジ処理を構造化する方法を参照し、サービス境界を設計する際にはAPIエンドポイントの定義を確認してください。

結論

オフィシャルMCPレジストリは現在、CapSolver MCPの標準的で検索可能な記録を提供しており、PyPIは実行可能なPythonパッケージを供給しています。信頼性のあるセットアップは以下の手順に従います: レジストリIDを確認し、CLIを実行し、CAPSOLVER_API_KEYをクライアント環境に追加し、クライアントを再起動し、認可されたタスクを試行する前にツール検出を確認してください。

CapSolverを使用して、サポートされているAIエージェントおよびブラウザ自動化ワークフローにドキュメント化されたCAPTCHA解決ツールを追加してください。

CapSolverで信頼性のある自動化ワークフローを構築する

アカウントを作成し、APIキーを安全に保管し、所有または自動化を許可されたウェブサイトやシステムで制限付きテストを開始してください。CapSolver FAQは、本番環境への統合を進める前に一般的な製品およびアカウントの質問をカバーしています。

FAQ

Q: CapSolver MCPはオフィシャルMCPレジストリに掲載されていますか？

はい。レジストリ名はio.github.capsolver-ai/capsolver-mcpで、バージョン0.1.3は現在アクティブで最新リリースとしてマークされています。

Q: レジストリからインストールするとホストされたリモート接続が作成されますか？

いいえ。現在のレジストリエントリは、uvxを介してローカルで起動されるPyPIパッケージを記述しており、CapSolverホストのリモートMCPエンドポイントを宣伝していません。

Q: capsolver-mcpをグローバルにインストールする必要がありますか？

いいえ。uvx capsolver-mcpは隔離された環境でツールを実行し、チームが独自の仮想環境を管理する場合、明示的なpip installが利用可能です。

Q: なぜクライアントは接続するがブラウザツールを表示しないのですか？

ブラウザツールにはcapsolver-mcp[browser]エクストラとPlaywright Chromiumのインストールが必要です。両方のコンポーネントをインストールした後、クライアントを再起動してください。

Q: CapSolver MCPに必要な環境変数は何ですか？

CapSolver MCPにはCAPSOLVER_API_KEYが必要です。クライアント環境を通じて渡し、実際の値をソースコードやサポートスクリーンショットに含めないでください。

Q: どのウェブサイトでもCapSolver MCPを使用できますか？

いいえ。CapSolver MCPは所有しているまたはテスト・自動化を許可されたウェブサイトやシステムでのみ使用してください。適用可能な利用規約、プライバールール、および法的要件に従ってください。