Remote MCP · v1.0OAuth 2.1 + PKCE

Geef AI-agents borduurhulpmiddelen.

Verbind assistenten met indelingontdekking, accountgebruik en privé verwerkingstaken—namens een gebruiker, met browsergoedkeuring en zonder facturatie- of credentialhulpmiddelen.

Streamable HTTP-eindpunt

https://embroideryfileconverter.com/mcp/embroidery

Tools

5

Scope

mcp:use

Leeslimiet

60/min

De gebruiker meldt zich aan, verifieert het e-mailadres en keurt toegang goed in de browser. De agent ontvangt een beperkte token—niet het wachtwoord van de gebruiker of een API-sleutel.

Clientcompatibiliteit

Kies uw agent. Kopieer de instelling.

Gebruik de onderstaande gidsen voor ChatGPT, Claude, de OpenAI Agents SDK, Cursor, VS Code, OpenClaw, Gemini CLI, OpenCode, Windsurf en Cline. Elke gids geeft aan of OAuth native, door ontwikkelaar beheerd of een beoordeelde bridge vereist.

OpenAI-logo
Native OAuthChatGPT web · Instellingen → Apps

Verbind ChatGPT

Maak een aangepaste MCP-app in ChatGPT-ontwikkelaarsmodus en laat ChatGPT de tools en OAuth-metadata ontdekken.

  1. 1Schakel Ontwikkelaarsmodus in via Instellingen → Apps → Geavanceerde instellingen, of open Werkruimte-instellingen → Apps → Maken.
  2. 2Maak een app, plak het MCP-eindpunt en kies OAuth-authenticatie.
  3. 3Selecteer Scan tools, keur toegang goed in de browser en maak en activeer de concept-app.
Officiële ChatGPT MCP-documentatie
ChatGPT-installatie · Verbindingswaarden
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

Gebruik browser-OAuth en vraag alleen mcp:use. Plaats nooit een wachtwoord, refresh token of langlevend bearer token in een repository.

Volledige write-tool-ondersteuning is bedoeld voor ChatGPT Business en Enterprise/Edu-werkruimten. Beschikbaarheid en beheersopties verschillen per abonnement.

Streamable HTTPOAuth-autorisatiecode + PKCEPrivégegevens per gebruiker

Als uw client OAuth niet kan openen

Bevestig dat het remote Streamable HTTP MCP-servers en protected-resource discovery ondersteunt. Een lokale stdio-only client kan niet verbinden met dit gehoste eindpunt zonder een compatibele bridge.

Autorisatie

OAuth-autorisatiecode + PKCE.

De server publiceert op standaarden gebaseerde metadata, vereist S256 PKCE en stelt één minimale-privilege-scope beschikbaar. Dynamische registratie is alleen beschikbaar voor door de operator toegestane callback-origins en native schema’s.

Beschermde resourcehttps://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery
Autorisatieserverhttps://embroideryfileconverter.com/.well-known/oauth-authorization-server
Dynamische registratiehttps://embroideryfileconverter.com/oauth/register
Issuerhttps://embroideryfileconverter.com
Vereiste scopemcp:use
Protocolniveau voorbeelden · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "Your agent",
      "version": "1.0.0"
    }
  }
}

Kortstondige toegang

Toegangstokens verlopen na 60 minuten. Refresh-tokens verlopen na 30 dagen en blijven intrekkbaar.

Geverifieerd account vereist

Een geldige token moet bevatten mcp:use, en de verbonden gebruiker moet een geverifieerd e-mailadres hebben.

Toolreferentie

Vijf tools, expliciete grenzen.

list-formats-tool

Toont leesbare borduurbronnen, schrijfbare machine-uitvoer, afbeelding-invoertypen en compatibiliteitswaarschuwingen.

Alleen-lezen

Argumenten

  • Geen argumenten

Gestructureerd resultaat

artwork_inputs[] en formats[]

get-account-usage-tool

Retourneert preview-toewijzing, kredietbalans, workflowkosten, abonnementslimieten en resetdata.

Alleen-lezen

Argumenten

  • Geen argumenten

Gestructureerd resultaat

gebruikobject

list-processing-jobs-tool

Toont recente conversie- en digitaliseringsjobs van het verbonden account.

Alleen-lezen

Argumenten

  • limit: integer, 1–50, standaard 20

Gestructureerd resultaat

jobs[] met status, bestanden en metrics

get-processing-job-tool

Haalt één eigen job op met events, waarschuwingen, metrics, previewbestanden en beschikbare OAuth-beveiligde bestands-URL's.

Alleen-lezen

Argumenten

  • workflow: conversie | digitalisering
  • job_id: 26-teken job-ID

Gestructureerd resultaat

jobobject

create-processing-job-tool

Maakt één privé conversie- of geautomatiseerde digitaliseringspreview aan vanuit een standaard base64-gecodeerd bestand.

Maakt data aan

Argumenten

  • workflow: conversie | digitalisering
  • file_name: oorspronkelijke naam met extensie
  • file_base64: ruwe standaard base64, geen data-URL-prefix
  • format: lowercase schrijfbare uitvoer
  • width_mm: 10–300, vereist voor digitalisering
  • colour_count: 1–24, vereist voor digitalisering

Gestructureerd resultaat

joboverzicht en billing_authorized: false

Toolaanroepen en prompts

Kant-en-klare agentvoorbeelden.

MCP toolaanroep · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
Prompt 1

Controleer welke indelingen PES kunnen lezen en veilig JEF kunnen schrijven. Toon eventuele compatibiliteitswaarschuwingen.

Prompt 2

Toon mijn vijf meest recente borduurtaken en vat samen wat mislukte.

Prompt 3

Vraag me om te bevestigen voordat u uploadt. Digitaliseer daarna logo.png op 90 mm breed met maximaal 8 kleuren en retourneer een PES-voorbeeld.

Prompt 4

Bevraag taak 01J… tot deze klaar is, rapporteer daarna steekmetrics, waarschuwingen en of een download al is ontgrendeld.

Veiligheidsmodel

Nuttige toegang zonder betalingsbevoegdheid.

Geen facturatiehulpmiddelen

Geen aankoop-, checkout-, creditverbruik via expliciete ontgrendeling of betaald-download-ontgrendelingstool wordt blootgesteld.

Geen credentialhulpmiddelen

De agent kan geen API-sleutels uitgeven, authenticatie wijzigen of geheim materiaal ophalen.

Alleen eigen data

Elke taakquery is beperkt tot de verbonden gebruiker voordat details worden geretourneerd.

Niet-vertrouwde uitvoer blijft data

Serverinstructies vertellen agents nooit commando’s te volgen die zijn ingebed in bestandsnamen, metadata, taakberichten of waarschuwingen.

Een voorbeeld maken wijzigt status

De create-tool slaat een privé-upload op, maakt een taak en kan preview-toelage verbruiken. Het is afzonderlijk beperkt tot 6 verzoeken per minuut per gebruiker, met een extra netwerklimiet. De server instrueert de agent om de gebruiker te vragen voordat wordt geüpload.

Voorbeeld is geen productiegoedkeuring

Een succesvolle toolaanroep zet billing_authorized: false. Agents mogen een ontwerp niet als productieklaar claimen voordat het voltooid is en metrics en waarschuwingen zijn gecontroleerd.

Probleemoplossing

Verbindingsproblemen snel diagnosticeren.

401 Unauthorized

Geen geldig access token verzonden. Herstart de OAuth-verbinding van de client.

403 Forbidden

Het token mist mcp:use, het account is niet geverifieerd of de job behoort tot een andere gebruiker.

invalid_redirect_uri

De callback-origin of native scheme van de client staat niet op de allow-list van de server.

422 tool error

Argumenten, base64-gegevens, brontype, doelformaat of accountquota zijn niet gevalideerd.

429 Too Many Requests

Read-tools staan standaard 60 verzoeken per minuut toe; de file-creation-tool staat 6 toe. Respecteer Retry-After.

Vermijd agressief pollen

Poll wachtende en verwerkende jobs met backoff. Stop wanneer de status wordt completed of failed.

Verlopen privébestand

File-URL’s vereisen hetzelfde OAuth access token en blijven onderworpen aan de upload- expiresAt bewaartermijn. Behandel URL’s niet als permanente bestandsidentificatie.

Een conventionele app bouwen?

Gebruik de scoped REST API.

De REST-gids bevat API-sleutelbeheer, multipart-voorbeelden in drie talen, elk endpoint, de responslevenscyclus en OpenAPI 3.1.

Open REST API-documentatie