Serveur MCP

Ce site fait tourner un serveur Model Context Protocol (MCP) public à l'adresse https://oxphp.dev/mcp. Pointez-y un agent de codage, et il pourra lire la même documentation que celle que vous lisez en ce moment — slugs des pages, contenu complet des pages, et référence des variables d'environnement — au lieu de deviner des noms d'API ou de s'appuyer sur des données d'entraînement obsolètes.

Connexion

L'endpoint parle en Streamable HTTP : un seul POST /mcp, pas de transport stdio. La plupart des clients n'ont besoin que de l'URL.

bash

claude mcp add --transport http oxphp-docs https://oxphp.dev/mcp

Tout client qui lit un bloc mcpServers — Claude Desktop, Cursor, et d'autres — accepte la même forme :

mcp.json

{
  "mcpServers": {
    "oxphp-docs": {
      "type": "http",
      "url": "https://oxphp.dev/mcp"
    }
  }
}

Collez ceci dans un agent capable de modifier sa propre configuration MCP : il ajoutera le serveur lui-même.

text

Add an MCP server named "oxphp-docs" to your configuration: transport HTTP
(Streamable HTTP), URL https://oxphp.dev/mcp, no authentication. It is a
public, read-only documentation server for OxPHP with three tools —
list_docs, read_doc and list_config. Use it whenever a question touches
OxPHP documentation or the name or default value of an environment
variable, instead of answering from memory.

Cela ne marche pas partout. Beaucoup d'agents savent se servir d'un serveur MCP mais ne savent pas en ajouter un à leur propre configuration depuis un message de conversation — certains le disent franchement, d'autres affirment l'avoir fait alors que rien n'apparaît dans leur liste d'outils.

Outils

Trois outils, tous en lecture seule :

Outil	Paramètres	Description
`list_docs`	`locale` (facultatif, `en` par défaut)	Liste chaque page de documentation OxPHP : slug, titre et description. Appelez-le en premier pour connaître les slugs acceptés par `read_doc`.
`read_doc`	`slug` (obligatoire), `locale` (facultatif, `en` par défaut)	Renvoie le Markdown complet d'une page de documentation OxPHP par son slug, avec les liens internes réécrits en URL absolues du site.
`list_config`	`locale` (facultatif, `en` par défaut)	Liste chaque variable d'environnement OxPHP, avec sa valeur par défaut et sa description, groupées par catégorie. À utiliser plutôt que de deviner les clés de configuration.

locale accepte en, ru, zh, fr, pl ou ja ; toute autre valeur retombe sur en. slug est la chaîne exacte renvoyée par une entrée de list_docs, par exemple getting-started/quick-start.

Note

read_doc omet le pied de page d'index que porte le jumeau .md de cette page — appelez list_docs pour parcourir le reste du corpus.

Lecture seule et anonyme

Le serveur n'écrit jamais rien et n'appelle lui-même aucun modèle — il ne fait que servir le Markdown et les données de configuration que ce site publie déjà. Aucune clé d'API ni connexion requise : chaque requête est anonyme. Une session ne retient que l'état du handshake du protocole, n'est liée à aucune identité, et disparaît 15 minutes après son dernier appel.

Limites

Les requêtes sont plafonnées par adresse IP : 120 appels toutes les 5 minutes, et 2 000 par jour. Une session d'agent typique — un list_docs suivi de quelques appels à read_doc — n'en utilise qu'une fraction. Au-delà de la limite, un appel renvoie une erreur au lieu d'un résultat, jusqu'à la réinitialisation de la fenêtre.