MCP — serveur & OAuth
Le serveur MCP Wast'O (https://mcp.wast-o.com) expose les données aux agents (Cursor, automatisations SI), authentifié en OAuth2 (client_credentials ou DCR / PKCE).
- L’API publique
/publicreste anonyme et lecture seule citoyenne. - Le MCP = credentials machine liés à un
cityGroupId, scopes, audit, écritures bornées optionnelles, tools. - L’Assistant = chat citoyen (ASSIST'O), pas le MCP.
Endpoints
| URL | |
|---|---|
| MCP (Streamable HTTP) | https://mcp.wast-o.com/mcp |
| Health | https://mcp.wast-o.com/health |
| Protected Resource Metadata | https://mcp.wast-o.com/.well-known/oauth-protected-resource |
| AS Metadata | https://api.wast-o.com/.well-known/oauth-authorization-server |
| Authorize | https://api.wast-o.com/oauth/authorize |
| Token OAuth | https://api.wast-o.com/oauth/token |
| DCR | POST https://api.wast-o.com/oauth/register |
| Consent UI | https://console.wast-o.com/oauth/connecto/authorize |
| Qui suis-je | GET https://api.wast-o.com/oauth/me |
Modes d’auth
A. Agent interactif (Cursor) — DCR + PKCE
- Le client MCP découvre l’AS via Protected Resource Metadata.
- DCR (
POST /oauth/register) →client_idpublic. GET /oauth/authorize(PKCE) → redirection vers la page consent console.- L’utilisateur se connecte (si besoin), choisit un CityGroup avec MCP, confirme.
- Redirect
code→ échange token → Bearer sur/mcp.
B. Machine / SI — client_credentials
- Console Wast-O → Paramètres → MCP.
- Activer le module MCP sur le groupement (si besoin).
- Nouveau client → copier
client_id/client_secret(secret affiché une seule fois). - Scopes :
wasto.mcp.read(défaut) — lectures référentiel, carto, challenges, terrain agrégé, médias collectivitéwasto.mcp.write— upserts bornés (dry-run par défaut)
Obtenir un access token (machine)
curl -s -X POST https://api.wast-o.com/oauth/token \
-H 'Content-Type: application/json' \
-d '{
"grant_type": "client_credentials",
"client_id": "wasto_cc_…",
"client_secret": "…"
}'
Réponse typique :
{
"access_token": "eyJ…",
"token_type": "Bearer",
"expires_in": 900,
"scope": "wasto.mcp.read"
}
Auth Basic (client_id:client_secret) est aussi acceptée.
Ne pas utiliser un JWT console utilisateur comme credential agent. Les tokens machine ont typ=oauth_cc et sont refusés sur les routes admin JWT.
Brancher Cursor / MCP
Dans ~/.cursor/mcp.json :
{
"mcpServers": {
"wasto-connect": {
"type": "http",
"url": "https://mcp.wast-o.com/mcp"
}
}
}
Cursor découvre OAuth (PRM → AS → DCR), ouvre le navigateur sur la page de consentement MCP (choix CityGroup), puis envoie le Bearer automatiquement.
Variables optionnelles côté serveur wasto-mcp (mode machine sans DCR) :
| Variable | Rôle |
|---|---|
WASTO_API_URL | https://api.wast-o.com |
WASTO_CLIENT_ID | client_id machine MCP |
WASTO_CLIENT_SECRET | secret |
WASTO_MCP_RESOURCE_URL | Resource PRM (défaut https://mcp.wast-o.com/mcp) |
API / console :
| Variable | Rôle |
|---|---|
API_PUBLIC_URL / OAUTH_ISSUER | Issuer AS |
CONSOLE_PUBLIC_URL | URL page consent |
Tools MCP (liste actuelle)
Serveur MCP nommé wasto-connect (apps/wasto-mcp). Outils enregistrés :
Contexte & villes
| Tool | Rôle |
|---|---|
wasto_whoami | Identité (OAuth ou mode public-read) |
wasto_get_context | Contexte actif (groupement / ville) |
wasto_list_city_groups | Groupements accessibles |
wasto_set_active_city_group | Fixer le groupement actif |
wasto_set_active_city | Fixer la ville active |
cities_list | Lister les villes |
cities_get | Détail d’une ville |
Lecture métier
| Tool | Rôle |
|---|---|
waste_types_list | Types de déchets |
collection_places_list | Lieux / calendriers de collecte |
recycling_points_list | Centres de tri |
challenges_list / challenge_get | Défis |
surveys_list / surveys_overview / survey_responses_summary | Enquêtes agrégées (sans PII) |
field_reports_summary | Signalements agrégés |
media_folders_list / media_list / media_search / media_get | Bibliothèque médias collectivité (pas le Catalogue Wast'O) |
Écritures (scope wasto.mcp.write)
| Tool | Rôle |
|---|---|
waste_type_upsert | Type de déchet |
waste_type_detail_upsert | Matériau / exemple d’un type |
recycling_point_upsert | Centre de tri |
challenge_upsert | Challenge |
→ dryRun par défaut ; confirm=true pour commit. Pas de delete.
Endpoints OAuth métier (référence)
Préfixe Bearer OAuth : /oauth/mcp/…
| Méthode | Path | Notes |
|---|---|---|
| POST | /oauth/mcp/waste-types/upsert | dryRun / confirm |
| POST | /oauth/mcp/waste-type-details/upsert | matériaux / exemples |
| POST | /oauth/mcp/recycling-points/upsert | dryRun / confirm |
| POST | /oauth/mcp/challenges/upsert | dryRun / confirm |
| GET | /oauth/mcp/surveys | métadonnées |
| GET | /oauth/mcp/surveys/overview | compteurs |
| GET | /oauth/mcp/surveys/:id/stats | stats choix/notes — pas de texte libre |
| GET | /oauth/mcp/field-reports/summary | compteurs par statut |
| GET | /oauth/mcp/media/folders | dossiers biblio collectivité |
| GET | /oauth/mcp/media | liste / recherche (folderId, tag, q) |
| GET | /oauth/mcp/media/:id | fiche — refuse Catalogue / autre tenant |
Sécurité & offre
- Binding hard : un client = un
cityGroupId. - Module dashboard
CONNECTOobligatoire pour émettre / utiliser un client. - Hors offre gratuite self-serve (ADR-001).
- Révocation immédiate depuis la console.
Voir aussi
- Introduction API publique
- Client SDK
- Guide utilisateur : MCP
- L'Assistant — chat citoyen (distinct du MCP)