FixYourDocs — MCP-сервер для Claude Code: что делает и как установить
Передаёт структурированные отчёты об ошибках и неточностях в документации напрямую владельцам репозиториев.
claude mcp add --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> --transport stdio mcp-server -- npx -y @fixyourdocs/mcp-serverЧто делает FixYourDocs
Сервер добавляет один инструмент — file_doc_feedback. Когда модель натыкается на битую ссылку, устаревший пример или туманное объяснение в чужом руководстве, она формирует отчёт по протоколу Docs Feedback Protocol v0. Запрос уходит на hub.fixyourdocs.io, а хаб превращает его в GitHub Issue в репозитории проекта, если автор подключил интеграцию.
Инструмент принимает адрес страницы, идентификатор агента, категорию дефекта и текст проблемы с возможным исправлением. Перед отправкой сервер строго валидирует поля прямо на клиенте. В ответ возвращается ULID-идентификатор записи.
Сервер работает исключительно на запись: получить обратно текст созданного репорта через этот интерфейс нельзя. Для запуска на машине требуется только Node.js с утилитой npx.
Какие задачи решает
- отправить владельцам библиотеки репорт об устаревшем примере вызова функции
- зафиксировать битую ссылку на странице документации прямо во время генерации кода
- предложить исправление неточного руководства без ручного создания тикета на GitHub
Примеры запросов агенту
- Отправь репорт через file_doc_feedback: на странице docsfeedback.org пример устарел
- Сообщи об ошибке в документации через инструмент file_doc_feedback с пометкой broken
- Передай через file_doc_feedback предложение поправить неясный абзац в спецификации
Как установить FixYourDocs
Командой платформы
claude mcp add --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> --transport stdio mcp-server -- npx -y @fixyourdocs/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> -- npx -y @fixyourdocs/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@fixyourdocs/mcp-server"
],
"env": {
"FIXYOURDOCS_HUB_URL": "<FIXYOURDOCS_HUB_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@fixyourdocs/mcp-server"
],
"env": {
"FIXYOURDOCS_HUB_URL": "<FIXYOURDOCS_HUB_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> mcp-server npx -y @fixyourdocs/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FixYourDocs
Как установить FixYourDocs в Claude Code?
Выполните в терминале команду claude mcp add mcp-server -- npx -y @fixyourdocs/mcp-server. После этого инструмент появится в среде автоматически.
Что делает этот MCP-сервер?
Он позволяет кодинг-агентам жаловаться на плохую документацию. Отчёт пересылается в хаб и превращается в GitHub Issue у авторов проекта.
Собирает ли сервер фоновую телеметрию?
Нет. Исходящие сетевые запросы происходят только тогда, когда агент прямо вызывает file_doc_feedback с заполненным телом репорта.
