MCP, REST & Auth
54 MCP-Tools, Streamable HTTP, REST v1 und OAuth 2.1.
VeloStack bietet drei Integrationswege: VeloConnect für ERP-Systeme, REST für eigene Anwendungen und MCP für AI-Clients.
MCP
Der MCP-Endpoint liegt unter /mcp und spricht Streamable HTTP (MCP-Spec 2025-06-18), stateless. Auth per Bearer-Token: API-Token, OIDC-JWT oder OAuth-2.1-Token.
Tool-Gruppen
| Gruppe | Anzahl |
|---|---|
| Catalog | 24 |
| Mapping | 13 |
| Sync / Stats | 6 |
| Admin | 2 |
| Receipts | 5 |
| Quality / Sourcing / Supplier-Terms | 4 |
OAuth 2.1
Der eingebaute Authorization-Server unterstützt Discovery, Dynamic Client Registration (RFC 7591), PKCE-S256, Refresh-Token-Rotation mit Replay-Erkennung und Revocation (RFC 7009). Tokens funktionieren parallel an /mcp und /api/v1.
REST v1
Die REST-API liegt unter /api/v1, dokumentiert sich per OpenAPI/Swagger und nutzt Bearer-Tokens (vcapi_…) oder OIDC-JWT. Scopes: read und write.
curl https://veloconnect.velostack.eu/health
curl -H "Authorization: Bearer vcapi_..." \
https://veloconnect.velostack.eu/api/v1/models?limit=10