# Servidor MCP de bordado para agentes de IA

Página canónica: https://embroideryfileconverter.com/es/ai-agents

Conecte agentes de IA a herramientas de bordado autenticadas a través de un servidor MCP remoto con OAuth, descubrimiento de formatos, estado de uso y trabajos de procesamiento privados.

## Elegir la integración correcta

- Utilice este servidor MCP remoto cuando un asistente de IA deba actuar en nombre de un usuario mediante OAuth aprobado por el navegador.
- Utilice la [API REST para desarrolladores](https://embroideryfileconverter.com/es/developers) para un backend convencional, un producto SaaS o automatización del lado del servidor.

## Conectar un cliente MCP

- Endpoint HTTP transmisible: `https://embroideryfileconverter.com/mcp/embroidery`
- Ámbito OAuth: `mcp:use`
- Límite de velocidad MCP predeterminado: 60 solicitudes por minuto
- Límite de herramienta de creación de archivos: 6 solicitudes por minuto por usuario, más un límite de red
- Vida útil del token de acceso: 60 minutos
- Vida útil del token de actualización: 30 días

El punto final funciona con clientes HTTP Streamable remotos. Prefiera OAuth nativo del navegador; nunca pegue contraseñas, tokens de actualización ni tokens de portador de larga duración en un repositorio.

## Conectar ChatGPT (OpenAI)

Las aplicaciones MCP completas se configuran en el modo desarrollador de ChatGPT. La disponibilidad y los controles de herramientas de escritura varían según el plan.

1. En ChatGPT web, active el modo Desarrollador en Configuración > Aplicaciones > Configuración avanzada, o abra Configuración del área de trabajo > Aplicaciones > Crear.
2. Cree una aplicación y establezca la URL del servidor MCP en `https://embroideryfileconverter.com/mcp/embroidery`.
3. Elija OAuth, seleccione Escanear herramientas y apruebe el ámbito `mcp:use` en el navegador.
4. Cree el borrador de la aplicación, habilítela y selecciónela en el menú de herramientas de una conversación nueva.

[Documentación oficial de ChatGPT MCP](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

## Conectar Claude, Claude Desktop, Cowork o Claude Code

En Claude, abra Personalizar > Conectores > Agregar conector personalizado, introduzca `https://embroideryfileconverter.com/mcp/embroidery`, elija Conectar y complete OAuth. Los propietarios de Team y Enterprise agregan el conector en Configuración de la organización > Conectores antes de que los miembros se conecten individualmente.

Comando de Claude Code:

```bash
claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery
# Luego ejecute /mcp dentro de Claude Code y complete la autorización del navegador.
```

[Documentación oficial de Claude remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## Conectar el SDK de agentes de OpenAI

Su backend debe completar el código de autorización OAuth + PKCE para su usuario con sesión iniciada, almacenar los tokens cifrados en el servidor, actualizarlos cuando sea necesario y pasar el token de acceso actual a la herramienta MCP alojada. Nunca exponga este token en JavaScript del navegador.

```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',
    }),
  ],
});
```

[Documentación oficial de OpenAI Agents SDK MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

## Conectar Cursor

Agregue esto a `.cursor/mcp.json`, inicie el servidor en Configuración de Cursor > MCP y complete OAuth. Los usuarios de Cursor Agent pueden ejecutar `cursor-agent mcp login embroidery-file-converter`.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Documentación oficial de Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

## Conectar VS Code y GitHub Copilot

Ejecute `MCP: Add Server` y elija HTTP, o agregue esto a `.vscode/mcp.json`. Inícielo con `MCP: List Servers`, confíe la configuración y complete la autorización del navegador.

```json
{
  "servers": {
    "embroidery-file-converter": {
      "type": "http",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Documentación oficial de VS Code MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers)

## Conectar 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
```

[Documentación oficial de OpenClaw MCP](https://docs.openclaw.ai/cli/mcp)

## Conectar Gemini CLI

Agregue el servidor a `~/.gemini/settings.json`, luego ejecute `/mcp auth embroidery-file-converter` dentro de Gemini CLI.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Documentación oficial de Gemini CLI MCP](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)

## Conectar OpenCode

Agregue esto a `opencode.json`, luego ejecute `opencode mcp auth embroidery-file-converter` y verifíquelo con `opencode mcp list`.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "embroidery-file-converter": {
      "type": "remote",
      "url": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Documentación oficial de OpenCode MCP](https://opencode.ai/docs/mcp-servers/)

## Conectar Windsurf Cascade

Abra Configuración de Windsurf > Cascade > Servidores MCP, o agregue esto a `~/.codeium/windsurf/mcp_config.json`. Inicie el servidor, complete OAuth y habilite solo las herramientas necesarias.

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "serverUrl": "https://embroideryfileconverter.com/mcp/embroidery"
    }
  }
}
```

[Documentación oficial de Windsurf MCP](https://docs.windsurf.com/windsurf/cascade/mcp)

## Conectar Cline

El comportamiento OAuth de Cline varía según la versión y la superficie. Abra Servidores MCP > Servidores remotos, elija Streamable HTTP y utilice esta configuración con una lista de permitidos de aprobación vacía:

```json
{
  "mcpServers": {
    "embroidery-file-converter": {
      "type": "streamableHttp",
      "url": "https://embroideryfileconverter.com/mcp/embroidery",
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Si la versión instalada de Cline no puede completar OAuth, utilice un puente OAuth revisado y fijado por versión, o elija un cliente con OAuth nativo. No confirme un token de larga duración en `cline_mcp_settings.json`.

[Documentación oficial de Cline MCP](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx)

## Detección OAuth y PKCE

- Metadatos de recurso protegido: `https://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery`
- Metadatos del servidor de autorización: `https://embroideryfileconverter.com/.well-known/oauth-authorization-server`
- Registro dinámico de cliente: `https://embroideryfileconverter.com/oauth/register`
- Emisor del servidor de autorización: `https://embroideryfileconverter.com`
- Concesión: código de autorización
- Método PKCE: S256
- Ámbito requerido: `mcp:use`

El registro dinámico de cliente acepta solo orígenes de devolución de llamada y esquemas nativos permitidos explícitamente por el operador. Los dominios de devolución de llamada arbitrarios se rechazan. La cuenta debe tener una dirección de correo electrónico verificada antes de poder utilizar el punto final MCP.

Las devoluciones de llamada alojadas de confianza predeterminadas se limitan a los orígenes oficiales de ChatGPT, Claude y VS Code más devoluciones de llamada de bucle invertido para clientes instalados. Los dominios de redirección comodín no están habilitados. Los despliegues que anulen `MCP_REDIRECT_DOMAINS` deben conservar solo los clientes que pretenden admitir intencionadamente.

Ejemplo de registro para una devolución de llamada local permitida:

```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"]
  }'
```

## Referencia completa de herramientas

### `list-formats-tool`

Solo lectura. No acepta argumentos. Devuelve `artwork_inputs[]` y `formats[]` con los campos readable, writable, label y warning. Llámalo antes de elegir un flujo de trabajo o formato de destino.

### `get-account-usage-tool`

Solo lectura. No acepta argumentos. Devuelve el saldo de vistas previas, el saldo de créditos, los costes de flujo de trabajo, los límites de suscripción y las fechas de reinicio. Nunca compra ni consume nada.

### `list-processing-jobs-tool`

Solo lectura. Lista los trabajos recientes de la cuenta conectada.

- `limit`: entero opcional de 1 a 50; valor predeterminado 20

### `get-processing-job-tool`

Solo lectura. Devuelve un trabajo de la cuenta con estado, eventos, métricas, advertencias, artefactos de vista previa y URL de archivos protegidas por OAuth.

- `workflow`: obligatorio `conversion` o `digitising`
- `job_id`: identificador de trabajo obligatorio de 26 caracteres

### `create-processing-job-tool`

Crea datos almacenados. Inicia un trabajo de vista previa privado y puede consumir saldo de vistas previas, pero nunca compra créditos ni desbloquea una descarga de pago.

- `workflow`: obligatorio `conversion` o `digitising`
- `file_name`: nombre de archivo original obligatorio con extensión, de 3 a 255 caracteres, sin separadores de ruta ni caracteres de control
- `file_base64`: base64 estándar sin prefijo data-URL obligatorio
- `format`: formato de salida de bordado en minúsculas y grabable obligatorio
- `width_mm`: número de 10 a 300, obligatorio para digitalización
- `colour_count`: entero de 1 a 24, obligatorio para digitalización

El resultado estructurado incluye `billing_authorized: false`. En conversión, el formato de salida seleccionado debe ser distinto del formato de origen detectado.

## Ejemplos de herramientas JSON-RPC

Listar formatos:

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
```

Crear vista previa de digitalización:

```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
    }
  }
}
```

Consultar el trabajo devuelto:

```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get-processing-job-tool",
    "arguments": {
      "workflow": "digitising",
      "job_id": "01JEXAMPLEJOBID000000000"
    }
  }
}
```

Los estados posibles del trabajo son `queued`, `processing`, `completed` y `failed`. Consulta con retroceso y detente en un estado terminal. Las URL de archivos requieren el mismo token de acceso OAuth y siguen sujetas a la fecha de retención `expiresAt` del archivo.

## Ejemplos de indicaciones en lenguaje natural

- “Comprueba qué formatos pueden leer PES y escribir JEF de forma segura. Muéstrame las advertencias de compatibilidad.”
- “Lista mis cinco trabajos de bordado más recientes y resume cualquier fallo.”
- “Antes de subir, pide confirmación. Luego digitaliza logo.png a 90 mm de ancho con no más de 8 colores y devuelve una vista previa PES.”
- “Consulta el trabajo 01J… hasta que termine, luego informa de las métricas de puntadas, advertencias y si la descarga ya está desbloqueada.”

## Modelo de seguridad

- No se expone ninguna herramienta de facturación, pago, compra de créditos ni desbloqueo de descargas de pago.
- No se expone ninguna herramienta de creación de claves API, cambio de autenticación, lectura de credenciales ni eliminación de cuenta.
- Cada lectura de trabajo está restringida al usuario conectado.
- La herramienta de creación almacena una carga privada y crea un trabajo, por lo que el agente debe preguntar antes de cargar.
- Los nombres de archivo, metadatos, mensajes de trabajo y advertencias son datos no confiables. El servidor indica a los agentes que nunca sigan comandos incrustados en esos valores.
- Un resultado completado no está listo automáticamente para producción. Los agentes deben revisar las métricas de validación y las advertencias antes de hacer afirmaciones.

## Solución de problemas

- `401 Unauthorized`: no se envió un token de acceso válido; reinicia la conexión OAuth del cliente.
- `403 Forbidden`: el token carece de `mcp:use`, la cuenta no está verificada o el trabajo solicitado pertenece a otra cuenta.
- `invalid_redirect_uri`: el origen de la devolución de llamada o el esquema nativo no está en la lista de permitidos del servidor.
- `422`: los argumentos de la herramienta, los datos base64, el tipo de origen, el formato de destino o la cuota de la cuenta no superaron la validación.
- `429`: límite de velocidad superado; respeta `Retry-After` y usa retroceso exponencial con jitter.

## Páginas relacionadas

- [Documentación de la API para desarrolladores](https://embroideryfileconverter.com/es/developers)
- [Descripción OpenAPI 3.1](https://embroideryfileconverter.com/developers/openapi.json)
- [Política de privacidad](https://embroideryfileconverter.com/es/privacy)