MCP từ xa · v1.0OAuth 2.1 + PKCE

Cung cấp cho tác nhân AI công cụ thêu.

Kết nối trợ lý với khám phá định dạng, sử dụng tài khoản và công việc xử lý riêng tư—thay mặt người dùng, với phê duyệt trình duyệt và không có công cụ thanh toán hoặc thông tin xác thực.

Điểm cuối HTTP có thể stream

https://embroideryfileconverter.com/mcp/embroidery

Công cụ

5

Phạm vi

mcp:use

Tỷ lệ đọc

60/min

Người dùng đăng nhập, xác minh email và phê duyệt quyền truy cập trong trình duyệt. Tác nhân nhận mã thông báo có phạm vi—không phải mật khẩu của người dùng hoặc khóa API.

Khả năng tương thích máy khách

Chọn tác nhân của bạn. Sao chép thiết lập của nó.

Sử dụng hướng dẫn bên dưới cho ChatGPT, Claude, OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf và Cline. Mỗi hướng dẫn xác định OAuth là gốc, do nhà phát triển quản lý hay có thể cần cầu nối đã xem xét.

OpenAI logo
OAuth gốcChatGPT web · Cài đặt → Ứng dụng

Kết nối ChatGPT

Tạo ứng dụng MCP tùy chỉnh ở chế độ nhà phát triển ChatGPT và để ChatGPT khám phá công cụ cùng siêu dữ liệu OAuth.

  1. 1Bật chế độ Nhà phát triển trong Cài đặt → Ứng dụng → Cài đặt nâng cao, hoặc mở Cài đặt Workspace → Ứng dụng → Tạo.
  2. 2Tạo ứng dụng, dán điểm cuối MCP và chọn xác thực OAuth.
  3. 3Chọn Quét công cụ, phê duyệt quyền truy cập trong trình duyệt, sau đó tạo và bật ứng dụng nháp.
Tài liệu MCP ChatGPT chính thức
Thiết lập ChatGPT · Giá trị kết nối
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

Sử dụng OAuth trình duyệt và chỉ yêu cầu mcp:use. Không bao giờ đặt mật khẩu, mã thông báo làm mới hoặc bearer token dài hạn vào kho mã nguồn.

Hỗ trợ công cụ ghi đầy đủ dành cho không gian làm việc ChatGPT Business và Enterprise/Edu. Tính khả dụng và điều khiển quản trị thay đổi theo gói.

Streamable HTTPMã ủy quyền OAuth + PKCEDữ liệu riêng tư theo người dùng

Nếu máy khách của bạn không thể mở OAuth

Xác nhận nó hỗ trợ máy chủ MCP HTTP Streamable từ xa và khám phá tài nguyên được bảo vệ. Máy khách stdio-only cục bộ không thể kết nối với điểm cuối được lưu trữ này mà không có cầu nối tương thích.

Ủy quyền

Mã ủy quyền OAuth + PKCE.

Máy chủ xuất bản siêu dữ liệu dựa trên tiêu chuẩn, yêu cầu S256 PKCE và hiển thị một phạm vi đặc quyền tối thiểu. Đăng ký động chỉ khả dụng cho nguồn gốc callback được toán tử cho phép và lược đồ gốc.

Tài nguyên được bảo vệhttps://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery
Máy chủ ủy quyềnhttps://embroideryfileconverter.com/.well-known/oauth-authorization-server
Đăng ký độnghttps://embroideryfileconverter.com/oauth/register
Bên phát hànhhttps://embroideryfileconverter.com
Phạm vi bắt buộcmcp:use
Ví dụ cấp giao thức · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "Your agent",
      "version": "1.0.0"
    }
  }
}

Truy cập ngắn hạn

Mã thông báo truy cập hết hạn sau 60 phút. Mã thông báo làm mới hết hạn sau 30 ngày và vẫn có thể thu hồi.

Yêu cầu tài khoản đã xác minh

Mã thông báo hợp lệ phải chứa mcp:use, và người dùng được kết nối phải có địa chỉ email đã xác minh.

Tham chiếu công cụ

Năm công cụ, ranh giới rõ ràng.

list-formats-tool

Liệt kê nguồn thêu có thể đọc, đầu ra máy có thể ghi, loại đầu vào ảnh và cảnh báo tương thích.

Chỉ đọc

Đối số

  • Không có tham số

Kết quả có cấu trúc

artwork_inputs[] và formats[]

get-account-usage-tool

Trả về hạn mức xem trước, số dư tín dụng, chi phí quy trình, giới hạn gói đăng ký và ngày đặt lại.

Chỉ đọc

Đối số

  • Không có tham số

Kết quả có cấu trúc

đối tượng sử dụng

list-processing-jobs-tool

Liệt kê các công việc chuyển đổi và số hóa gần đây của tài khoản đã kết nối.

Chỉ đọc

Đối số

  • limit: số nguyên, 1–50, mặc định 20

Kết quả có cấu trúc

jobs[] kèm trạng thái, tệp và số liệu

get-processing-job-tool

Lấy một công việc thuộc sở hữu kèm sự kiện, cảnh báo, số liệu, tệp xem trước và URL tệp được bảo vệ OAuth.

Chỉ đọc

Đối số

  • workflow: conversion | digitising
  • job_id: mã định danh công việc 26 ký tự

Kết quả có cấu trúc

đối tượng công việc

create-processing-job-tool

Tạo một bản xem trước chuyển đổi riêng hoặc số hóa tự động từ tệp mã hóa base64 tiêu chuẩn.

Tạo dữ liệu

Đối số

  • workflow: conversion | digitising
  • file_name: tên gốc kèm phần mở rộng
  • file_base64: base64 tiêu chuẩn thô, không có tiền tố data URL
  • format: định dạng đầu ra viết thường
  • width_mm: 10–300, bắt buộc khi số hóa
  • colour_count: 1–24, bắt buộc khi số hóa

Kết quả có cấu trúc

tóm tắt công việc và billing_authorized: false

Lời gọi công cụ và lời nhắc

Ví dụ tác nhân sẵn sao chép.

Lời gọi công cụ MCP · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
Lời nhắc 1

Kiểm tra định dạng nào có thể đọc PES và ghi JEF an toàn. Hiển thị cho tôi mọi cảnh báo tương thích.

Lời nhắc 2

Liệt kê năm công việc thêu gần đây nhất của tôi và tóm tắt mọi thứ đã thất bại.

Lời nhắc 3

Trước khi tải lên, yêu cầu tôi xác nhận. Sau đó số hóa logo.png rộng 90 mm với không quá 8 màu và trả về bản xem trước PES.

Lời nhắc 4

Thăm dò công việc 01J… cho đến khi hoàn tất, sau đó báo cáo số liệu mũi khâu, cảnh báo và liệu tải xuống đã được mở khóa chưa.

Mô hình an toàn

Truy cập hữu ích mà không có quyền thanh toán.

Không có công cụ thanh toán

Không có công cụ mua, thanh toán, tiêu tín dụng bằng mở khóa rõ ràng hoặc mở khóa tải xuống trả phí được hiển thị.

Không có công cụ thông tin xác thực

Tác nhân không thể phát hành khóa API, thay đổi xác thực hoặc truy xuất tài liệu bí mật.

Chỉ dữ liệu sở hữu

Mỗi truy vấn công việc bị hạn chế đối với người dùng được kết nối trước khi trả về chi tiết.

Đầu ra không đáng tin cậy vẫn là dữ liệu

Hướng dẫn máy chủ yêu cầu tác nhân không bao giờ tuân theo lệnh được nhúng trong tên file, siêu dữ liệu, thông báo công việc hoặc cảnh báo.

Tạo bản xem trước thay đổi trạng thái

Công cụ tạo lưu trữ tải lên riêng tư, tạo công việc và có thể tiêu tốn hạn mức xem trước. Nó bị giới hạn riêng biệt ở 6 yêu cầu mỗi phút mỗi người dùng, với giới hạn mạng bổ sung. Máy chủ hướng dẫn tác nhân hỏi người dùng trước khi tải lên.

Bản xem trước không phải phê duyệt sản xuất

Lời gọi công cụ thành công đặt billing_authorized: false. Các tác nhân không được tuyên bố thiết kế đã sẵn sàng sản xuất trước khi hoàn tất, kiểm tra chỉ số và cảnh báo.

Khắc phục sự cố

Chẩn đoán lỗi kết nối nhanh chóng.

401 Unauthorized

Không gửi được mã thông báo truy cập hợp lệ. Khởi động lại kết nối OAuth của máy khách.

403 Forbidden

Mã thông báo thiếu mcp:use, tài khoản chưa được xác minh hoặc công việc thuộc về người dùng khác.

invalid_redirect_uri

Nguồn gốc callback của máy khách hoặc giao thức gốc không nằm trong danh sách cho phép của máy chủ.

422 tool error

Tham số, dữ liệu base64, loại nguồn, định dạng đích hoặc hạn ngạch tài khoản không hợp lệ.

429 Too Many Requests

Công cụ đọc cho phép 60 yêu cầu mỗi phút theo mặc định; công cụ tạo file cho phép 6. Tuân thủ Retry-After.

Tránh thăm dò quá mức

Thăm dò công việc đang chờ và đang xử lý với backoff. Dừng khi trạng thái trở thành completed hoặc failed.

File riêng tư đã hết hạn

URL file yêu cầu cùng mã thông báo truy cập OAuth và vẫn chịu sự chi phối của expiresAt ngày lưu trữ. Không coi URL là định danh file vĩnh viễn.

Xây dựng ứng dụng thông thường?

Sử dụng REST API có phạm vi.

Hướng dẫn REST bao gồm quản lý khóa API, ví dụ multipart bằng ba ngôn ngữ, mọi endpoint, vòng đời phản hồi và OpenAPI 3.1.

Mở tài liệu REST API