Captchas lösen mit
MCP-Agenten
Ein Agent, der auf eine Challenge trifft, hat nichts in seinem Toolset, das sie lösen kann – also bleibt er hängen oder halluziniert sich daran vorbei. Geben Sie ihm einen Solver als Tool, und die Blockade wird zu einem weiteren Aufruf.
# Claude Code
claude mcp add captchano -e CAPTCHANO_API_KEY=cn-YOUR_API_KEY -- npx -y captchano-mcp
# Claude Desktop / Cursor / VS Code (mcpServers config)
{
"mcpServers": {
"captchano": {
"command": "npx",
"args": ["-y", "captchano-mcp"],
"env": {
"CAPTCHANO_API_KEY": "cn-YOUR_API_KEY",
"CAPTCHANO_MAX_SPEND_USD": "1"
}
}
}
}
# Tools: solve_captcha · get_task · get_balance · list_captcha_types
# Source (MIT): https://github.com/DishantSinghDev2/captchano-mcpWarum gerade Agenten das brauchen
Ein Scraper, der auf eine Challenge trifft, scheitert laut, und Sie beheben das Problem. Ein Agent scheitert leise: Er denkt über die blockierte Seite nach, erfindet einen plausiblen nächsten Schritt und meldet Fortschritt, den es nie gab. Der Fehler ist schlimmer, weil er unbemerkt bleibt. Ein typisiertes Solver-Tool macht aus einer unklaren Sackgasse ein deterministisches Ergebnis, auf das der Agent reagieren kann.
Was das Tool zurückgibt
- Ein Token oder Cookie – je nach Challenge-Typ. Sitzungsbasiert bewertende Systeme liefern ein Cookie sowie die Header, mit denen es erhalten wurde.
- Den verwendeten User-Agent, damit der Agent ihn beim Absenden übernehmen kann.
- Die Kosten der Lösung, damit ein Agent mit Budget sie verbuchen kann, statt blind auszugeben.
Die Schleife begrenzt halten
Geben Sie dem Agenten ein Lösungsbudget pro Lauf. Jede Response meldet ihre Kosten, sodass ein Supervisor die Schleife abbrechen kann, wenn die Ausgaben einen Schwellenwert überschreiten – statt es erst auf der Rechnung zu bemerken. Bei $0.00598 pro Lösung kostet ein typischer Agent-Lauf wenige Cent oder weniger, aber eine unbegrenzte Retry-Schleife bleibt eine unbegrenzte Retry-Schleife.
Den Tool-Aufruf blockierend halten
Die Beispiele rufen ?wait=60 auf, sodass das Tool in einem einzigen Schritt ein fertiges Token zurückgibt. Für Agenten ist das wichtiger als für Skripte: Ein Tool, das „wird noch gelöst“ zurückgibt, zwingt das Modell, über Polling nachzudenken – und das kann es schlecht. Brauchen Sie eine höhere Obergrenze, erhöhen Sie wait auf bis zu 120 Sekunden. Die Request-Formate für jeden Challenge-Typ finden Sie in der API-Referenz.
So fügt sich die Lösung in MCP ein
captchano-mcp ist unser Open-Source-MCP-Server: Er stellt das Lösen als Tools bereit, die jeder MCP-Client aufrufen kann. Der Agent räumt ein Captcha also mit einem Tool-Aufruf aus dem Weg und erhält ein Token zurück.
- 01Server hinzufügen
Claude Code: claude mcp add captchano -e CAPTCHANO_API_KEY=cn-… -- npx -y captchano-mcp. Andere Clients nutzen denselben npx-Befehl in ihrer MCP-Konfiguration.
- 02Budget festlegen
Setzen Sie optional CAPTCHANO_MAX_SPEND_USD, damit der Server weitere Lösungen ablehnt, sobald die Sitzung diesen Betrag ausgegeben hat.
- 03Das Modell aufrufen lassen
Sieht der Agent eine Challenge, ruft er solve_captcha mit type, sitekey und URL auf; list_captcha_types sagt ihm, welche Felder jeder Typ braucht.
- 04Token verwenden
Der Agent übergibt das Token an sein Browser-Tool zum Injizieren und Absenden. Lange Lösungen liefern eine Task-ID, die mit get_task abgefragt wird.
So kommt das Token in die Seite
Der Client erhält das Token als Tool-Ergebnis und übergibt es an das Browser-Tool, das die Seite ausfüllt.
Woran Integrationen meistens scheitern
Bewahren Sie den API-Schlüssel in der Umgebung des Servers auf, nie in den Tool-Argumenten, damit das Modell ihn nie sieht.
Behalten Sie wait=60 bei, damit das Tool ein fertiges Token liefert, statt das Modell pollen zu lassen.
FAQ zu Captchas mit MCP
Gibt es ein offizielles CaptchaNo-MCP-Paket?
Ja. captchano-mcp ist unser Open-Source-Server (MIT) auf npm und in der offiziellen MCP Registry. Starten Sie ihn mit npx -y captchano-mcp und Ihrem Schlüssel in CAPTCHANO_API_KEY; der Schlüssel bleibt auf Ihrem Rechner und ist nie ein Tool-Argument.
Mit welchen MCP-Clients funktioniert er?
Mit jedem Client, der MCP-Tools über stdio oder HTTP unterstützt, da der Server nur ein Standard-Tool bereitstellt.
Wie findet der Agent den Sitekey?
Über sein Browser-Tool: Es liest das Attribut data-sitekey oder die URL der Challenge-Seite und übergibt sie an das Solve-Tool.
Kann ich die Ausgaben des Agenten begrenzen?
Ja. Jedes Ergebnis enthält die Kosten, sodass der Server eine laufende Summe führen und weitere Lösungen ab einem Budget ablehnen kann.
Hilfreiche Anleitungen
Bereit zum Loslegen?
Starten Sie mit einer kostenlosen 3-tägigen Testphase und zahlen Sie danach pro erfolgreicher Lösung, wenn Ihr Traffic wächst. Für die Testphase ist keine Karte nötig.