# AI एजेंट्स के लिए कढ़ाई MCP सर्वर

कैनोनिकल पेज: https://embroideryfileconverter.com/hi/ai-agents

OAuth, फ़ॉर्मेट खोज, उपयोग स्थिति और निजी प्रोसेसिंग जॉब्स वाले रिमोट MCP सर्वर के माध्यम से AI एजेंट्स को प्रमाणित कढ़ाई टूल्स से कनेक्ट करें।

## सही एकीकरण चुनें

- इस रिमोट MCP सर्वर का उपयोग तब करें जब कोई AI सहायक ब्राउज़र-अनुमोदित OAuth के माध्यम से उपयोगकर्ता की ओर से कार्य करे।
- पारंपरिक बैकएंड, SaaS उत्पाद, या सर्वर-साइड स्वचालन के लिए [REST डेवलपर API](https://embroideryfileconverter.com/hi/developers) का उपयोग करें।

## MCP क्लाइंट कनेक्ट करें

- स्ट्रीम करने योग्य HTTP एंडपॉइंट: `https://embroideryfileconverter.com/mcp/embroidery`
- OAuth स्कोप: `mcp:use`
- डिफ़ॉल्ट MCP दर सीमा: 60 अनुरोध प्रति मिनट
- फ़ाइल-निर्माण टूल सीमा: प्रति उपयोगकर्ता 6 अनुरोध प्रति मिनट, साथ ही नेटवर्क सीमा
- एक्सेस टोकन जीवनकाल: 60 मिनट
- रिफ्रेश टोकन जीवनकाल: 30 दिन

एंडपॉइंट रिमोट स्ट्रीमेबल HTTP क्लाइंट्स के साथ काम करता है। मूल ब्राउज़र OAuth को प्राथमिकता दें; कभी भी पासवर्ड, रिफ्रेश टोकन, या लंबे समय तक चलने वाले बियरर टोकन को रिपॉजिटरी में पेस्ट न करें।

## ChatGPT (OpenAI) कनेक्ट करें

पूर्ण MCP ऐप्स ChatGPT डेवलपर मोड में कॉन्फ़िगर किए जाते हैं। उपलब्धता और राइट-टूल नियंत्रण प्लान के अनुसार भिन्न होते हैं।

1. ChatGPT वेब में, सेटिंग्स > ऐप्स > उन्नत सेटिंग्स में डेवलपर मोड सक्षम करें, या वर्कस्पेस सेटिंग्स > ऐप्स > बनाएँ खोलें।
2. एक ऐप बनाएँ और MCP सर्वर URL को `https://embroideryfileconverter.com/mcp/embroidery` पर सेट करें।
3. OAuth चुनें, स्कैन टूल्स चुनें, और ब्राउज़र में `mcp:use` स्कोप स्वीकृत करें।
4. ड्राफ्ट ऐप बनाएँ, इसे सक्षम करें, और नई बातचीत में टूल्स मेनू से चुनें।

[आधिकारिक ChatGPT MCP दस्तावेज़](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

## Claude, Claude Desktop, Cowork, या Claude Code कनेक्ट करें

Claude में, कस्टमाइज़ > कनेक्टर्स > कस्टम कनेक्टर जोड़ें खोलें, `https://embroideryfileconverter.com/mcp/embroidery` दर्ज करें, कनेक्ट चुनें, और OAuth पूरा करें। टीम और एंटरप्राइज़ स्वामी सदस्यों द्वारा व्यक्तिगत रूप से कनेक्ट करने से पहले संगठन सेटिंग्स > कनेक्टर्स के अंतर्गत कनेक्टर जोड़ते हैं।

Claude Code कमांड:

```bash
claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery
# फिर Claude Code के अंदर /mcp चलाएँ और ब्राउज़र प्राधिकरण पूरा करें।
```

[आधिकारिक Claude रिमोट MCP दस्तावेज़](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## OpenAI Agents SDK कनेक्ट करें

आपके बैकएंड को अपने साइन-इन उपयोगकर्ता के लिए OAuth प्राधिकरण कोड + PKCE पूरा करना होगा, टोकन को सर्वर पर एन्क्रिप्टेड स्टोर करना होगा, आवश्यकता पड़ने पर उन्हें रिफ्रेश करना होगा, और वर्तमान एक्सेस टोकन को होस्ट किए गए MCP टूल को पास करना होगा। इस टोकन को कभी भी ब्राउज़र JavaScript में एक्सपोज़ न करें।

```typescript
import { Agent, hostedMcpTool } from '@openai/agents';

const agent = new Agent({
  name: 'Embroidery assistant',
  tools: [
    hostedMcpTool({
      serverLabel: 'embroidery',
      serverUrl: 'https://embroideryfileconverter.com/mcp/embroidery',
      authorization: process.env.EFC_MCP_ACCESS_TOKEN,
      requireApproval: 'always',
    }),
  ],
});
```

[आधिकारिक OpenAI Agents SDK MCP दस्तावेज़](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

## Cursor कनेक्ट करें

इसे `.cursor/mcp.json` में जोड़ें, Cursor सेटिंग्स > MCP में सर्वर शुरू करें, और OAuth पूरा करें। Cursor Agent उपयोगकर्ता `cursor-agent mcp login embroidery-file-converter` चला सकते हैं।

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[आधिकारिक Cursor MCP दस्तावेज़](https://docs.cursor.com/context/model-context-protocol)

## VS Code और GitHub Copilot कनेक्ट करें

`MCP: Add Server` चलाएँ और HTTP चुनें, या इसे `.vscode/mcp.json` में जोड़ें। `MCP: List Servers` से शुरू करें, कॉन्फ़िगरेशन पर विश्वास करें, और ब्राउज़र प्राधिकरण पूरा करें।

```json
{
  "servers": {
    "embroidery-file-converter": {
      "type": "http",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[आधिकारिक VS Code MCP दस्तावेज़](https://code.visualstudio.com/docs/agent-customization/mcp-servers)

## OpenClaw कनेक्ट करें

```bash
openclaw mcp add embroidery-file-converter \
  --url https://embroideryfileconverter.com/mcp/embroidery \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope mcp:use

openclaw mcp login embroidery-file-converter
openclaw mcp doctor embroidery-file-converter --probe
```

[आधिकारिक OpenClaw MCP दस्तावेज़](https://docs.openclaw.ai/cli/mcp)

## Gemini CLI कनेक्ट करें

सर्वर को `~/.gemini/settings.json` में जोड़ें, फिर Gemini CLI के अंदर `/mcp auth embroidery-file-converter` चलाएँ।

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[आधिकारिक Gemini CLI MCP दस्तावेज़](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)

## OpenCode कनेक्ट करें

इसे `opencode.json` में जोड़ें, फिर `opencode mcp auth embroidery-file-converter` चलाएँ और `opencode mcp list` से सत्यापित करें।

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "embroidery-file-converter": {
      "type": "remote",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[आधिकारिक OpenCode MCP दस्तावेज़](https://opencode.ai/docs/mcp-servers/)

## Windsurf Cascade कनेक्ट करें

Windsurf सेटिंग्स > Cascade > MCP सर्वर्स खोलें, या इसे `~/.codeium/windsurf/mcp_config.json` में जोड़ें। सर्वर शुरू करें, OAuth पूरा करें, और केवल आवश्यक टूल्स सक्षम करें।

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "serverUrl": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[आधिकारिक Windsurf MCP दस्तावेज़](https://docs.windsurf.com/windsurf/cascade/mcp)

## Cline कनेक्ट करें

Cline का OAuth व्यवहार रिलीज़ और सरफेस के अनुसार भिन्न होता है। MCP सर्वर्स > रिमोट सर्वर्स खोलें, स्ट्रीमेबल HTTP चुनें, और खाली अनुमोदन अनुमति-सूची के साथ इस कॉन्फ़िगरेशन का उपयोग करें:

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "type": "streamableHttp",
      "url": "https://embroideryfileconverter.com/mcp/embroidery",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

यदि इंस्टॉल किया गया Cline रिलीज़ OAuth पूरा नहीं कर पाता, तो समीक्षित और संस्करण-पिन्ड OAuth ब्रिज का उपयोग करें, या मूल OAuth वाले क्लाइंट को चुनें। `cline_mcp_settings.json` में लंबे समय तक चलने वाला टोकन कमिट न करें।

[आधिकारिक Cline MCP दस्तावेज़](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx)

## OAuth खोज और PKCE

- संरक्षित-संसाधन मेटाडेटा: `https://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery`
- प्राधिकरण-सर्वर मेटाडेटा: `https://embroideryfileconverter.com/.well-known/oauth-authorization-server`
- डायनामिक क्लाइंट पंजीकरण: `https://embroideryfileconverter.com/oauth/register`
- प्राधिकरण सर्वर जारीकर्ता: `https://embroideryfileconverter.com`
- अनुदान: प्राधिकरण कोड
- PKCE विधि: S256
- आवश्यक स्कोप: `mcp:use`

डायनामिक क्लाइंट पंजीकरण केवल ऑपरेटर द्वारा स्पष्ट रूप से अनुमत कॉलबैक मूल और मूल योजनाएँ स्वीकार करता है। मनमाने कॉलबैक डोमेन अस्वीकृत कर दिए जाते हैं। MCP एंडपॉइंट का उपयोग करने से पहले खाते का सत्यापित ईमेल पता होना चाहिए।

डिफ़ॉल्ट विश्वसनीय होस्टेड कॉलबैक आधिकारिक ChatGPT, Claude, और VS Code मूलों तक सीमित हैं, साथ ही इंस्टॉल किए गए क्लाइंट्स के लिए लूपबैक कॉलबैक। वाइल्डकार्ड रीडायरेक्ट डोमेन सक्षम नहीं हैं। `MCP_REDIRECT_DOMAINS` को ओवरराइड करने वाले परिनियोजन केवल उन क्लाइंट्स को बनाए रखें जिन्हें वे जानबूझकर समर्थन करते हैं।

अनुमत स्थानीय कॉलबैक के लिए उदाहरण पंजीकरण:

```bash
curl -X POST https://embroideryfileconverter.com/oauth/register \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_name": "Your local agent",
    "redirect_uris": ["http://127.0.0.1:49831/callback"]
  }'
```

## पूर्ण टूल संदर्भ

### `list-formats-tool`

केवल पढ़ने के लिए। कोई तर्क नहीं लेता। `artwork_inputs[]` और `formats[]` लौटाता है जिसमें readable, writable, label और warning फ़ील्ड्स होते हैं। वर्कफ़्लो या लक्ष्य फ़ॉर्मेट चुनने से पहले इसे कॉल करें।

### `get-account-usage-tool`

केवल पढ़ने के लिए। कोई तर्क नहीं लेता। वर्तमान पूर्वावलोकन भत्ता, क्रेडिट शेष, वर्कफ़्लो लागत, सदस्यता सीमाएँ और रीसेट तिथियाँ लौटाता है। यह कभी भी कुछ नहीं खरीदता या उपभोग नहीं करता।

### `list-processing-jobs-tool`

केवल पढ़ने के लिए। कनेक्टेड खाते के हाल के जॉब्स की सूची दिखाता है।

- `limit`: 1 से 50 तक वैकल्पिक पूर्णांक; डिफ़ॉल्ट 20

### `get-processing-job-tool`

केवल पढ़ने के लिए। स्थिति, घटनाओं, मेट्रिक्स, चेतावनियों, पूर्वावलोकन आर्टिफैक्ट्स और उपलब्ध OAuth-सुरक्षित फ़ाइल URL के साथ एक स्वामित्व वाला जॉब लौटाता है।

- `workflow`: आवश्यक `conversion` या `digitising`
- `job_id`: आवश्यक 26-अक्षर जॉब पहचानकर्ता

### `create-processing-job-tool`

संग्रहीत डेटा बनाता है। एक निजी पूर्वावलोकन जॉब शुरू करता है और पूर्वावलोकन भत्ता उपभोग कर सकता है, लेकिन यह कभी भी क्रेडिट नहीं खरीदता या सशुल्क डाउनलोड अनलॉक नहीं करता।

- `workflow`: आवश्यक `conversion` या `digitising`
- `file_name`: एक्सटेंशन सहित मूल फ़ाइलनाम आवश्यक, 3 से 255 अक्षर, पथ विभाजक या नियंत्रण वर्णों के बिना
- `file_base64`: डेटा-URL उपसर्ग के बिना कच्चा मानक base64 आवश्यक
- `format`: आवश्यक लोअरकेस लिखने योग्य कढ़ाई आउटपुट
- `width_mm`: 10 से 300 तक संख्या, डिजिटाइजिंग के लिए आवश्यक
- `colour_count`: 1 से 24 तक पूर्णांक, डिजिटाइजिंग के लिए आवश्यक

संरचित परिणाम में `billing_authorized: false` शामिल है। रूपांतरण के लिए, चयनित आउटपुट पता लगाए गए स्रोत फ़ॉर्मेट से भिन्न होना चाहिए।

## JSON-RPC टूल उदाहरण

फ़ॉर्मेट सूचीबद्ध करें:

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
```

डिजिटाइजिंग पूर्वावलोकन बनाएँ:

```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create-processing-job-tool",
    "arguments": {
      "workflow": "digitising",
      "file_name": "logo.png",
      "file_base64": "iVBORw0KGgoAAA...",
      "format": "pes",
      "width_mm": 90,
      "colour_count": 8
    }
  }
}
```

लौटाए गए जॉब का पोल करें:

```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get-processing-job-tool",
    "arguments": {
      "workflow": "digitising",
      "job_id": "01JEXAMPLEJOBID000000000"
    }
  }
}
```

संभावित जॉब स्थितियाँ `queued`, `processing`, `completed` और `failed` हैं। बैकऑफ के साथ पोल करें और टर्मिनल स्थिति पर रुकें। फ़ाइल URL को वही OAuth एक्सेस टोकन चाहिए और अपलोड की `expiresAt` प्रतिधारण तिथि के अधीन रहते हैं।

## उदाहरण प्राकृतिक-भाषा प्रॉम्प्ट

- “जाँचें कौन से फ़ॉर्मेट PES पढ़ सकते हैं और JEF सुरक्षित रूप से लिख सकते हैं। मुझे संगतता चेतावनियाँ दिखाएँ।”
- “मेरी पाँच सबसे हाल की कढ़ाई जॉब्स सूचीबद्ध करें और जो कुछ विफल हुआ उसका सारांश दें।”
- “अपलोड करने से पहले, मुझे पुष्टि करने के लिए कहें। फिर logo.png को 90 mm चौड़ाई पर अधिकतम 8 रंगों के साथ डिजिटाइज करें और PES पूर्वावलोकन लौटाएँ।”
- “जॉब 01J… को पूरा होने तक पोल करें, फिर स्टिच मेट्रिक्स, चेतावनियाँ और क्या डाउनलोड पहले से अनलॉक है, रिपोर्ट करें।”

## सुरक्षा मॉडल

- कोई बिलिंग, चेकआउट, क्रेडिट-खरीद या सशुल्क-डाउनलोड अनलॉक टूल उजागर नहीं है।
- कोई API-कुंजी निर्माण, प्रमाणीकरण परिवर्तन, क्रेडेंशियल-पठन या खाता-हटाने का टूल उजागर नहीं है।
- हर पढ़ा गया जॉब कनेक्टेड उपयोगकर्ता तक सीमित है।
- क्रिएट टूल एक निजी अपलोड संग्रहीत करता है और एक जॉब बनाता है, इसलिए एजेंट को अपलोड करने से पहले पूछने का निर्देश दिया जाता है।
- फ़ाइलनाम, मेटाडेटा, जॉब संदेश और चेतावनियाँ अविश्वसनीय डेटा हैं। सर्वर एजेंट्स को उन मानों में एम्बेडेड कमांड का पालन कभी न करने का निर्देश देता है।
- एक पूर्ण परिणाम स्वचालित रूप से उत्पादन-तैयार नहीं होता। एजेंट्स को दावे करने से पहले सत्यापन मेट्रिक्स और चेतावनियों का निरीक्षण करना चाहिए।

## समस्या निवारण

- `401 Unauthorized`: कोई मान्य एक्सेस टोकन नहीं भेजा गया; क्लाइंट OAuth कनेक्शन पुनः आरंभ करें।
- `403 Forbidden`: टोकन में `mcp:use` की कमी है, खाता सत्यापित नहीं है, या अनुरोधित जॉब दूसरे खाते का है।
- `invalid_redirect_uri`: कॉलबैक मूल या नेटिव स्कीम सर्वर अनुमति-सूची में नहीं है।
- `422`: टूल तर्क, base64 डेटा, स्रोत प्रकार, लक्ष्य फ़ॉर्मेट या खाता कोटा सत्यापन में विफल।
- `429`: दर सीमा पार; `Retry-After` का सम्मान करें और घबराहट के साथ एक्सपोनेंशियल बैकऑफ का उपयोग करें।

## संबंधित पृष्ठ

- [डेवलपर API दस्तावेज़ीकरण](https://embroideryfileconverter.com/hi/developers)
- [OpenAPI 3.1 विवरण](https://embroideryfileconverter.com/developers/openapi.json)
- [गोपनीयता नीति](https://embroideryfileconverter.com/hi/privacy)