Je data, in elke MCP-host.

Wombat MCP Bridge stelt de WOMBATpass REST-API beschikbaar als Model Context Protocol-tools voor AI-assistenten. Vraag Claude om runs op te sommen, bevindingen te bekijken of compliancedata te verkennen — allemaal via dezelfde SSO-sessie en rolgebaseerde rechten die je al vertrouwt.

MCP SSE stdio OIDC pass-through Filtering op rol Gegenereerd uit OpenAPI Token-introspectie
v0.1.2
PyPI-release
113+
Beschikbare tools
2
Transporten
0
Extra inloggegevens nodig

Een veilige bridge, geen tweede authenticatiesysteem.

De bridge hergebruikt identiteit, rechten en audittrails van WOMBATpass. Hij valideert, proxyt en filtert, en slaat nooit cloudsecrets of IdP-wachtwoorden op.

IdP-agnostisch

Geen directe integratie met Keycloak, Entra of Okta. De bridge vertrouwt tokens die zijn uitgegeven door wafpass-server, dat OIDC- en SAML-flows al afhandelt.

Token-introspectie

Elke nieuwe SSE-verbinding wordt gevalideerd via GET /auth/me. Directe detectie van intrekkingen en geen gedeelde JWT-secrets nodig.

Tools volgens least privilege

tools/list wordt gefilterd op de rol van de ingelogde gebruiker. Endpoints die alleen voor beheerders zijn, blijven onzichtbaar voor engineers, en autorisatie op rijniveau geldt bij elke backendaanroep.

Contextdoorgifte

De oorspronkelijke Authorization: Bearer -header wordt bij elk doorgestuurd verzoek naar WOMBATpass meegestuurd, zodat gebruikersidentiteit en audittoewijzing behouden blijven.

Gegenereerd uit OpenAPI

Bij het opstarten haalt de bridge /openapi.json op en registreert veilige operaties als getypeerde MCP-tools met door Pydantic gevalideerde argumenten.

stdio of SSE

Draai de bridge als lokaal stdio-proces voor Claude Desktop, of stel hem via HTTP/SSE beschikbaar voor externe MCP-hosts en browserclients.

Verbind Claude Desktop binnen enkele minuten.

Installeer de bridge, log één keer in en laat Claude Desktop naar het stdio-commando wijzen. Geen certificaten, geen open poorten, geen extra authenticatie.

1. Installeren en configureren
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
2. Claude Desktop-configuratie (stdio)
{
  "mcpServers": {
    "wafpass": {
      "command": "/path/to/wombatpass-mcp/.venv/bin/wafpass-mcp-stdio"
    }
  }
}
3. Docker Compose (alternatief)
# 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 .env

Hoe de bridge erin past.

De gebruiker authenticeert via de upstream-IdP, wisselt tokens uit met WOMBATpass en brengt hetzelfde Bearer-token naar de MCP-host. De bridge stuurt verzoeken door en filtert tools op rol.

Gebruiker
SSO-login
IdP
Keycloak / Entra
WOMBATpass
wafpass-server
AI-client
MCP host
Bridge
wafpass-mcp
VariabeleStandaardBeschrijving
WAFPASS_API_BASE_URLhttp://localhost:8000Upstream WOMBATpass-API.
WAFPASS_TOKEN_MODEintrospectionintrospection of jwt_secret voor lokale HS256.
WAFPASS_JWT_SECRETgeenVereist voor jwt_secret -modus; moet overeenkomen met de backend.
WAFPASS_ACCESS_TOKENgeenWombat-token voor stdio-modus; optioneel als de configuratiehelper het heeft opgeslagen.
WAFPASS_REFRESH_TOKENgeenRefreshtoken voor het automatisch vernieuwen van het accesstoken in stdio-modus.
WAFPASS_REFRESH_THRESHOLD_SECONDS300Vernieuw het accesstoken als het binnen dit aantal seconden verloopt.
MCP_HOST0.0.0.0Bind-host van de bridge in HTTP/SSE-modus.
MCP_PORT3001Bind-poort van de bridge in HTTP/SSE-modus.
LOG_LEVELINFOLogniveau.

Breng AI in je workflow.

Installeer de bridge via PyPI of GitHub, verbind hem met Claude Desktop en stel vragen in natuurlijke taal over runs, bevindingen en controls.