Чат-клієнти (MCP)

Obscura можна підключити до чат-клієнта, яким ви вже користуєтеся: Claude Desktop, Claude Code або Codex. Чат читає план, картки, пам’ять і тексти сцени, пише чернетку своєю моделлю й зберігає її в Obscura. Ваш API-ключ для цього не потрібен: модель працює в межах облікового запису чат-клієнта, а Obscura сама модель не викликає.

Зв’язок іде через storygen-mcp. Це невелика програма, яку чат-клієнт запускає сам. Вона звертається до запущеної Obscura на вашому комп’ютері й більше нікуди.

Що вміє чат

Чат отримує двадцять шість інструментів:

Видаляти твори й сцени, переносити їх у кошик, переставляти сцени, запускати генерацію, пропозицію анотації чи оцінювач, змінювати промпти, оцінювача, бюджет і ключі чат не може.

Встановлення

storygen-mcp входить у звичайне встановлення. Якщо Obscura встановлено раніше, повторіть дві команди встановлення в теці застосунку, щоб додати нові залежності:

./.venv/Scripts/python.exe -m pip install -r requirements-lock.txt
./.venv/Scripts/python.exe -m pip install --no-deps -e ".[web,publication]"

Після цього в теці .venv/Scripts/ з’явиться storygen-mcp.exe. Далі в прикладах тека застосунку — C:\Obscura; підставте свою.

Підключення

Кнопка в бібліотеці

Найпростіше підключитися з бібліотеки Obscura: розгорніть блок «Підключити до Claude».

Чат не може сам підключити чи перезапустити Claude: ці дії виконуєте лише ви в Obscura.

Вручну

Перед роботою запустіть Obscura, як звичайно. Чат-клієнт підключається до http://127.0.0.1:8765. Якщо Obscura запущено на іншому порту, додайте аргументи --url http://127.0.0.1:<порт>.

Якщо ви запускаєте Obscura без консолі через storygen-desktop (встановлення), замість --url додайте аргументи --data-dir <тека творів> (типово %USERPROFILE%\Obscura). Тоді запускати Obscura заздалегідь не треба: на першому запиті чату міст сам знайде її на будь-якому порту, а якщо вона не запущена — тихо запустить її у треї без браузера. Obscura лишиться у треї й після закриття чату; вийти з неї можна через значок.

Claude Code. У терміналі:

claude mcp add --scope user obscura -- C:\Obscura\.venv\Scripts\storygen-mcp.exe

--scope user робить сервер доступним у будь-якій теці. Без нього Claude Code бачить сервер лише в теці, де виконано команду.

Claude Desktop. Додайте сервер у файл налаштувань claude_desktop_config.json. Де лежить файл, залежить від способу встановлення:

Файл може вже містити налаштування застосунку: не видаляйте їх, а додайте поруч розділ mcpServers. Поки Claude Desktop працює, він сам перезаписує цей файл, тому спершу повністю закрийте застосунок, зокрема іконку в області сповіщень. Потім збережіть файл і запустіть Claude Desktop знову. Файл лише з цим сервером виглядає так:

{
  "mcpServers": {
    "obscura": {
      "command": "C:\\Obscura\\.venv\\Scripts\\storygen-mcp.exe"
    }
  }
}

Для іншого порту додайте "args": ["--url", "http://127.0.0.1:8770"]. У командах claude mcp add і codex mcp add аргументи йдуть після шляху до програми: … storygen-mcp.exe --url http://127.0.0.1:8770.

Codex. У терміналі:

codex mcp add obscura -- C:\Obscura\.venv\Scripts\storygen-mcp.exe

Або додайте в ~/.codex/config.toml розділ [mcp_servers.obscura] з рядком command = 'C:\Obscura\.venv\Scripts\storygen-mcp.exe'.

Чат-клієнти в браузері (claude.ai, chatgpt.com) локальних серверів не підтримують.

Як писати з чатом

  1. Обговоріть із чатом ідею, план і персонажів.
  2. Попросіть імпортувати план і персонажів у потрібний твір. Твір чат може створити сам (див. нижче) або ви створюєте його в Obscura заздалегідь. Імпорт додає матеріали так само, як форма, і сам не повторюється.
  3. Попросіть прочитати контекст першої сцени й написати чернетку. Чат зберігає її як поточну чернетку сцени.
  4. Щоб доповнити чи переписати наявну чернетку, попросіть чат спершу прочитати її. Чат пише поверх прочитаного тексту, тож ваші правки, зроблені в Obscura, не губляться.
  5. Відкрийте сцену в Obscura за посиланням з чату. Попередня чернетка, якщо вона була, лишається в історії версій.
  6. Перепишіть чернетку власними словами в режимі переписування по пам’яті, затвердіть прозу й оновіть пам’ять сцени. Попросіть чат дати посилання на переписування: воно відкриє режим одразу, без пошуку сцени й кнопки.
  7. Переходьте до наступної сцени.

Почати твір із чату

Попросіть чат створити твір: назву, мову (українська чи англійська) і, якщо хочете, віковий рейтинг. Потім чат бере шаблони плану й персонажів, заповнює їх разом із вами й імпортує. Далі він може додати сцени, переписати план сцени, змінити назву, мову чи рейтинг твору.

Чернетка з чату має позначку «Зовнішній клієнт: <назва>» в історії версій і в рядку стану над редактором. Якщо чат назвав модель, вона теж показується. Це заява клієнта: Obscura не може перевірити, яка модель насправді писала текст. Щойно ви збережете власну правку, позначка зникає з рядка стану, а в історії лишається біля версії з чату.

Obscura можна тримати відкритою поруч із чатом. Коли ви повертаєтеся у вікно Obscura, сторінка сама перевіряє, чи чат щось записав. Якщо в редакторі немає незбережених правок, ви одразу побачите нову чернетку. Якщо правки є, текст лишається вашим, а над редактором з’являється «Сцену змінено ззовні» з кнопкою «Відкрити новішу версію»; перед заміною тексту вона спитає підтвердження.

Публікація з чату

Чат може заповнити картку публікації, додати підпис автора, поставити обкладинку й експортувати книгу.

Налаштування з чату

Чат може змінити жанр, тон, оповідача, правила стилю й обсяг твору, вибрати провайдера й модель для ролі, змінити контекст, температуру чи режим редактора, а також застосувати збережений пресет ролей.

Хто пише тексти

Кожен твір має режим: Пише чат або Пише Obscura. Твір, створений чатом, типово має режим Пише чат; у формі нового твору в Obscura типово вибрано Пише Obscura. Режим показують список творів і відомості про твір у чаті.

Запуски Obscura з чату

У творі з режимом Пише Obscura чат може попросити Obscura виконати один етап сцени — завдання сцени, чернетку, редактуру чи пам’ять — або запропонувати картку публікації. Це звичайний запуск Obscura: моделі ваших ролей, бюджет твору й та сама перевірка готовності, що й для кнопок.

Етапи сцени з чату

Чат може пройти всі етапи сцени сам: скласти завдання сцени, написати чернетку, відредагувати її й оновити пам’ять. Для кожного етапу він отримує ті самі інструкції, що й модель Obscura: стандартні промпти або ваші власні, налаштування ролі, мову твору, рейтинг і пам’ять попередніх сцен. Для чернетки інструкції письменника приходять разом із контекстом сцени.

Почати історію одним запитом

Чат-клієнт бачить запит «Почати історію» (start_story). Він веде чат від задуму до твору: створити твір у режимі «пише чат», заповнити план і персонажів, написати сцени й наприкінці дати посилання, щоб читати й правити твір у вікні Obscura.

Версія з Microsoft Store

Версія з Microsoft Store містить міст MCP: окремо встановлювати нічого не треба, а кнопка «Підключити до Claude» в бібліотеці розгорнута одразу. Новий твір у ній за замовчуванням у режимі «пише чат». Якщо Obscura не запущена, Claude сам тихо запускає її у треї, коли вона знадобиться; вийти з неї можна через значок.

Безкоштовна версія не пише довгу прозу (книги, частини, арки), серії й сцени понад межу рейтингу. Коли чат натрапляє на таку межу, він пояснює, що це можливість платної версії, і дає посилання на запис.

Обмеження