원격 MCP · v1.0OAuth 2.1 + PKCE

AI 에이전트에게 자수 도구를 제공하세요.

브라우저 승인으로 사용자 대신 형식 검색, 계정 사용량, 비공개 처리 작업에 어시스턴트를 연결하세요. 결제나 자격 증명 도구는 제공되지 않습니다.

스트리밍 가능한 HTTP 엔드포인트

https://embroideryfileconverter.com/mcp/embroidery

도구

5

범위

mcp:use

읽기 제한

60/min

사용자가 브라우저에서 로그인하고 이메일을 확인한 후 접근을 승인합니다. 에이전트는 범위가 지정된 토큰을 받으며 사용자의 비밀번호나 API 키를 받지 않습니다.

클라이언트 호환성

에이전트를 선택하고 설정을 복사하세요.

아래 가이드를 ChatGPT, Claude, OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf 및 Cline에 사용하세요. 각 가이드는 OAuth가 기본 제공되는지, 개발자가 관리하는지 또는 검토된 브리지가 필요한지를 명시합니다.

OpenAI 로고
네이티브 OAuthChatGPT 웹 · 설정 → 앱

ChatGPT 연결

ChatGPT 개발자 모드에서 사용자 지정 MCP 앱을 만들고 ChatGPT가 도구와 OAuth 메타데이터를 검색하도록 하세요.

  1. 1설정 → 앱 → 고급 설정에서 개발자 모드를 활성화하거나, Workspace 설정 → 앱 → 만들기를 여세요.
  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. 저장소에 비밀번호, 갱신 토큰 또는 장기 bearer 토큰을 절대 넣지 마세요.

전체 쓰기 도구 지원은 ChatGPT Business 및 Enterprise/Edu 워크스페이스를 위한 것입니다. 가용성과 관리 제어는 플랜에 따라 다릅니다.

Streamable HTTPOAuth 인증 코드 + PKCE사용자별 비공개 데이터

클라이언트가 OAuth를 열 수 없는 경우

원격 Streamable HTTP MCP 서버와 보호된 리소스 검색을 지원하는지 확인하세요. 로컬 stdio 전용 클라이언트는 호환 브리지 없이는 이 호스팅 엔드포인트에 연결할 수 없습니다.

인증

OAuth 인증 코드 + PKCE.

서버는 표준 기반 메타데이터를 게시하고 S256 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
필요 범위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, 연결된 사용자는 인증된 이메일 주소가 있어야 합니다.

도구 참조

5개 도구, 명확한 경계.

list-formats-tool

읽기 가능 자수 원본, 쓰기 가능 기계 출력, 아트워크 입력 유형, 호환성 경고를 나열합니다.

읽기 전용

인수

  • 인수 없음

구조화된 결과

artwork_inputs[] 및 formats[]

get-account-usage-tool

미리보기 허용량, 크레딧 잔액, 워크플로 비용, 구독 한도 및 초기화 날짜를 반환합니다.

읽기 전용

인수

  • 인수 없음

구조화된 결과

사용량 객체

list-processing-jobs-tool

연결된 계정이 소유한 최근 변환 및 디지타이징 작업 목록을 표시합니다.

읽기 전용

인수

  • limit: 정수, 1–50, 기본값 20

구조화된 결과

jobs[] with status, files and metrics

get-processing-job-tool

이벤트, 경고, 메트릭, 미리보기 아티팩트 및 사용 가능한 OAuth 보호 파일 URL이 포함된 소유 작업 하나를 가져옵니다.

읽기 전용

인수

  • workflow: 변환 | 디지타이징
  • job_id: 26자 작업 식별자

구조화된 결과

job object

create-processing-job-tool

표준 base64 인코딩 파일에서 비공개 변환 또는 자동 디지타이징 미리보기 하나를 생성합니다.

데이터를 생성합니다.

인수

  • workflow: 변환 | 디지타이징
  • file_name: 확장자가 포함된 원본 이름
  • file_base64: 원시 표준 base64, data URL 접두사 없음
  • format: 소문자 쓰기 가능한 출력
  • width_mm: 10–300, 디지타이징에 필요
  • colour_count: 1–24, 디지타이징에 필요

구조화된 결과

job summary and billing_authorized: false

도구 호출 및 프롬프트

복사 가능한 에이전트 예제.

MCP 도구 호출 · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
프롬프트 1

PES를 읽고 JEF로 안전하게 쓸 수 있는 형식을 확인하세요. 호환성 경고가 있으면 알려주세요.

프롬프트 2

최근 5개 자수 작업을 나열하고 실패한 항목을 요약하세요.

프롬프트 3

업로드 전에 확인을 요청하세요. 그런 다음 logo.png를 폭 90mm, 최대 8색으로 디지타이징하고 PES 미리보기를 반환하세요.

프롬프트 4

작업 01J…이 완료될 때까지 폴링한 후 스티치 지표, 경고 및 다운로드 잠금 해제 여부를 보고하세요.

안전 모델

결제 권한 없는 유용한 접근.

결제 도구 없음

구매, 결제, 명시적 잠금 해제로 인한 크레딧 소모 또는 유료 다운로드 잠금 해제 도구는 노출되지 않습니다.

자격 증명 도구 없음

에이전트는 API 키를 발급하거나 인증을 변경하거나 비밀 자료를 검색할 수 없습니다.

소유 데이터 전용

모든 작업 쿼리는 세부 정보가 반환되기 전에 연결된 사용자로 제한됩니다.

신뢰할 수 없는 출력은 데이터로 유지

서버 지침은 에이전트가 파일 이름, 메타데이터, 작업 메시지 또는 경고에 포함된 명령을 따르지 않도록 지시합니다.

미리보기 생성은 상태를 변경합니다

생성 도구는 비공개 업로드를 저장하고 작업을 생성하며 미리보기 허용량을 소모할 수 있습니다. 사용자당 분당 6회 요청으로 별도 제한되며 추가 네트워크 제한이 있습니다. 서버는 업로드 전에 사용자에게 확인하도록 에이전트에 지시합니다.

미리보기는 생산 승인이 아닙니다

도구 호출 성공 시 설정됩니다 billing_authorized: false. 에이전트는 완료, 메트릭 및 경고를 검사하기 전에 디자인을 생산 준비 완료라고 주장해서는 안 됩니다.

문제 해결

연결 실패를 빠르게 진단합니다.

401 Unauthorized

유효한 액세스 토큰이 전송되지 않았습니다. 클라이언트의 OAuth 연결을 다시 시작하세요.

403 Forbidden

토큰에 mcp:use 권한이 없거나, 계정이 인증되지 않았거나, 작업이 다른 사용자 소유입니다.

invalid_redirect_uri

클라이언트 콜백 오리진 또는 네이티브 스킴이 서버 허용 목록에 없습니다.

422 tool error

인수, base64 데이터, 소스 유형, 대상 형식 또는 계정 할당량이 유효성 검사를 통과하지 못했습니다.

429 Too Many Requests

읽기 도구는 기본적으로 분당 60 요청을 허용하며, 파일 생성 도구는 6를 허용합니다. Retry-After를 준수하세요.

과도한 폴링을 피하세요

대기 및 처리 중인 작업을 백오프로 폴링하세요. 상태가 다음이 되면 중지하세요 completed 또는 failed.

만료된 비공개 파일

파일 URL은 동일한 OAuth 액세스 토큰이 필요하며 업로드의 expiresAt 보관 기간을 따릅니다. URL을 영구 파일 식별자로 취급하지 마세요.

일반 앱을 만드시나요?

범위가 지정된 REST API를 사용하세요.

REST 가이드에는 API 키 관리, 세 가지 언어의 멀티파트 예제, 모든 엔드포인트, 응답 수명 주기 및 OpenAPI 3.1이 포함되어 있습니다.

REST API 문서 열기