Documentación

DOC / 20 / OPENSDK

Protocolo de tooling

Negocia clientes de editor y MCP sobre JSON-RPC limitado sin conceder autoridad ambiental sobre el proyecto o la red.

En esta guíaProtocolo de tooling
Primeros pasosEstructura del proyectoReferencia del CLIBucle de desarrolloBuilds incrementalesRouting y páginasVistas RustEventos y foldsSchemas y snapshotsSync verificado con HyphaeContenido tipadoRuntime del navegadorPropiedad del DOMPreview del runtime nativoDespliegue portableBeta full-stackPreview de OpenSDKComponentes y lenguajesConformidad de frameworks webProtocolo de toolingCompatibilidad y deprecaciónAssets adaptativosConfianza de artefactosConfianza de releasesEvidencia de rendimientoErrores y diagnósticosTelemetría voluntariaBuild y despliegueCrates y APILicenciamiento y políticas

Un plano de tooling limitado

El host de tooling OpenSDK usa JSON-RPC 2.0 delimitado por líneas sobre entrada y salida estándar. Los editores negocian mediante pliego/handshake; el adapter MCP de referencia expone el mismo handshake de capabilities después de completar el lifecycle de inicialización MCP 2025-11-25.

OpenSDK
0.4.0-beta.1
JSON-RPC
2.0 sobre mensajes delimitados por líneas y limitados
MCP
Superficie del cliente de referencia 2025-11-25

Negocia antes de diagnósticos

shell
cargo run -p pliego-cli --locked -- sdk tooling-host \
  --protocol pliego \
  --feature diagnostic-links

El handshake nativo debe incluir protocolVersion 0.4.0-beta.1. Las versiones ausentes o incompatibles fallan antes de que esté disponible cualquier método de diagnóstico o proyecto.

MCP es un cliente, no un privilegio

shell
cargo run -p pliego-cli --locked -- sdk tooling-host \
  --protocol mcp \
  --feature diagnostic-links
npm run check:opensdk:tooling

El cliente MCP no recibe filesystem root, acceso de red, sampling, elicitation ni capability de proyecto implícitos. Su tool de referencia acepta únicamente el objeto vacío declarado por su schema y no puede evadir la política de admisión OpenSDK.

Falla con límites estructurados

El host acepta como máximo 10.000 requests por proceso y 1 MiB por línea JSON. Versiones JSON-RPC inválidas, campos desconocidos, versiones MCP incompatibles, llamadas previas a initialization, métodos desconocidos y tools desconocidos retornan errores estructurados; las notifications no producen respuesta.