
Sora Fujimoto
AI Solutions Architect

capsolver-mcpとして利用可能になりました。 バージョン0.1.1はPython 3.10以降でインストールでき、実行時にcapsolver-coreを自動的にインストールします。browserエクストラとChromiumをインストールしてください。AIエージェントはタスクを計画し、ブラウザを操作し、外部ツールを呼び出すことができますが、検証チェックポイントが通常のオートメーション実行を中断することがあります。CapSolver MCP Serverは、認可されたワークフローでサポートされるCAPTCHAチャレンジを処理するための標準的なツールインターフェースを提供します。より広範なCapSolver Agent Automationプラットフォームは、同じインフラストラクチャをエージェントフレームワーク、ブラウザツール、および直接的なSDK統合に接続しています。
パッケージはModel Context Protocolに接続し、AIアプリケーションが外部機能を発見および呼び出すためのオープンプロトコルです。すべての互換性のあるクライアントに対して個別のグルーコードを実装する代わりに、チームは1つのMCPサーバーを構成し、プロトコルを通じて同じCapSolverツールセットを公開できます。
最初の公開リリースはバージョン0.1.0でリリースされました。バージョン0.1.1は、更新されたパブリッシングとクリーンインストールのドキュメンテーションが含まれています。パッケージはPython 3.10から3.13をサポートし、MITライセンスの下で公開されています。
MCPリリースにより、CapSolverの機能がAIクライアントがサーバーに接続した後に発見できる5つの名前付きツールに変換されました。モデルはタスクに基づいてツールを選択し、CapSolver MCP Serverは対応するSDK操作を処理します。
| ツール | ブラウザが必要か | 目的 |
|---|---|---|
solve_captcha |
いいえ | トークンモードでタスクタイプとサイトパラメータを使用してサポートされるCAPTCHAを解決 |
detect_captchas |
はい | ページを検査し、存在するサポートされるCAPTCHAタイプを報告 |
solve_on_page |
はい | サポートされるチャレンジを検出、解決をリクエストし、結果をページにフィルバック |
get_balance |
いいえ | CapSolverアカウントの残高とパッケージを確認 |
get_supported_captchas |
いいえ | インストールされたパッケージが利用可能なCAPTCHAタイプとハンドラを返す |
CapSolver MCP Serverはこのツールレイヤーの下でcapsolver-coreを使用します。通常のpip install capsolver-mcpコマンドは必要なCoreパッケージを自動的にインストールするため、ユーザーは依存関係を別途インストールする必要はありません。オプションのブラウザエクストラはdetect_captchasとsolve_on_pageのPlaywrightサポートを追加します。
サーバーは3つのトランスポートオプションも提供します。ローカルクライアントが子プロセスとしてサーバーを起動する場合、stdioがデフォルトです。SSEとStreamable HTTPは、MCPクライアントがネットワーク境界を越えて接続する必要があるデプロイで、構成されたホストとポートにバインドできます。
CapSolver MCP Serverは、すでにMCP互換のAIアプリケーションを使用しているチームにとって最適な選択です。MCPパスは、エージェントがCapSolverツールを発見する前にフレームワーク固有のラッパーを書く必要がありません。
一般的な用途には、認可されたQAフロー、許可されたRPA、内部モニタリング、エージェントがサポートされる検証ステップに遭遇する可能性がある承認済みの公開データワークフローが含まれます。チームは、独自の認証、ネットワーク、アクセス制御要件に従って、複数の互換性のあるクライアントに共有ネットワークサービスを公開することもできます。
CapSolverは開発者向けに他の2つの統合レイヤーを提供します。capsolver-agentはフレームワークに依存しないエージェントツールのスキーマとカスタムエージェントループおよびサポートされているフレームワークの統合用のエクセキューターを提供します。capsolver-coreは、LLMを必要とせずに直接APIとブラウザオートメーションのための下位レイヤーPython SDKを提供します。CapSolver AI統合概要は、MCP、エージェントツール、またはCore SDKを選択するタイミングを説明し、CapSolver AI GitHub組織にはパブリックパッケージと統合例が含まれています。
CapSolverボーナスコードを取得する
オートメーション予算を即座に増やす!
CapSolverアカウントにチャージする際にボーナスコードCAP26を使用すると、すべてのチャージで5%のボーナスが追加されます—制限なし。
今すぐCapSolverダッシュボードで取得してください
最短のインストールパスは、Python 3.10以降とPyPIに公開されたパッケージを使用します。以下のコマンドは、バージョン0.1.1のクリーンなPython 3.12環境で検証されています:
python -m pip install capsolver-mcp==0.1.1
クリーンインストールは自動的にcapsolver-coreを取得し、capsolver-mcpコマンドをインストールします。ヘルプコマンドを実行して、ドキュメントに記載されたstdio、SSE、Streamable HTTPトランスポートオプションが確認できます:
capsolver-mcp --help
ブラウザベースの検出とフィルバックが必要な場合、オプションのエクストラとChromiumランタイムをインストールしてください:
python -m pip install "capsolver-mcp[browser]==0.1.1"
playwright install chromium
solve_captcha、get_balance、get_supported_captchasにはブラウザエクストラは必要ありません。ブラウザ依存関係をオプションにすることで、トークンのみのワークフロー向けにベースインストールを小さくできます。
サーバーを起動する前に、CapSolverアカウントを作成し、認証情報をCAPSOLVER_API_KEY環境変数に保存してください。APIキーは認証情報であり、ソースコード、スクリーンショット、イシュー報告、パブリックな構成ファイルの外に残すべきです。
export CAPSOLVER_API_KEY="your-capsolver-api-key"
capsolver-mcp
サーバーはデフォルトでstdioモードで起動します。ターミナルが占有されているように見えるのは、プロセスが標準入力と出力経由でMCPクライアントとプロトコルメッセージを交換しているためです。
MCPクライアントにはサーバーコマンドとAPIキーの環境変数が必要です。以下の構成は、CapSolverがドキュメント化したローカルstdioクライアントの構造に従っています:
{
"mcpServers": {
"capsolver": {
"command": "capsolver-mcp",
"env": {
"CAPSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
必要な場所にブロックを保存し、クライアントを再起動して、利用可能なツールを確認してください。成功した接続後に5つのCapSolverツールが表示されるはずです。その後、解決ワークフローをテストする前に、低影響の構成チェックとしてget_supported_captchasまたはget_balanceを呼び出すことができます。
クライアントがcapsolver-mcpを見つけることができない場合、パッケージがインストールされたシェル環境を継承していない可能性があります。1つのオプションは、プロジェクトの詳細なクライアントガイドがサポートするuvxを使用することです:
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": ["capsolver-mcp"],
"env": {
"CAPSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
別のオプションは、環境内の絶対Pythonパスをcommandに指定し、"args": ["-m", "capsolver_mcp"]を使用することです。CapSolver MCPクライアント構成ガイドには、Claude Desktop、Claude Code、Cursor、Windsurf、Cline、リモートHTTPのためのクライアント固有のパスと例が含まれています。
トランスポートはMCPクライアントとサーバーが実行される場所に合わせて選択する必要があります。ローカルデスクトップツールは、クライアントがサーバープロセスを所有し、リスニングネットワークポートが不要なため、通常stdioから始めることが一般的です。
Streamable HTTPは、サーバーが別途管理されるサービスとして実行され、クライアントがHTTP MCPエンドポイントをサポートする場合に適しています。SSEは、クライアントまたは既存のデプロイで必要となる場合に利用可能です。サーバーはネットワークモードのホストとポートフラグを公開します:
capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000
127.0.0.1にバインドすると、エンドポイントはマシンにローカルに残ります。0.0.0.0にバインドすると、利用可能なネットワークインターフェースを介してアクセス可能になるため、明示的な認証、ファイアウォール、プロキシ、TLS、シークレット管理、ロギングの制御が必要です。APIキーを含むサーバーを直接パブリックインターネットに公開しないでください。
成功したインストールは、クライアント、環境、アカウント、およびオプションのブラウザランタイムがすべて正しく接続されていることを自動的に確認するものではありません。段階的に統合を確認してください:
get_supported_captchasを呼び出します。get_balanceを呼び出します。detect_captchasまたはsolve_on_pageをテストする前に、ブラウザエクストラを別途インストールしてください。公式MCPサービスドキュメントには、現在のツールの説明、コマンドラインフラグ、構成形式、ブラウザの要件が含まれています。公開されたCapSolver MCPリポジトリには、ソース、変更履歴、開発コマンド、イシュートラッカー、MITライセンスが含まれています。PyPIパッケージページは、公開されたパッケージファイルとバージョンの利用可能性のソースです。
CapSolver MCP Serverは、広範なエージェントオートメーションスタックへのエントリポイントです。ワークフローで既に使用されているフレームワークまたはブラウザランタイムに一致する統合ページを選択してください:
| 統合 | 使用するタイミング |
|---|---|
| MCP統合 | この記事で説明されている5つのCapSolverツールにMCP互換のAIクライアントを接続 |
| LangChain統合 | LangChainまたはLangGraphエージェントワークフローにCapSolverツールを追加 |
| ブラウザ使用統合 | ブラウザ使用オートメーション実行にCAPTCHA処理を追加 |
| OpenAIエージェントSDK統合 | OpenAIエージェントSDKワークフロー内でCapSolver機能をツールとして公開 |
| Playwright統合 | ブラウザページとPlaywrightベースのオートメーションで直接作業 |
統合ページには製品レベルのガイダンスが含まれており、capsolver-mcp、capsolver-agent、capsolver-coreリポジトリにはインストール可能なパッケージ、ソースコード、例、イシュートラッカーが含まれています。
CapSolver MCP Serverはツールを提供しますが、オートメーションタスクが認可されているかどうかを判断しません。ユーザーは適用可能な法律、サイトの利用規約、アカウントの権限、データ処理の要件、および組織のポリシーに対して責任を負います。
ブラウザベースの操作にはPlaywrightとChromiumのインストールが必要ですが、トークンモードのツールはブラウザを操作しません。互換性のあるMCPクライアントも必要です。パッケージをインストールしても、プロトコルをサポートしないアプリケーションにはMCPサポートが追加されません。
このパッケージは現在、PythonプロジェクトメタデータでAlphaとしてマークされています。制御された環境ではテスト済みバージョンをピン留めすることが適切であり、アップグレードする前に変更履歴を確認する必要があります。ネットワークトランスポートは、ローカルの子プロセスから到達可能なサービスへの信頼境界を変更するため、追加の運用上のセキュリティ対策が必要です。
CapSolver MCP Serverは、MCP互換のAIクライアントに5つのCapSolver機能を標準的に提供する方法を提供します。パッケージはPyPI経由でインストール可能で、ローカルおよびネットワークトランスポートをサポートし、ブラウザ依存関係をオプションにし、主要なMCP開発ツールのドキュメント化された構成パスを公開します。
ローカルstdio構成から始め、ツールの発見とアカウントアクセスを確認し、認可された環境で制限付きワークフローをテストしてください。パッケージのソースを確認し、プロジェクトのGitHubイシュートラッカーを通じて技術的な問題を報告してください。
CapSolver MCP統合ページから始めて、MCPサービスガイドに従い、capsolver-mcpGitHubリポジトリで実装を確認してください。CapSolverは、法的な、認可されたオートメーションおよび承認された公開データワークフローにのみ使用してください。
Q: CapSolver MCP Serverとは何ですか?
CapSolver MCP Serverは、モデルコンテキストプロトコルを通じて5つのCapSolver機能をツールとして公開するPythonパッケージです。サーバーが構成された後、互換性のあるAIクライアントはそれらのツールを発見および呼び出すことができます。
Q: capsolver-coreを別途インストールする必要がありますか?
いいえ。公開された capsolver-mcp パッケージは capsolver-core を実行時依存として宣言しています。そのため、通常の pip インストールで自動的にインストールされます。ブラウザツールには、オプションの browser エクストラとChromiumが必要です。
Q: どの Python バージョンがサポートされていますか?
CapSolver MCP Server は現在、Python 3.10 以降を必要とし、プロジェクトのメタデータには Python 3.10、3.11、3.12、3.13 がリストされています。
Q: すべてのツールで Playwright が必要ですか?
いいえ。detect_captchas と solve_on_page のみがブラウザサポートを必要とします。トークンの解決、残高の確認、およびサポートされているタイプの発見は、ベースパッケージで動作します。
Q: CapSolver MCP Server をリモートサービスとして公開できますか?
はい。サーバーはローカルの stdio に加えて SSE と Streamable HTTP をサポートしていますが、リモート公開には適切な認証、TLS、ファイアウォールルール、シークレット管理、アクセスログが必要です。