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 за слагом; посилання всередині документа переписано на абсолютні URL-адреси сайту.
`list_config`	`locale` (необов’язковий, типово `en`)	Перелічує всі змінні середовища OxPHP з їхніми типовими значеннями й описами, згрупованими за категоріями. Використовуйте його замість того, щоб вгадувати ключі конфігурації.

locale приймає en, ru, zh, fr, pl, ja або uk; будь-яке інше значення зводиться до en. slug — це точний рядок, який повідомляє запис list_docs, наприклад getting-started/quick-start.

Note

read_doc не додає нижній колонтитул з покажчиком, який має .md-двійник цієї сторінки, — для решти корпусу викликайте list_docs.

Лише читання й анонімність

Сервер нічого не записує і не звертається до жодної власної моделі: він лише віддає Markdown і дані конфігурації, які цей сайт уже публікує. Йому не потрібні ні API-ключ, ні вхід: кожен запит анонімний. Сесія зберігає тільки рукостискання протоколу, не пов’язана з жодною особою і видаляється через 15 хвилин після останнього виклику.

Обмеження

Кількість запитів обмежено для кожної IP-адреси: 120 викликів за 5 хвилин і 2 000 на добу. Типова сесія агента — один list_docs, а за ним кілька викликів read_doc — використовує лише невелику частку цього ліміту. Після перевищення ліміту виклик повертає помилку замість результату, доки не почнеться нове вікно.