Docs

Servidor MCP

sigillo habla el Model Context Protocol mediante Streamable HTTP. Endpoint y autenticación:

Endpoint:  POST https://sigillo.ch/mcp
Auth:      Authorization: Bearer sig_…
Protocol:  MCP 2025-06-18

Conexión

Claude Desktop / Claude Code / ChatGPT

Configuración del servidor con transporte Streamable-HTTP:

{
  "mcpServers": {
    "sigillo": {
      "transport": "streamable-http",
      "url":  "https://sigillo.ch/mcp",
      "auth": { "type": "bearer", "token": "sig_…" }
    }
  }
}

Clientes solo-stdio (bridge)

Los clientes sin transporte HTTP usan el bridge stdio, que reenvía al endpoint HTTP:

docker run -i --rm \
  -e SIGILLO_TOKEN=sig_… \
  ghcr.io/kardungla/sigillo-mcp-stdio:latest

Opcional: SIGILLO_URL (predeterminado https://sigillo.ch/mcp), SIGILLO_TRACE=1 para logs de depuración a stderr.

Tools

seal_pdfseal:write

Sella un PDF. Modos: timestamp (sync, 1 crédito), on_demand (QES vía Mobile-ID, 5), mab (multifirmante, 5/firmante).

seal_statusseal:read

Estado de una operación asíncrona (on_demand/mab).

seal_downloadseal:read

PDF sellado de una operación completada (Base64).

seal_balanceseal:read

Saldo de créditos + coste por modo.

Flujo típico (QES)

1. seal_pdf   {mode:"on_demand", pdf_base64, filename, signer, msisdn}
              → {request_id, status:"pending"}
2. seal_status {request_id}   (wiederholen / repeat)
              → {status:"completed"}
3. seal_download {request_id}
              → {sealed_pdf_b64}

Un token de solo lectura (seal:read) puede consultar estado/descarga/saldo pero no sellar. Lista de herramientas en cualquier momento mediante la llamada JSON-RPC tools/list.