Для разработчиков
MCP-сервер
Model Context Protocol — открытый протокол, по которому ассистенты (Claude, ChatGPT, Cursor, VS Code и другие) вызывают внешние инструменты. Подключите адрес — и ассистент сможет искать традиции, читать положения с их местами, временную линию и тексты библиотеки, со ссылками на страницы сайта.
https://versemora.xyz/mcp- Транспорт: Streamable HTTP, без сессий (stateless); подходят клиенты протокола 2025-03-26 … 2025-11-25 и 2026-07-28.
- Авторизация: не нужна. Все инструменты только читают открытые данные (readOnlyHint).
- Языки ответа: русский и английский (параметр lang); у каждой сущности — ссылка на её страницу.
- Оценки положений показывают опору в собственных текстах традиции, а не истинность учения.
Краткое описание для моделей: /llms.txt
Подключение
Claude — claude.ai и Claude Desktop
- Откройте «Настройки» → «Коннекторы» (в новых версиях — «Customize» → «Connectors»).
- Нажмите «Добавить» → «Добавить свой коннектор» (Add custom connector).
- Имя: Versemora. Адрес: https://versemora.xyz/mcp. Вход не нужен — нажмите «Добавить».
- В чате включите Versemora в меню инструментов («+» → коннекторы).
Если в вашей версии Claude Desktop нет коннекторов — claude_desktop_config.json (мост mcp-remote, нужен Node.js) { "mcpServers": { "versemora": { "command": "npx", "args": ["-y", "mcp-remote", "https://versemora.xyz/mcp"] } } }Pro, Max, Team и Enterprise; на бесплатном плане — один свой коннектор. В Team и Enterprise коннектор добавляет владелец организации («Настройки организации» → «Коннекторы»). Коннекторы claude.ai видны и в Claude Desktop.
Claude Code
- Выполните в терминале команду ниже (для всех проектов — с --scope user).
- Проверьте: claude mcp list, или /mcp внутри Claude Code.
Терминал claude mcp add --transport http versemora https://versemora.xyz/mcpИли .mcp.json в корне проекта { "mcpServers": { "versemora": { "type": "http", "url": "https://versemora.xyz/mcp" } } }ChatGPT
- Откройте chatgpt.com → «Plugins» (chatgpt.com/plugins), нажмите «+» → «Add custom MCP server».
- Имя: Versemora. Server URL: https://versemora.xyz/mcp. Authentication: «No authentication».
- Подтвердите предупреждение («I understand and want to continue») → «Create as a plugin», затем установите его и выберите в чате.
Только в веб-версии; доступность зависит от плана и правил рабочего пространства. В старом интерфейсе: «Настройки» → «Apps & Connectors» → «Advanced» → «Developer mode», затем «Create».
Cursor
- Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного), либо через Settings → MCP → Add new server.
- Включите его в списке MCP-серверов.
mcp.json { "mcpServers": { "versemora": { "url": "https://versemora.xyz/mcp" } } }VS Code (GitHub Copilot)
- Палитра команд → «MCP: Add Server» → HTTP → адрес сервера → имя versemora.
- Или добавьте в .mcp.json в корне рабочей папки (или ~/.copilot/mcp-config.json).
.mcp.json { "mcpServers": { "versemora": { "type": "http", "url": "https://versemora.xyz/mcp", "tools": ["*"] } } }Старый формат .vscode/mcp.json { "servers": { "versemora": { "type": "http", "url": "https://versemora.xyz/mcp" } } }Другие клиенты и проверка
- Любой клиент MCP с транспортом Streamable HTTP: адрес сервера, без авторизации.
- Проверить сервер можно MCP Inspector:
Терминал npx -y @modelcontextprotocol/inspector --cli https://versemora.xyz/mcp --transport http --method tools/list
Инструменты
Все инструменты только читают. Списки листаются (offset, limit); id из одного инструмента подходят в другой.
searchПоиск по сайту: традиции, события, люди, родословные, издания.search_textsПолнотекстовый поиск по изданиям библиотеки.list_religionsРелигии и дерево их направлений с числом положений по оценкам.get_traditionРелигия или направление: даты, тексты, положения с оценками, ветви, издания.get_postulateПоложение: оценка и почему, места за и против, унаследованные, слова самой традиции.get_timelineВременная линия: направления, события и мировая история — по области и годам.get_eventСобытие: дата, люди, тексты, что к нему привело и что из него вышло.get_personЧеловек: даты, биография, труды, версии текстов, события.list_lineagesРодословные текстов: от рукописей к изданиям и переводам.get_lineageГраф одной родословной: версии, связи между ними, события.list_influencesВлияния: кто у кого что взял, когда и насколько это установлено.get_influenceОдно влияние: свидетельства, надёжность, состояние науки.list_claimsУтверждения традиций друг о друге и о себе — с вердиктом по источникам.get_claimОдно утверждение: где сделано, свидетельства, вердикт и его обоснование.list_conflictsПротиворечия: утверждения текстов, которым противоречат другие источники.get_conflictОдно противоречие: что сказано, что ему противоречит, ответ традиции.list_contestedСпорные тексты: на что опирается традиция и что вызывает возражения.get_contestedОдин спорный текст: что сказано, возражение, прочтение традиции, критики.list_editionsИздания библиотеки с языком, датой, ролью и лицензией.get_editionИздание: источник, лицензия и атрибуция, содержание с id страниц.read_passageТекст места: стих, отрывок или главу; защищённые издания — только короткий отрывок.compare_translationsОдно место в других изданиях и переводах — по записанным соответствиям.
Пределы
- До 120 запросов в минуту с одного IP-адреса (кратковременно — столько же сразу); при превышении — 429 с заголовком Retry-After. Каждый ответ несёт заголовки RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.
- Защищённые издания: не больше 3 мест и 400 знаков в ответе и не больше 40 отрывков за 10 минут с одного адреса.
- Ответ инструмента — не длиннее ~40 000 знаков; длинные списки и отрывки приходят частями (offset/limit, next_offset, continue_with). Тело запроса — до 64 КБ.
- Лимиты считаются в памяти каждого экземпляра сервера: это граница злоупотреблениям, а не точная квота. Без ключа и регистрации.
REST API
Тот же сервер данных напрямую: JSON, только GET, без ключа. Тексты на двух языках — {"ru", "en"}; направления, положения и переводы мест принимают ?lang=ru|en. Ответы кэшируются (cache-control: public, max-age=300, ETag и 304). Ошибки — {"error": {"code", "message"}}: 404 для неизвестного id, 503 index_building с Retry-After, пока сервер строит индекс после перезапуска.
https://versemora.xyz/v1curl -s 'https://versemora.xyz/v1/traditions/lutheranism/postulates/scripture-sole-rule?lang=en'Традиции
/v1/traditions— религии и деревья направлений, легенда оценок/v1/traditions/{id}?lang=— религия или направление: тексты, положения с оценками, ветви/v1/traditions/{direction}/postulates/{postulate}?lang=— положение: оценка, места за и против, слова традиции/v1/traditions/timeline?religion=&direction=&history=1— полосы, события, мировая история
Связи и критика
/v1/relations/influences, /v1/relations/influences/{id}/v1/relations/claims, /v1/relations/claims/{id}— утверждения и вердикты/v1/critique/conflicts[/{id}], /v1/critique/contested[/{id}], /v1/critique/basis/{direction}, /v1/critique/phases/{religion}
История текстов
/v1/history/people[/{id}], /v1/history/events/{id}/v1/history/lineages[/{id}], /v1/history/editions/{id}/v1/media[/{id}]— фотографии и портреты с автором и лицензией
Библиотека
/v1/library/catalog, /v1/library/editions[/{id}], /v1/library/editions/{id}/pages/{page}/v1/library/passage?edition=&ref=— место, отрывок или глава (до 200 мест)/v1/library/resolve?q=— «Мф 22:39» → канонические ссылки/v1/library/search?q=— полнотекстовый поиск/v1/library/parallel?ref=&from=, /v1/library/editions/{id}/readings?place=&lang=— то же место в других изданиях
Кэшируйте ответы и не выкачивайте библиотеку целиком: сервер общий.
Лицензии и атрибуция
- Данные Versemora (традиции, оценки, связи, вердикты, история текстов) цитируйте со ссылкой на страницу сайта — она есть у каждой сущности (url).
- Тексты принадлежат правообладателям. У каждого издания — источник, лицензия и строка атрибуции (license.attribution, license.url); приводите её вместе с цитатой.
- Защищённые издания (класс лицензии research_use, «© только онлайн») читаются на сайте; MCP отдаёт из них только короткий отрывок (до 3 мест, 400 знаков) с уведомлением об использовании. Не распространяйте их, не собирайте целиком и не выкладывайте повторно.
- Фотографии рукописей и находок — из открытых источников; у каждой указаны автор и лицензия, сохраняйте их.
- Условия использования сайта действуют и здесь: не пытайтесь обойти ограничения защищённых изданий и не скачивайте тексты массово.