Dokumentation

MCP-Server

sigillo spricht das Model Context Protocol über Streamable HTTP. Endpunkt und Authentifizierung:

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

Verbinden

Claude Desktop / Claude Code / ChatGPT

Server-Konfiguration mit Streamable-HTTP-Transport:

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

stdio-only-Clients (Bridge)

Clients ohne HTTP-Transport nutzen die stdio-Bridge, die auf den HTTP-Endpunkt weiterleitet:

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

Optional: SIGILLO_URL (Default https://sigillo.ch/mcp), SIGILLO_TRACE=1 für Debug-Logs nach stderr.

Tools

seal_pdfseal:write

Versiegelt eine PDF. Modi: timestamp (sync, 1 Credit), on_demand (QES via Mobile-ID, 5), mab (Multi-Signer, 5/Signer).

seal_statusseal:read

Status eines async Vorgangs (on_demand/mab).

seal_downloadseal:read

Versiegelte PDF eines abgeschlossenen Vorgangs (Base64).

seal_balanceseal:read

Credit-Stand + Kosten je Modus.

Typischer Ablauf (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}

Ein read-only-Token (seal:read) kann Status/Download/Balance abfragen, aber nicht versiegeln. Manuelle Tool-Liste jederzeit via tools/list-JSON-RPC-Call.