Aller au contenu principal

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).

Différence avec l’API publique et l’Assistant
  • L’API publique /public reste 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
Healthhttps://mcp.wast-o.com/health
Protected Resource Metadatahttps://mcp.wast-o.com/.well-known/oauth-protected-resource
AS Metadatahttps://api.wast-o.com/.well-known/oauth-authorization-server
Authorizehttps://api.wast-o.com/oauth/authorize
Token OAuthhttps://api.wast-o.com/oauth/token
DCRPOST https://api.wast-o.com/oauth/register
Consent UIhttps://console.wast-o.com/oauth/connecto/authorize
Qui suis-jeGET https://api.wast-o.com/oauth/me

Modes d’auth​

A. Agent interactif (Cursor) — DCR + PKCE​

  1. Le client MCP découvre l’AS via Protected Resource Metadata.
  2. DCR (POST /oauth/register) → client_id public.
  3. GET /oauth/authorize (PKCE) → redirection vers la page consent console.
  4. L’utilisateur se connecte (si besoin), choisit un CityGroup avec MCP, confirme.
  5. Redirect code → échange token → Bearer sur /mcp.

B. Machine / SI — client_credentials​

  1. Console Wast-O → Paramètres → MCP.
  2. Activer le module MCP sur le groupement (si besoin).
  3. Nouveau client → copier client_id / client_secret (secret affiché une seule fois).
  4. 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.

attention

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) :

VariableRôle
WASTO_API_URLhttps://api.wast-o.com
WASTO_CLIENT_IDclient_id machine MCP
WASTO_CLIENT_SECRETsecret
WASTO_MCP_RESOURCE_URLResource PRM (défaut https://mcp.wast-o.com/mcp)

API / console :

VariableRôle
API_PUBLIC_URL / OAUTH_ISSUERIssuer AS
CONSOLE_PUBLIC_URLURL page consent

Tools MCP (liste actuelle)​

Serveur MCP nommé wasto-connect (apps/wasto-mcp). Outils enregistrés :

Contexte & villes​

ToolRôle
wasto_whoamiIdentité (OAuth ou mode public-read)
wasto_get_contextContexte actif (groupement / ville)
wasto_list_city_groupsGroupements accessibles
wasto_set_active_city_groupFixer le groupement actif
wasto_set_active_cityFixer la ville active
cities_listLister les villes
cities_getDétail d’une ville

Lecture métier​

ToolRôle
waste_types_listTypes de déchets
collection_places_listLieux / calendriers de collecte
recycling_points_listCentres de tri
challenges_list / challenge_getDéfis
surveys_list / surveys_overview / survey_responses_summaryEnquêtes agrégées (sans PII)
field_reports_summarySignalements agrégés
media_folders_list / media_list / media_search / media_getBibliothèque médias collectivité (pas le Catalogue Wast'O)

Écritures (scope wasto.mcp.write)​

ToolRôle
waste_type_upsertType de déchet
waste_type_detail_upsertMatériau / exemple d’un type
recycling_point_upsertCentre de tri
challenge_upsertChallenge

→ 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éthodePathNotes
POST/oauth/mcp/waste-types/upsertdryRun / confirm
POST/oauth/mcp/waste-type-details/upsertmatériaux / exemples
POST/oauth/mcp/recycling-points/upsertdryRun / confirm
POST/oauth/mcp/challenges/upsertdryRun / confirm
GET/oauth/mcp/surveysmétadonnées
GET/oauth/mcp/surveys/overviewcompteurs
GET/oauth/mcp/surveys/:id/statsstats choix/notes — pas de texte libre
GET/oauth/mcp/field-reports/summarycompteurs par statut
GET/oauth/mcp/media/foldersdossiers biblio collectivité
GET/oauth/mcp/medialiste / recherche (folderId, tag, q)
GET/oauth/mcp/media/:idfiche — refuse Catalogue / autre tenant

Sécurité & offre​

  • Binding hard : un client = un cityGroupId.
  • Module dashboard CONNECTO obligatoire pour émettre / utiliser un client.
  • Hors offre gratuite self-serve (ADR-001).
  • Révocation immédiate depuis la console.

Voir aussi​