Oxynote — MCP-сервер для Claude Code: что делает и как установить
Даёт ИИ-агентам доступ к внутренней базе знаний и живым графикам метрик через протокол MCP. Помогает читать и обновлять страницы документации прямо из чата.
Открыть на GitHubЧто делает Oxynote
Oxynote объединяет документацию сервисов и живые графики Prometheus на одной странице. Внутренние API описываются в двухколоночном формате: с одной стороны поля ответа, с другой — примеры вызовов curl и задержка p99. Сервер запускается в контейнере ghcr.io/oxynote/oxynote:latest, сохраняя данные в volume oxynote_data.
Подключение MCP открывает агенту чтение статей, поиск регламентов и создание черновиков правок. Протокол связывает ассистента с сервисом по адресу https://{host}/core/api/mcp. Это избавляет от ручного поиска графиков в Grafana во время разбора сбоев.
Без рабочего сервера интеграция бесполезна: вместо плейсхолдера {host} необходимо указать реальный адрес вашего хоста.
Какие задачи решает
- читать внутреннюю документацию вместе с графиками метрик прямо из чата
- создавать черновики статей и описания API через ИИ-ассистента
- находить регламенты реагирования и параметры задержек во время инцидентов
Примеры запросов агенту
- Найди в Oxynote регламент по разбору сбоев и покажи связанные графики задержек
- Создай черновик описания для эндпоинта
GET /v1/shipments/{id}в документации
Как установить Oxynote
1Адрес-шаблон
Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]
2Командой платформы: удалённый сервер
claude mcp add --transport http oxynote https://{host}/core/api/mcp1Адрес-шаблон
Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]
2Командой платформы: удалённый сервер
codex mcp add oxynote --url https://{host}/core/api/mcp1Адрес-шаблон
Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]
2Файл настроек
{
"mcpServers": {
"oxynote": {
"url": "https://{host}/core/api/mcp"
}
}
}1Адрес-шаблон
Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]
2Файл настроек
{
"servers": {
"oxynote": {
"type": "http",
"url": "https://{host}/core/api/mcp"
}
}
}1Адрес-шаблон
Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]
2Командой платформы: удалённый сервер
gemini mcp add -t http oxynote https://{host}/core/api/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Oxynote
Как установить Oxynote в Claude Code?
Для подключения выполните команду claude mcp add --transport http oxynote https://{host}/core/api/mcp, заменив {host} на адрес вашего запущенного сервера.
Что делает MCP-сервер Oxynote?
Он предоставляет ИИ-агенту доступ к вашей базе знаний Oxynote, позволяя читать статьи, искать контекст и вносить правки в документы с графиками Prometheus.
Как запустить локальный сервер Oxynote?
Запустите контейнер командой docker run -d --name oxynote -p 8080:8080 -v oxynote_data:/oxynote/data ghcr.io/oxynote/oxynote:latest. Интерфейс откроется на http://localhost:8080, начальный логин — [email protected] с паролем oxynote-admin-1234.
