El servidor MCP de Vidext Operator

El servidor MCP de Vidext Operator es un servidor MCP remoto y autenticado que habla JSON-RPC sobre streamable HTTP. La configuración de clientes y el flujo OAuth en el navegador están en la guía rápida; esta página es el contrato del servidor.

Endpoint e identidadCopy Anchor Link

https://app.vidext.com/api/mcp/operator

Una URL sirve a todos los clientes. Expone varias tools tipadas, no varias URLs. El servidor se identifica como vidext-operator (título Vidext Operator); las configuraciones de los clientes usan ese nombre, así que no cambia.

El mismo host sirve un único servidor hermano: el servidor MCP de documentación público en /api/mcp/docs, sin autenticación. Conéctalo junto a Operator cuando quieras un cliente que pueda consultar cómo funciona Vidext además de leer los datos de tu organización. No hay más endpoints MCP.

Detalles del transporteCopy Anchor Link

• Métodos. POST, más un preflight OPTIONS con CORS permisivo para clientes que funcionan en el navegador. El endpoint no guarda estado y nunca abre un stream iniciado por el servidor, así que un GET o DELETE autenticado responde 405. La autenticación va primero, así que sin un token válido esos dos responden 401.
• Sin sesiones. El servidor nunca emite ni lee MCP-Session-ID. La única cabecera de respuesta expuesta a los navegadores es WWW-Authenticate.
• Solo el protocolo 2026-07-28. Cada petición lleva el sobre _meta por petición. Una petición sin él, incluido un handshake initialize al estilo 2025, recibe el error JSON-RPC -32022 (Unsupported protocol version) con HTTP 400 y data.supported: ["2026-07-28"]. server/discover sustituye al handshake; su resultado incluye supportedVersions.
• Cabeceras de método. Cada POST lleva Mcp-Method con el método JSON-RPC, más Mcp-Name cuando el método nombra una entidad (el nombre de la tool en tools/call, la URI en resources/read). Una cabecera ausente o que no coincide recibe -32020 con HTTP 400.
• Respuestas. Los intercambios responden en JSON. Sigue enviando Accept: application/json, text/event-stream; el transporte permite que una respuesta llegue como stream.
• Autenticación. Una petición sin un token válido recibe HTTP 401 con un challenge WWW-Authenticate: Bearer cuyo resource_metadata apunta a /.well-known/oauth-protected-resource/api/mcp/operator. El cuerpo es un error OAuth, no JSON-RPC. Los clientes MCP lo siguen automáticamente. Consulta Autenticación.

Versionado y deprecaciónCopy Anchor Link

El servidor se versiona por revisión del protocolo MCP, no por URL. /.well-known/mcp lista las revisiones que sirve en mcp.protocolVersions (hoy solo 2026-07-28).

Cuando se anuncia la retirada de una revisión del protocolo, se sigue sirviendo al menos 90 días. Durante ese plazo, cada intercambio que nombra la revisión en MCP-Protocol-Version y llega al servidor responde con:

• Las respuestas que nunca llegan al servidor — el preflight OPTIONS, un 401 o 403, el 404 de una ruta desconocida — no llevan estas cabeceras.
• Los navegadores no pueden leerlas, porque CORS solo expone WWW-Authenticate. Los clientes de servidor sí.
• Hoy no hay ninguna revisión en deprecación, así que ninguna respuesta las lleva todavía.
• Una revisión que ya no se sirve recibe -32022, nunca se rebaja en silencio.

Estas cabeceras solo cubren revisiones del protocolo; una tool no lleva ninguna señal de deprecación propia. tools/list es la fuente de verdad de las tools que ofrece el servidor, así que vuelve a leerlo en cada conexión en lugar de guardarlo en caché. La referencia de tools describe el conjunto actual.

RecursosCopy Anchor Link

El servidor registra un recurso MCP y ningún prompt:

El contrato que mantiene el servidorCopy Anchor Link

• Identidad y ámbito. Cada llamada se ejecuta como el usuario que autorizó el token, dentro de la organización ligada a él. Solo se admite a admins y miembros de la organización; el rol se vuelve a comprobar en cada llamada.
• Solo lectura. Cada tool es una lectura determinista que no ejecuta ningún modelo. Ninguna tool crea, genera, edita ni publica contenido.
• Los errores son resultados. Una tool que falla devuelve un resultado normal con isError: true y un error estructurado o, en las dos tools de conocimiento, success: false. Consulta Errores y límites.
• Control de admisión. Cada llamada cuenta contra un límite de tasa y un límite de concurrencia por usuario, organización y tool.
• Las mismas tools para todos. tools/list devuelve las mismas tres tools a cualquier token aceptado.

JSON-RPC en brutoCopy Anchor Link

Mejor usa un cliente MCP real. Para depurar con curl, obtén primero un token de acceso (consulta Autenticación) y luego:

curl -X POST "https://app.vidext.com/api/mcp/operator" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <access_token>" \
  -H "Mcp-Method: tools/list" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": { "name": "curl", "version": "1.0.0" },
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

Quita el sobre _meta o la cabecera Mcp-Method y la petición se rechaza, como se describe arriba.