Удалённый MCP · v1.0OAuth 2.1 + PKCE

Предоставьте ИИ-агентам инструменты вышивки.

Подключите ассистентов к обнаружению форматов, использованию аккаунта и приватным заданиям обработки — от имени пользователя, с подтверждением в браузере и без инструментов оплаты или учётных данных.

Конечная точка Streamable HTTP

https://embroideryfileconverter.com/mcp/embroidery

Инструменты

5

Область доступа

mcp:use

Лимит чтения

60/min

Пользователь входит, подтверждает email и разрешает доступ в браузере. Агент получает токен с областью — без пароля пользователя или API-ключа.

Совместимость клиентов

Выберите агента. Скопируйте его настройку.

Используйте руководства ниже для ChatGPT, Claude, OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf и Cline. Каждое руководство указывает, является ли OAuth встроенным, управляемым разработчиком или требует проверенного моста.

Логотип OpenAI
Встроенный OAuthВеб-версия ChatGPT · Настройки → Приложения

Подключить ChatGPT

Создайте пользовательское MCP-приложение в режиме разработчика ChatGPT и позвольте ChatGPT обнаружить инструменты и метаданные OAuth.

  1. 1Включите режим разработчика в Настройках → Приложения → Дополнительные настройки или откройте настройки рабочей области → Приложения → Создать.
  2. 2Создайте приложение, вставьте MCP-эндпоинт и выберите аутентификацию OAuth.
  3. 3Выберите «Сканировать инструменты», подтвердите доступ в браузере, затем создайте и включите черновик приложения.
Официальная документация ChatGPT MCP
Настройка ChatGPT · Параметры подключения
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

Используйте OAuth в браузере и запрашивайте только mcp:use. Никогда не размещайте пароль, refresh-токен или долгоживущий bearer-токен в репозитории.

Полная поддержка инструментов записи предназначена для рабочих пространств ChatGPT Business и Enterprise/Edu. Доступность и административные элементы управления зависят от плана.

Streamable HTTPКод авторизации OAuth + PKCEПриватные данные пользователя

Если клиент не может открыть OAuth

Убедитесь, что он поддерживает удалённые Streamable HTTP MCP-серверы и discovery защищённых ресурсов. Локальный клиент только stdio не может подключиться к этому размещённому эндпоинту без совместимого моста.

Авторизация

Код авторизации OAuth + PKCE.

Сервер публикует метаданные по стандартам, требует S256 PKCE и предоставляет одну область минимальных привилегий. Динамическая регистрация доступна только для разрешённых оператором origins обратных вызовов и нативных схем.

Защищённый ресурс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
Требуемая область доступаmcp:use
Примеры на уровне протокола · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "Your agent",
      "version": "1.0.0"
    }
  }
}

Краткосрочный доступ

Токены доступа истекают через 60 минут. Токены обновления истекают через 30 дней и остаются отзываемыми.

Требуется подтверждённый аккаунт

Действительный токен должен содержать mcp:use, и подключённый пользователь должен иметь подтверждённый email.

Справочник инструментов

Подключённые инструменты, явные границы.

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

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

Студия квилтинга
list-formats-tool

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

Только чтение

Аргументы

  • Без аргументов

Структурированный результат

artwork_inputs[] и formats[]

get-account-usage-tool

Возвращает лимит превью, баланс кредитов, стоимость рабочих процессов, лимиты подписки и даты сброса.

Только чтение

Аргументы

  • Без аргументов

Структурированный результат

объект usage

list-processing-jobs-tool

Перечисляет недавние задачи конвертации и оцифровки, принадлежащие подключённому аккаунту.

Только чтение

Аргументы

  • limit: целое число, 1–50, по умолчанию 20

Структурированный результат

jobs[] со статусом, файлами и метриками

get-processing-job-tool

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

Только чтение

Аргументы

  • workflow: conversion | digitising
  • job_id: 26-символьный идентификатор задачи

Структурированный результат

объект job

create-processing-job-tool

Создаёт одну приватную задачу превью конвертации или автоматической оцифровки из стандартного файла в кодировке base64.

Создаёт данные

Аргументы

  • workflow: conversion | digitising
  • file_name: оригинальное имя с расширением
  • file_base64: чистый стандартный base64, без префикса data URL
  • format: записываемый выход в нижнем регистре
  • width_mm: 10–300, обязательно для оцифровки
  • colour_count: 1–24, обязательно для оцифровки

Структурированный результат

сводка задачи и billing_authorized: false

Вызовы инструментов и запросы

Готовые примеры для агентов.

Вызов инструмента MCP · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
Запрос 1

“Проверьте, какие форматы могут читать PES и безопасно записывать JEF. Покажите предупреждения о совместимости.”

Запрос 2

“Перечислите пять последних заданий вышивки и суммируйте всё, что завершилось ошибкой.”

Запрос 3

“Перед загрузкой попросите подтверждения. Затем оцифруйте logo.png шириной 90 мм не более чем в 8 цветов и верните превью PES.”

Запрос 4

“Опрашивайте задание 01J… до завершения, затем сообщите метрики стежков, предупреждения и разблокирован ли уже файл для скачивания.”

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

Полезный доступ без прав оплаты.

Без инструментов управления оплатой

Нет инструментов покупки, оформления заказа, расхода кредитов при явной разблокировке или разблокировки платного скачивания.

Без инструментов доступа к учётным данным

Агент не может выдавать API-ключи, изменять аутентификацию или получать секретные данные.

Только собственные данные

Каждый запрос задания ограничен подключённым пользователем до возврата деталей.

Недоверенные результаты обрабатываются как данные

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

Создание предпросмотра изменяет состояние

Инструмент создания сохраняет приватную загрузку, создаёт задание и может потребовать разрешения на превью. Он отдельно ограничен 6 запросами в минуту на пользователя с дополнительным сетевым лимитом. Сервер указывает агенту спросить пользователя перед загрузкой.

Предпросмотр не подтверждает готовность к производству

Успешный вызов инструмента устанавливает billing_authorized: false. Агенты не должны утверждать, что дизайн готов к производству до завершения, проверки метрик и предупреждений.

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

Быстро диагностируйте сбои подключения.

401 Unauthorized

Не отправлен действительный токен доступа. Перезапустите OAuth-подключение клиента.

403 Forbidden

Токену не хватает mcp:use, аккаунт не подтверждён или задание принадлежит другому пользователю.

invalid_redirect_uri

Origin обратного вызова клиента или нативная схема не в белом списке сервера.

422 tool error

Аргументы, данные base64, тип источника, целевой формат или квота аккаунта не прошли валидацию.

429 Too Many Requests

Инструменты чтения по умолчанию разрешают 60 запросов в минуту; инструмент создания файлов — 6. Уважайте Retry-After.

Избегайте слишком частых запросов статуса

Опрашивайте задания в очереди и в обработке с backoff. Остановитесь, когда статус станет completed или failed.

Срок доступа к приватному файлу истёк

URL файлов требуют тот же токен OAuth-доступа и остаются подчинёнными expiresAt дате хранения загрузки. Не рассматривайте URL как постоянные идентификаторы файлов.

Создаёте обычное приложение?

Используйте REST API с областью.

Руководство REST включает управление API-ключами, multipart-примеры на трёх языках, все эндпоинты, жизненный цикл ответов и OpenAPI 3.1.

Открыть документацию REST API