Serwer MCP

Ta strona uruchamia publiczny serwer Model Context Protocol (MCP) pod adresem https://oxphp.dev/mcp. Skieruj na niego agenta kodującego, a będzie mógł czytać tę samą dokumentację, którą właśnie czytasz — slugi stron, pełną treść stron oraz spis zmiennych środowiskowych — zamiast zgadywać nazwy API albo opierać się na nieaktualnych danych treningowych.

Podłączenie

Endpoint mówi po Streamable HTTP: pojedyncze POST /mcp, bez transportu stdio. Większości klientów wystarczy sam URL.

bash

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

Każdy klient odczytujący blok mcpServers — Claude Desktop, Cursor i inne — przyjmuje tę samą postać:

mcp.json

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

Wklej to agentowi, który potrafi edytować własną konfigurację MCP — serwer doda sobie sam:

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.

Nie działa to wszędzie. Wielu agentów potrafi korzystać z serwera MCP, ale nie potrafi dopisać go do własnej konfiguracji na podstawie wiadomości na czacie — jedni mówią to wprost, inni twierdzą, że dodali, a na liście narzędzi nic się nie pojawia.

Narzędzia

Trzy narzędzia, wszystkie tylko do odczytu:

Narzędzie	Parametry	Opis
`list_docs`	`locale` (opcjonalny, domyślnie `en`)	Zwraca listę wszystkich stron dokumentacji OxPHP: slug, tytuł i opis. Wywołaj go jako pierwszy, aby poznać slugi akceptowane przez `read_doc`.
`read_doc`	`slug` (wymagany), `locale` (opcjonalny, domyślnie `en`)	Zwraca pełny Markdown strony dokumentacji OxPHP po slugu, z linkami przepisanymi na bezwzględne adresy URL witryny.
`list_config`	`locale` (opcjonalny, domyślnie `en`)	Zwraca listę wszystkich zmiennych środowiskowych OxPHP wraz z wartością domyślną i opisem, pogrupowaną według kategorii. Użyj tego zamiast zgadywać klucze konfiguracji.

locale przyjmuje en, ru, zh, fr, pl lub ja; każda inna wartość spada z powrotem do en. slug to dokładny ciąg znaków zwracany przez wpis list_docs, na przykład getting-started/quick-start.

Note

read_doc pomija stopkę-indeks, którą niesie .md-bliźniak tej strony — po resztę korpusu sięgnij po list_docs.

Tylko do odczytu i anonimowo

Serwer niczego nie zapisuje i sam nie wywołuje żadnego modelu — jedynie udostępnia Markdown i dane konfiguracyjne, które ta witryna i tak publikuje. Nie potrzeba klucza API ani logowania: każde żądanie jest anonimowe. Sesja nie przechowuje niczego poza stanem handshake'u protokołu, nie jest powiązana z żadną tożsamością i znika 15 minut po ostatnim wywołaniu.

Limity

Żądania są ograniczone per adres IP: 120 wywołań na 5 minut i 2000 na dobę. Typowa sesja agenta — list_docs i kilka wywołań read_doc — zużywa tylko ułamek tej puli. Po przekroczeniu limitu wywołanie zwraca błąd zamiast wyniku, dopóki okno się nie zresetuje.