Перейти к содержанию

Для разработчиков

Данные Versemora — традиции и их положения с опорой в текстах, временная линия, влияния и споры, история текстов и библиотека — для ИИ-ассистентов через MCP-сервер и для программ через REST API. Бесплатно, без ключа, только чтение.

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

    1. Откройте «Настройки» → «Коннекторы» (в новых версиях — «Customize» → «Connectors»).
    2. Нажмите «Добавить» → «Добавить свой коннектор» (Add custom connector).
    3. Имя: Versemora. Адрес: https://versemora.xyz/mcp. Вход не нужен — нажмите «Добавить».
    4. В чате включите 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

    1. Выполните в терминале команду ниже (для всех проектов — с --scope user).
    2. Проверьте: 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

    1. Откройте chatgpt.com → «Plugins» (chatgpt.com/plugins), нажмите «+» → «Add custom MCP server».
    2. Имя: Versemora. Server URL: https://versemora.xyz/mcp. Authentication: «No authentication».
    3. Подтвердите предупреждение («I understand and want to continue») → «Create as a plugin», затем установите его и выберите в чате.

    Только в веб-версии; доступность зависит от плана и правил рабочего пространства. В старом интерфейсе: «Настройки» → «Apps & Connectors» → «Advanced» → «Developer mode», затем «Create».

  • Cursor

    1. Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного), либо через Settings → MCP → Add new server.
    2. Включите его в списке MCP-серверов.
    mcp.json
    {
      "mcpServers": {
        "versemora": {
          "url": "https://versemora.xyz/mcp"
        }
      }
    }
  • VS Code (GitHub Copilot)

    1. Палитра команд → «MCP: Add Server» → HTTP → адрес сервера → имя versemora.
    2. Или добавьте в .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"
        }
      }
    }
  • Другие клиенты и проверка

    1. Любой клиент MCP с транспортом Streamable HTTP: адрес сервера, без авторизации.
    2. Проверить сервер можно MCP Inspector:
    Терминал
    npx -y @modelcontextprotocol/inspector --cli https://versemora.xyz/mcp --transport http --method tools/list

Инструменты

22

Все инструменты только читают. Списки листаются (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/v1
Пример
curl -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 знаков) с уведомлением об использовании. Не распространяйте их, не собирайте целиком и не выкладывайте повторно.
  • Фотографии рукописей и находок — из открытых источников; у каждой указаны автор и лицензия, сохраняйте их.
  • Условия использования сайта действуют и здесь: не пытайтесь обойти ограничения защищённых изданий и не скачивайте тексты массово.

Условия использования →