Dexyd DevelopersAPI, webhooks et assistants IA
MCP Dexyd

Connectez Oria et vos assistants IA au contexte Dexyd autorisé.

MCP permet à Oria ou à vos assistants IA de comprendre l’activité Dexyd, retrouver les bonnes informations, préparer des actions et accompagner les utilisateurs sans perdre le contrôle sur les décisions sensibles.

ContexteContexte Dexyd exploitable.
ActionsActions mieux préparées.
ValidationValidation gardée par l’utilisateur.

Recherche

Retrouvez concours, talents et projets depuis une demande naturelle.

Pilotage

Suivez l’activité sans parcourir tous les menus.

Préparation

Créez et améliorez plus vite, sans partir d’une page vide.

Personnalisation

Adaptez l’expérience depuis une simple demande.

Progression

Aidez les participants à monter en compétence.

Contrôle

Gardez la validation finale dans Dexyd.

Endpoint

Appeler Dexyd MCP

Le serveur MCP Dexyd parle JSON-RPC sur HTTP POST. Il accepte initialize, tools/list et tools/call.

POST /api/agent/mcp
Endpoint unique du serveur MCP.
Authentification
Authorization: Bearer <clé développeur>

Le scope agent:mcp est requis.

Méthodes
initialize, tools/list, tools/call.
Batch
Un tableau de requêtes JSON-RPC est accepté.
Lister les outils
curl "https://www.dexyd.com/api/agent/mcp" \
  -H "Authorization: Bearer dxyd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
Outils

Outils MCP disponibles

Chaque outil a un schéma d’entrée publié par tools/list. Les outils d’écriture ne modifient pas Dexyd directement.

dexyd_context
Retourne un contexte compact avec recherche, médias et état des intégrations.
dexyd_search
Recherche concours, participations et profils créateurs.
dexyd_media_feed
Lit le flux média Dexyd.
dexyd_import_media
Importe une URL publique ou Google Drive/Docs.

Scope media:import.

dexyd_prepare_competition_draft
Prépare un brouillon de concours à confirmer.

Scopes agent:mcp et drafts:write.

dexyd_prepare_expo_product_draft
Prépare un brouillon de produit Expo à confirmer.

Scopes agent:mcp et drafts:write.

dexyd_prepare_profile_bio_update
Prépare une mise à jour de bio publique.

Scopes agent:mcp et drafts:write.

Appeler un outil
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "dexyd_prepare_competition_draft",
    "arguments": {
      "title": "Challenge prototype",
      "description": "Brief public du concours",
      "submission_end": "2026-07-31T23:59:00Z"
    }
  }
}
Contrôle

Brouillons confirmables

Les outils de préparation renvoient confirmation_required=true avec un pending_action. L’utilisateur décide ensuite si l’action doit être envoyée dans Dexyd.

create_competition
Prépare un payload pour /api/competitions.
create_expo_product
Prépare un payload pour /api/expo-products.
update_profile
Prépare uniquement le champ bio du profil.
  • Les champs d’identité, email, téléphone, avatar et localisation ne sont pas modifiés par l’outil bio.
Erreurs

Codes MCP et HTTP

Les erreurs JSON-RPC restent dans la réponse MCP; les erreurs d’accès utilisent les statuts HTTP habituels.

-32700
JSON invalide.
-32601
Méthode JSON-RPC inconnue.
-32000
Erreur renvoyée par l’outil appelé.
401 / 403 / 402
Clé absente, scope insuffisant ou plan non autorisé.