I tuoi dati, in qualsiasi host MCP.
Wombat MCP Bridge espone l'API REST di WOMBATpass come strumenti Model Context Protocol per gli assistenti IA. Chiedi a Claude di elencare le esecuzioni, esaminare i risultati o esplorare i dati di conformità, tutto con la stessa sessione SSO e gli stessi permessi basati sui ruoli di cui già ti fidi.
Un bridge sicuro, non un secondo sistema di autenticazione.
Il bridge riutilizza identità, permessi e audit trail di WOMBATpass. Valida, fa da proxy e filtra, senza mai memorizzare segreti cloud o password dell'IdP.
Indipendente dall'IdP
Nessuna integrazione diretta con Keycloak, Entra o Okta. Il bridge si fida dei token emessi da wafpass-server, che gestisce già i flussi OIDC e SAML.
Introspezione dei token
Ogni nuova connessione SSE viene validata tramite GET /auth/me. Rilevamento immediato delle revoche e nessuna condivisione di segreti JWT.
Strumenti a privilegio minimo
tools/list viene filtrato in base al ruolo dell'utente autenticato. Gli endpoint riservati agli amministratori restano invisibili agli ingegneri e l'autorizzazione per riga si applica a ogni chiamata al backend.
Propagazione del contesto
L'header originale Authorization: Bearer viene inoltrato a WOMBATpass a ogni richiesta, preservando l'identità dell'utente e l'attribuzione negli audit.
Generato da OpenAPI
All'avvio il bridge recupera /openapi.json e registra le operazioni sicure come strumenti MCP tipizzati con argomenti validati da Pydantic.
stdio o SSE
Esegui il bridge come processo stdio locale per Claude Desktop oppure esponilo via HTTP/SSE per host MCP remoti e client basati su browser.
Collega Claude Desktop in pochi minuti.
Installa il bridge, accedi una volta e punta Claude Desktop al comando stdio. Nessun certificato, nessuna porta aperta, nessuna autenticazione aggiuntiva.
git clone https://github.com/WAF2p/wafpass-mcp.git
cd wafpass-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
wafpass-mcp-configure
# Enter WOMBATpass API URL, username and password{
"mcpServers": {
"wafpass": {
"command": "/path/to/wombatpass-mcp/.venv/bin/wafpass-mcp-stdio"
}
}
}# From the Wombat repository root
docker compose up -d wafpass-mcp
docker compose logs -f wafpass-mcp
# SSE endpoint: http://localhost:3001/sse
# Override WAFPASS_TOKEN_MODE or WAFPASS_JWT_SECRET in .envCome si inserisce il bridge.
L'utente si autentica tramite l'IdP a monte, scambia i token con WOMBATpass e porta lo stesso token Bearer all'host MCP. Il bridge inoltra le richieste e filtra gli strumenti per ruolo.
| Variabile | Predefinito | Descrizione |
|---|---|---|
WAFPASS_API_BASE_URL | http://localhost:8000 | API WOMBATpass a monte. |
WAFPASS_TOKEN_MODE | introspection | introspection oppure jwt_secret per HS256 in locale. |
WAFPASS_JWT_SECRET | nessuno | Obbligatorio per la modalità jwt_secret ; deve corrispondere al backend. |
WAFPASS_ACCESS_TOKEN | nessuno | Token Wombat per la modalità stdio; facoltativo se salvato dall'helper di configurazione. |
WAFPASS_REFRESH_TOKEN | nessuno | Refresh token per il rinnovo automatico dell'access token in modalità stdio. |
WAFPASS_REFRESH_THRESHOLD_SECONDS | 300 | Rinnova l'access token se scade entro questo numero di secondi. |
MCP_HOST | 0.0.0.0 | Host di ascolto del bridge in modalità HTTP/SSE. |
MCP_PORT | 3001 | Porta di ascolto del bridge in modalità HTTP/SSE. |
LOG_LEVEL | INFO | Livello di log. |
Porta l'IA nel tuo flusso di lavoro.
Installa il bridge da PyPI o GitHub, collegalo a Claude Desktop e inizia a fare domande in linguaggio naturale su esecuzioni, risultati e controlli.