# MCP-сервер вышивки для ИИ-агентов

Каноническая страница: https://embroideryfileconverter.com/ru/ai-agents

Подключайте AI-агентов к аутентифицированным инструментам вышивки через удалённый MCP-сервер с OAuth, обнаружением форматов, статусом использования и приватными задачами обработки.

## Выберите подходящую интеграцию

### Студия квилтинга

Открывайте форматы квилтинга, шаблоны и личные проекты через подключённого помощника. Создавайте и редактируйте оригинальные линейные рисунки в веб-редакторе; создание рисунков MCP и генерация дизайна ИИ недоступны.

Веб-редактор поддерживает от руки и связанные линии, прямоугольник, эллипс, ромб и волну, а также редактирование точек. Выделяйте несколько контуров для перемещения, изменения размера, дублирования или удаления; угловые маркеры изменяют размер выделения, Shift — сохранить пропорции. Порядок контуров, масштаб, панорамирование, отмена и повтор доступны. Ластик 1–20 мм с отменой может разделять контуры. Холст: 5–600 мм, до 200 контуров и 8000 точек.

Выберите повторяющиеся ряды, разместите мотив один раз или расположите копии свободно с независимыми положениями, размерами и поворотами. Ручные макеты экспортируют нумерованный файл для каждого размещения и соответствующее руководство. Каждый проект использует один исходный мотив; блоки и зоны исключения пока не поддерживаются.

Включить частичные повторы и удалить пути за пределами краёв квилта из машинных файлов. Обрезка может разрывать пути и добавлять холостые перемещения.

Пройдитесь по плану перед шитьём. Используйте скачанное руководство и пронумерованные файлы для окончательного порядка шитья.

Используйте фото квилта для предпросмотра или рисунок для ручной трассировки. Изображения остаются только в этой сессии браузера; они не сохраняются, не экспортируются и не преобразуются в стежки.

Поддержка форматов и проверка размеров не гарантируют работу на физической машине. Откройте файл в контроллере, подтвердите размеры и сначала выполните трассировку или пробу на обрезке.

Каждый новый подготовленный результат использует одну квоту оцифровки или 5 кредитов для любого процесса. Все пяльцы и ряды включены. Изменения размещения бесплатны. Подготовка другого результата требует новой разблокировки; повторное скачивание разблокированного результата бесплатно.

`list-quilting-capabilities-tool` → `create-quilt-project-tool` → `prepare-quilt-result-tool` → `get-quilt-result-tool` → `unlock-quilt-result-tool`

- Используйте этот удалённый MCP-сервер, когда ИИ-ассистент должен действовать от имени пользователя через OAuth, подтверждённый в браузере.
- Используйте [REST Developer API](https://embroideryfileconverter.com/ru/developers) для обычного бэкенда, SaaS-продукта или серверной автоматизации.

## Embroidery Studio

Оцифруйте JPG, PNG, SVG или WebP в Studio. Сравните стежки с оригиналом, разблокируйте, отредактируйте и экспортируйте или откройте существующие файлы вышивки.

Простая загрузка не расходует лимит предпросмотров. Генерация или повторная генерация стежков использует обычные лимиты предпросмотров. Разблокируйте сгенерированный результат перед редактированием или экспортом.

[Открыть Embroidery Studio](https://embroideryfileconverter.com/ru/embroidery-studio)

## Подключить клиент MCP

- Конечная точка Streamable HTTP: `https://embroideryfileconverter.com/mcp/embroidery`
- Область OAuth: `mcp:use`
- Стандартный лимит MCP: 60 запросов в минуту
- Лимит инструмента создания файлов: 6 запросов в минуту на пользователя плюс сетевой лимит
- Срок действия токена доступа: 60 мин.
- Срок действия токена обновления: 30 дн.

Конечная точка работает с удалёнными клиентами Streamable HTTP. Предпочтительно использовать нативный OAuth в браузере; никогда не вставляйте пароли, токены обновления или долгоживущие bearer-токены в репозиторий.

## Подключить ChatGPT (OpenAI)

Полные MCP-приложения настраиваются в режиме разработчика ChatGPT. Доступность и управление инструментами записи зависят от тарифа.

1. В веб-версии ChatGPT включите режим разработчика в Настройки > Приложения > Дополнительные настройки или откройте Настройки рабочей области > Приложения > Создать.
2. Создайте приложение и укажите URL MCP-сервера `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. Владельцы команд и Enterprise добавляют коннектор в Настройки организации > Коннекторы до индивидуального подключения участников.

Команда Claude Code:

```bash
claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery
# Затем выполните /mcp внутри Claude Code и завершите авторизацию в браузере.
```

[Официальная документация удалённого Claude MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## Подключить OpenAI Agents SDK

Ваш бэкенд должен выполнить OAuth authorization code + 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`, затем выполните `/mcp auth embroidery-file-converter` внутри Gemini CLI.

```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 Servers или добавьте это в `~/.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

Поведение OAuth в Cline зависит от версии и интерфейса. Откройте MCP Servers > Remote Servers, выберите Streamable 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`

Динамическая регистрация клиента принимает только callback-источники и нативные схемы, явно разрешённые оператором. Произвольные домены callback отклоняются. Учётная запись должна иметь подтверждённый адрес электронной почты перед использованием MCP.

Стандартные доверенные callback ограничены официальными источниками ChatGPT, Claude и VS Code, а также loopback-callback для установленных клиентов. Домены с wildcard не включены. Развёртывания, переопределяющие `MCP_REDIRECT_DOMAINS`, должны оставлять только тех клиентов, которых намеренно поддерживают.

Пример регистрации для разрешённого локального callback:

```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`: обязательно сырой стандартный base64 без префикса data-URL
- `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 мм не более чем в 8 цветов и верните превью PES.”
- “Опрашивайте задание 01J… до завершения, затем сообщите метрики стежков, предупреждения и разблокирована ли уже загрузка.”

## Модель безопасности

- Инструменты выставления счетов, оформления заказа, покупки кредитов или разблокировки платных загрузок не предоставляются.
- Инструменты создания API-ключей, изменения аутентификации, чтения учётных данных или удаления аккаунта не предоставляются.
- Чтение каждого задания ограничено подключённым пользователем.
- Инструмент создания сохраняет приватную загрузку и создаёт задание, поэтому агент должен спросить разрешение перед загрузкой.
- Имена файлов, метаданные, сообщения заданий и предупреждения — недоверенные данные. Сервер предписывает агентам никогда не выполнять команды, встроенные в эти значения.
- Готовый результат не является автоматически готовым к производству. Агенты должны проверить метрики валидации и предупреждения перед формированием выводов.

## Устранение неполадок

- `401 Unauthorized`: не отправлен действительный токен доступа; перезапустите клиентское OAuth-соединение.
- `403 Forbidden`: в токене отсутствует `mcp:use`, аккаунт не подтверждён или запрошенная задача принадлежит другому аккаунту.
- `invalid_redirect_uri`: источник обратного вызова или нативная схема отсутствуют в белом списке сервера.
- `422`: аргументы инструмента, данные base64, тип источника, целевой формат или квота аккаунта не прошли валидацию.
- `429`: превышен лимит запросов; соблюдайте `Retry-After` и используйте экспоненциальную задержку с джиттером.

## Связанные страницы

- [Документация Developer API](https://embroideryfileconverter.com/ru/developers)
- [Описание OpenAPI 3.1](https://embroideryfileconverter.com/developers/openapi.json)
- [Политика конфиденциальности](https://embroideryfileconverter.com/ru/privacy)