BGB Formation : documentation MCP publique

Cette documentation décrit le serveur MCP public de BGB Formation, en lecture seule. Il permet de lire la présentation et les liens déjà publiés sur le site. Les échanges JSON-RPC suivent le protocole MCP ; cette page ne documente pas une API REST métier. Aucun accès aux comptes, dossiers ou inscriptions n'est proposé.

Lire l'accueil en Markdown

Une requête sur la même URL sélectionne le format grâce à l'en-tête Accept. Les réponses indiquent leur format et l'en-tête Vary: Accept, User-Agent.

curl -i -H 'Accept: text/markdown' https://bgbformation.fr/
curl -i -H 'Accept: text/html' https://bgbformation.fr/

Une URL de page inexistante demandée en Markdown renvoie HTTP 404 avec une explication et des liens de reprise. Les pages existantes conservent leurs URL et leurs modalités d'accès.

Consignes et découverte

Consignes llms.txt : cas d'usage, ressources et coordonnées publiques.
Consignes d'utilisation des ressources publiques : quand utiliser BGB Formation, méthode de consultation et limites pour les agents ; AGENTS.md conduit au même document public.
Index Agent Skills de BGB Formation : métadonnées et empreinte SHA-256 de la compétence publique de consultation, générée depuis les mêmes consignes.
Description du serveur MCP : métadonnées et adresse de connexion.
Sitemap XML et plan du site : retrouver les pages publiées.
Politique de confidentialité.

Serveur MCP public

Version de protocole prise en charge : 2025-11-25, négociée à l'initialisation par le SDK officiel.

Adresse : https://bgbformation.fr/mcp. Transport : Streamable HTTP. Les lectures publiques ne demandent pas de clé. Les messages MCP utilisent POST et le format JSON-RPC du protocole ; un client annonce les formats application/json et text/event-stream. Le serveur fonctionne sans session persistante. Il ne propose pas de canal de notifications SSE autonome : GET et DELETE renvoient HTTP 405.

{
  "mcpServers": {
    "bgbformation": {
      "url": "https://bgbformation.fr/mcp"
    }
  }
}

La forme de la configuration dépend du client MCP. Dans un client qui propose un champ d'adresse de serveur distant, renseigner l'adresse ci-dessus puis lancer la connexion.

Deux outils et deux ressources

Après initialize, utiliser tools/list pour obtenir les noms, descriptions, annotations de lecture seule et schémas JSON des outils. Tous deux acceptent uniquement un objet vide {}, sans paramètre requis ni propriété supplémentaire :

{ "type": "object", "properties": {}, "additionalProperties": false }

bgb_presentation : lire la présentation publique issue de l'accueil, en Markdown.
bgb_ressources : lire les consignes et liens publics du fichier llms.txt, en texte brut.

resources/list expose les mêmes documents sous forme de ressources. Lire leur contenu avec resources/read et l'URI exacte :

bgb_accueil : https://bgbformation.fr/, type text/markdown.
bgb_ressources_publiques : https://bgbformation.fr/llms.txt, type text/plain.

Exemples de messages JSON-RPC après l'initialisation du client MCP :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "bgb_presentation", "arguments": {} } }
{ "jsonrpc": "2.0", "id": 3, "method": "resources/list", "params": {} }
{ "jsonrpc": "2.0", "id": 4, "method": "resources/read", "params": { "uri": "https://bgbformation.fr/llms.txt" } }

Erreurs et méthodes HTTP

GET et DELETE renvoient HTTP 405, avec l'en-tête Allow: POST, OPTIONS et le corps JSON {"error":"Méthode non autorisée."}. Le serveur n'ouvre pas de canal SSE autonome et ne conserve pas de session.

Les contrôles du serveur renvoient aussi un objet JSON avec une propriété error : HTTP 403 pour un domaine, une origine ou un en-tête de préparation CORS non autorisé ; HTTP 413 pour un corps dépassant 64 Kio ; HTTP 500 si le service MCP est temporairement indisponible. Aucun détail interne n'est exposé.

Le SDK renvoie les erreurs de protocole en JSON-RPC : un JSON invalide donne HTTP 400 et le code -32700 ; une méthode inconnue donne HTTP 200 avec error.code: -32601. Un en-tête Accept incomplet donne HTTP 406, un Content-Type autre que application/json donne HTTP 415 et une version de protocole invalide donne HTTP 400. Un appel d'outil refusé peut renvoyer isError: true : vérifier le résultat même lorsque HTTP vaut 200.

Périmètre des contenus pédagogiques

Les pages et articles sur Claude Code, les API d'éditeurs, les sous-agents ou les hooks concernent les outils enseignés dans les formations. Ils ne décrivent pas des fonctions supplémentaires du serveur MCP BGB et ne constituent pas une interface de gestion du site. BGB Formation ne publie pas d'outil en ligne de commande pour gérer ses formations.

Ces outils n'inscrivent personne, n'envoient aucun message et ne modifient aucune donnée. Les prix, dates, prérequis et possibilités de financement sont à confirmer sur le programme ou la proposition correspondante.

Il n'existe pas d'API publique d'inscription ou de dossier documentée ici. Pour une demande de formation, utiliser les informations de la page de contact.