Docs

Serveur MCP

sigillo parle le Model Context Protocol via Streamable HTTP. Endpoint et authentification :

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

Connexion

Claude Desktop / Claude Code / ChatGPT

Configuration serveur avec transport Streamable-HTTP :

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

Clients stdio uniquement (bridge)

Les clients sans transport HTTP utilisent le bridge stdio, qui transfère vers l'endpoint HTTP :

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

Optionnel : SIGILLO_URL (défaut https://sigillo.ch/mcp), SIGILLO_TRACE=1 pour les logs de débogage vers stderr.

Tools

seal_pdfseal:write

Scelle un PDF. Modes : timestamp (sync, 1 crédit), on_demand (QES via Mobile-ID, 5), mab (multi-signataires, 5/signataire).

seal_statusseal:read

Statut d'une opération asynchrone (on_demand/mab).

seal_downloadseal:read

PDF scellé d'une opération terminée (Base64).

seal_balanceseal:read

Solde de crédits + coût par mode.

Déroulé typique (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 jeton en lecture seule (seal:read) peut interroger statut/téléchargement/solde mais ne peut pas sceller. Liste des outils à tout moment via l'appel JSON-RPC tools/list.