MCP, REST e auth
54 strumenti MCP, Streamable HTTP, REST v1 e OAuth 2.1.
VeloStack offre tre percorsi di integrazione: VeloConnect per ERP, REST per applicazioni proprie e MCP per client AI.
MCP
L'endpoint MCP è su /mcp e parla Streamable HTTP (MCP spec 2025-06-18), stateless. Auth tramite bearer token: API token, OIDC JWT o token OAuth 2.1.
Gruppi di strumenti
| Gruppo | Numero |
|---|---|
| Catalog | 24 |
| Mapping | 13 |
| Sync / stats | 6 |
| Admin | 2 |
| Receipts | 5 |
| Quality / sourcing / supplier terms | 4 |
OAuth 2.1
L'authorization server integrato supporta discovery, dynamic client registration (RFC 7591), PKCE-S256, refresh token rotation con replay detection e revocation (RFC 7009). I token funzionano in parallelo su /mcp e /api/v1.
REST v1
L'API REST è su /api/v1, si documenta via OpenAPI/Swagger e usa bearer token (vcapi_…) o OIDC JWT. Scope: read e write.
curl https://veloconnect.velostack.eu/health
curl -H "Authorization: Bearer vcapi_..." \
https://veloconnect.velostack.eu/api/v1/models?limit=10