MCP-сервер

Этот сайт держит публичный сервер Model Context Protocol (MCP) на https://oxphp.dev/mcp. Направьте на него агента для разработки — и он сможет читать ту же документацию, которую вы читаете прямо сейчас: слаги страниц, полные тексты страниц и справочник переменных окружения — вместо того чтобы угадывать имена API или опираться на устаревшие данные обучения.

Подключение

Эндпоинт работает по Streamable HTTP: один POST /mcp, без транспорта stdio. Большинству клиентов достаточно одного URL.

bash

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

Любой клиент, читающий блок mcpServers — Claude Desktop, Cursor и другие — принимает ту же форму:

mcp.json

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

Вставьте это агенту, который умеет править свою конфигурацию MCP, — сервер он добавит сам:

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.

Работает не везде. Многие агенты умеют пользоваться MCP-сервером, но не умеют дописать его себе в конфигурацию по сообщению в чате — одни так и отвечают, другие говорят, что добавили, а в списке инструментов ничего не появляется.

Инструменты

Три инструмента, все только для чтения:

Инструмент	Параметры	Описание
`list_docs`	`locale` (необязательный, по умолчанию `en`)	Выводит список всех страниц документации OxPHP: слаг, заголовок и описание. Вызовите его первым, чтобы узнать слаги, которые принимает `read_doc`.
`read_doc`	`slug` (обязательный), `locale` (необязательный, по умолчанию `en`)	Возвращает полный Markdown страницы документации OxPHP по слагу, со ссылками, переписанными в абсолютные адреса сайта.
`list_config`	`locale` (необязательный, по умолчанию `en`)	Выводит список всех переменных окружения OxPHP со значением по умолчанию и описанием, сгруппированных по категориям. Используйте это вместо того, чтобы угадывать ключи конфигурации.

locale принимает значения en, ru, zh, fr, pl или ja; любое другое значение откатывается к en. slug — это точная строка, которую сообщает запись list_docs, например getting-started/quick-start.

Note

read_doc не добавляет подвал-указатель, который несёт .md-двойник этой страницы — за остальной частью корпуса обращайтесь к list_docs.

Только для чтения и анонимно

Сервер ничего не записывает и сам не вызывает модель — он лишь отдаёт Markdown и конфигурацию, которые сайт и так публикует. Ключ API и вход не нужны: каждый запрос анонимен. В сессии не хранится ничего, кроме состояния протокольного рукопожатия, она не связана ни с какой личностью и стирается через 15 минут после последнего вызова.

Лимиты

Запросы ограничены по IP-адресу: 120 вызовов за 5 минут и 2000 в сутки. Типичная сессия агента — list_docs и несколько вызовов read_doc — использует малую долю этого запаса. При превышении лимита вызов возвращает ошибку вместо результата, пока окно не сбросится.