CaptchaSonic **agent-native** है। कोई भी AI एजेंट हमारे **MCP सर्वर** के ज़रिए CAPTCHA हल कर सकता है, और यह दो तरीकों से उपलब्ध है:

- **होस्टेड:** `https://mcp.captchasonic.com`, बेयरर टोकन के रूप में आपकी API key के साथ। कुछ इंस्टॉल नहीं करना होता। अनुशंसित।
- **स्थानीय:** `npx -y @captchasonic/mcp-server` stdio पर, उन क्लाइंट्स के लिए जो केवल स्थानीय सर्वर समर्थित करते हैं।

दोनों में एक ही पाँच टूल हैं: `solve_token_captcha`, `solve_image_captcha`, `get_task_result`, `get_balance` और `list_captcha_types`। हर क्लाइंट के लिए [MCP Get Started guide](/docs/mcp/get-started) से शुरू करें, या नीचे दिए एजेंट-वार नोट्स पढ़ें। यदि आपका एजेंट MCP नहीं बोल सकता, तो इसके बजाय [direct SDK](#without-mcp-direct-sdk) का उपयोग करें।

## एजेंट के लिए Golden Path

इसे किसी भी एजेंट में डालें, और वह एक ही राउंड ट्रिप में CAPTCHA हल कर सकता है:

```bash
# Claude Code (or any MCP client): add the hosted server once
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
# Or, with no MCP — the same lifecycle via curl (replace TASK_ID after createTask):
curl -s https://api.captchasonic.com/createTask -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","taskId":"TASK_ID"}'
```

> [!TIP]
> किसी एजेंट को [MCP for AI Agents](/docs/mcp/for-agents) की ओर इंगित करें। इसमें बताया गया है कि sitekeys कैसे खोजें, सही टूल कैसे चुनें और टोकन कैसे सबमिट करें, ताकि एजेंट बिना अतिरिक्त निर्देशों के काम कर सके।

---

## Claude Code

होस्टेड सर्वर जोड़ें:

```bash
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
```

स्थानीय रूप से चलाना पसंद है? `claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server` stdio पर वही टूल देता है।

### Claude skill plugin (अनुशंसित)

निर्देशित वर्कफ़्लो के लिए आधिकारिक **CaptchaSonic skill plugin** इंस्टॉल करें। इसमें तीन Claude skills शामिल हैं और यह `SONIC_API_KEY` एनवायरनमेंट वेरिएबल का उपयोग करके होस्टेड MCP सर्वर से जुड़ता है। अपनी key एक्सपोर्ट करें, Claude Code शुरू करें, फिर चलाएँ:

```bash
/plugin marketplace add Captcha-Sonic/Agent-skills
/plugin install captchasonic
```

इसके बाद तीन skills सामान्य वर्कफ़्लो में एजेंट का मार्गदर्शन करती हैं:

- **`captchasonic-setup`** — पहली बार MCP सेटअप और सत्यापन।
- **`captchasonic-solve`** — किसी भी CAPTCHA प्रकार को चरण-दर-चरण मार्गदर्शन के साथ हल करें।
- **`captchasonic-balance`** — खाते का बैलेंस और क्रेडिट स्थिति जाँचें।

> [!TIP]
> सॉल्व के किसी बैच से पहले `get_balance` (या `captchasonic-balance` skill) को गार्ड के रूप में उपयोग करें, ताकि क्रेडिट कम होने पर एजेंट जल्दी रुक सके।

---

## Antigravity

Antigravity की MCP कॉन्फ़िगरेशन में CaptchaSonic को स्थानीय stdio सर्वर के रूप में रजिस्टर करें:

```json
{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}
```

Antigravity के MCP सर्वर रीलोड करें, और CaptchaSonic के टूल एजेंट की टूल सूची में दिखेंगे।

---

## Cursor

**Settings → MCP** खोलें (या `~/.cursor/mcp.json` संपादित करें) और होस्टेड सर्वर जोड़ें:

```json
{
  "mcpServers": {
    "captchasonic": {
      "url": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

---

## Windsurf

**Settings → Cascade → MCP Servers** खोलें (या `~/.codeium/windsurf/mcp_config.json` संपादित करें):

```json
{
  "mcpServers": {
    "captchasonic": {
      "serverUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

---

## Generic MCP

कोई भी MCP क्लाइंट जो रिमोट सर्वर समर्थित करता है: `https://mcp.captchasonic.com` को Streamable HTTP transport और `Authorization: Bearer sonic_xxx` हेडर के साथ उपयोग करें। VS Code, Codex और Gemini CLI की कॉन्फ़िगरेशन [Get Started guide](/docs/mcp/get-started) में हैं।

जो क्लाइंट केवल स्थानीय सर्वर चलाते हैं, वे मानक stdio ब्लॉक लें (देखें [Run locally](/docs/mcp/run-locally)):

```json
{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}
```

---

## n8n

CaptchaSonic के पास एक **सत्यापित n8n community node** है ([n8n.io listing](https://n8n.io/integrations/captchasonic/)), जो 20+ CAPTCHA प्रकारों को ड्रैग-और-ड्रॉप वर्कफ़्लो नोड्स में लपेटता है। यह स्टैंडअलोन नोड और n8n के AI Agent नोड के लिए टूल, दोनों के रूप में काम करता है।

→ **[पूरी n8n Integration Guide](/docs/integrations/n8n)** — चरण-दर-चरण इंस्टॉलेशन, क्रेडेंशियल सेटअप, 4 वर्कफ़्लो रेसिपी, प्रति-CAPTCHA-प्रकार कॉन्फ़िगरेशन, एरर हैंडलिंग पैटर्न और समस्या-निवारण।

**त्वरित इंस्टॉल:** Settings → Community Nodes → `n8n-nodes-captchasonic` इंस्टॉल करें → अपनी API key के साथ CaptchaSonic क्रेडेंशियल बनाएँ → हो गया।

---

## MCP के बिना (सीधा SDK)

यदि आपका एजेंट MCP का उपयोग नहीं कर सकता, तो SDK को सीधे कॉल करें। टोकन-प्रकार का CAPTCHA एक ही फ़ंक्शन कॉल है।

<LangTabs>
  <LangTabs.Tab label="Python">

<Snippet sdk="python" region="solveTurnstile" />

  </LangTabs.Tab>
  <LangTabs.Tab label="Node">

<Snippet sdk="typescript" region="solveTurnstile" />

  </LangTabs.Tab>
</LangTabs>

पूरी मेथड सूची के लिए [Python SDK](/docs/clients-sdks/python) और [Node.js SDK](/docs/clients-sdks/nodejs) पेज देखें, या कच्चे तीन-कॉल लाइफ़साइकिल के लिए [REST API reference](/docs/api) देखें।
