← servicialo.com
Implementadores

Implementaciones del protocolo

Distinguimos entre implementación de referencia, compatible, verificada, independiente y experimental. La verificación es manual hoy; una suite de conformance automatizada es parte del roadmap.

Niveles de implementación

referencia

Implementación mantenida por el proyecto que demuestra el protocolo en operación (Coordinalo). No define el protocolo: la fuente normativa es la especificación, sus schemas y el manifest.

compatible

Implementa los perfiles core; declarada por su autor con evidencia de conformance.

verificada

Revisada manualmente por el equipo contra la checklist de conformance.

independiente

Código propio, no derivado de la implementación de referencia.

experimental

En desarrollo o con cobertura parcial.

Implementación de referencia

Coordinalo

referencia

Coordinalo es la implementación de referencia de Servicialo, en producción desde 2026-03-31 (vertical salud). Implementa completo el núcleo estable (Discovery, Coordination, Delivery) y ofrece cobertura parcial o experimental de los perfiles adicionales, según su manifest de conformidad.

🇨🇱Chile
PerfilEstadoCoberturaVerificación
DiscoveryestableCompleta — 12/12 operacionesManual
OrderingexperimentalParcial — 4 de 13 operacionesManual
CoordinationestableCompleta — 12/12 operacionesManual
DeliveryestableCompleta — 2/2 operacionesManual
EvidencecandidataCompleta — 2/2 operacionesManual
SettlementexperimentalCompleta — 3/3 operacionesManual
NetworkexperimentalCompleta — 5/5 operacionesManual

La matriz se deriva de protocol/manifest.yaml (operaciones implementadas vs. especificadas) — no se edita a mano. Conformance: CORE — manual review (2026-06). Automated certification suite: roadmap.

Cómo verificarse

Cualquier operador de una instalación puede, opcionalmente, identificar su implementación configurando tres variables de entorno en su servidor MCP:

SERVICIALO_IMPL_NAME="MyClinic Platform"
SERVICIALO_IMPL_URL="https://myclinic.com"
SERVICIALO_IMPL_CONTACT="admin@myclinic.com"

1. Configura las variables — el siguiente reporte de telemetría incluirá los campos de identidad. El email de contacto se almacena hasheado (SHA-256) y nunca se muestra públicamente.

2. Revisión manual — cuando aparece un nuevo nombre de implementación en la telemetría, el equipo recibe una notificación y revisa manualmente. La verificación es manual hoy — la suite automatizada de conformance es un objetivo del roadmap, no una capacidad actual.

3. Verificación — una vez verificada, tu implementación aparece en esta página con su nivel. Si no configuras las variables, tu instalación permanece completamente anónima.

La guía completa de implementación está en IMPLEMENTING.md y IMPLEMENTORS.md.

Conectar un agente

No necesitas implementar el protocolo para usarlo: un agente puede conectarse a cualquier implementación existente mediante el binding MCP de referencia o el perfil HTTP.

Modo descubrimiento
Sin credenciales — 15 herramientas públicas: buscar organizaciones, listar servicios, consultar disponibilidad
// Sin credenciales — modo descubrimiento
npx -y @servicialo/mcp-server
Modo autenticado
Con credenciales — 40 herramientas en total: agendar, registrar entrega y evidencia, consultar cobros
// Configuración en un cliente MCP (p. ej. Claude Desktop)
{
"mcpServers": {
"servicialo": {
"command": "npx",
"args": ["-y", "@servicialo/mcp-server"],
"env": {
"SERVICIALO_API_KEY": "tu_api_key",
"SERVICIALO_ORG_ID": "tu_org_id"
}
}
}
}
Las credenciales las obtiene cada organización desde la plataforma Servicialo-compatible que utilice.
Superficie HTTP de servicialo.com
Resolver + descubrimiento. El protocolo no prescribe rutas HTTP — el binding normativo es spec/HTTP_PROFILE.md
GET/api/servicialo/manifest
GET/api/servicialo/registry
GET/api/servicialo/resolve/{country}/{org}
POST/api/servicialo/resolve/register
GET/api/servicialo/{org}/services
GET/api/servicialo/{org}/availability
POST/api/servicialo/{org}/book
POST/api/servicialo/{org}/a2a
GET/api/registry/search
GET/api/registry/{verticals|regions|event_types}
GET/api/benchmarks

La verificación es manual: el equipo de Servicialo revisa cada implementación contra la checklist de conformance y exige un contacto válido. Las autodeclaraciones sin evidencia de conformance no se aceptan. Las instalaciones anónimas nunca se listan aquí.