MCP

Підключіть Cursor (або інший MCP-клієнт) до Спільної книги: читати ваші книги, здавати й правити ходи, лор і Хартію від вашого імені. Правила лишаються на сервері.

Підключення

Нічого ставити не треба. Один клік «Add to Cursor» або один рядок у mcp.json. При першому виклику відкриється сайт — натисніть «Авторизувати».

URL ендпоінта: https://spilnaknyha.com/api/mcp/http

{
  "mcpServers": {
    "spilnaknyha-mcp": {
      "url": "https://spilnaknyha.com/api/mcp/http"
    }
  }
}

Інструменти

Інструменти
list_my_books — ваші книги
get_book — деталі / чий хід / allowEdit
list_members — учасники: uid, нік, імʼя, роль (Автор/Редактор/Керівник/Заступник/Майстер), muted/banned
read_charter — поточна Хартія
list_chapters — глави: назва, closed/open, діапазон order фрагментів
charter_schema — довідник полів перед update_charter
list_turns — фрагменти (turnId, «ви», editable); afterOrder; ніки через list_members; limit 1–50
list_lore — картки лору; type — категорія; afterOrder=0 з початку; limit 1–50
get_lore — одна картка за cardId
submit_turn — здача; без confirm:true лише превʼю; chapterFinal — кінець глави
edit_turn — правка зданого ходу (якщо allowEdit / Штаб); без confirm — превʼю
add_lore — нова картка лору; без confirm — превʼю
update_charter — Майстер: зберегти й опублікувати Хартію; без confirm — превʼю
create_book — чернетка книги; без confirm — превʼю; активація через update_charter
logout — відкликати токен

confirm: true для submit_turn видаляє вашу чернетку цієї книги на сервері. Не ставте confirm без явної згоди.

Інші клієнти (Claude тощо) — той самий URL: https://spilnaknyha.com/api/mcp/http

MCP

Connect Cursor (or another MCP client) to Spilna Knyha: read your books, submit and edit turns, lore, and Charter as you. Rules stay on the server.

Connect

Nothing to install. One click “Add to Cursor” or one line in mcp.json. On first use the site opens — tap Authorize.

Endpoint URL: https://spilnaknyha.com/api/mcp/http

{
  "mcpServers": {
    "spilnaknyha-mcp": {
      "url": "https://spilnaknyha.com/api/mcp/http"
    }
  }
}

Tools

Tools
list_my_books — your books
get_book — details / whose turn / allowEdit
list_members — members: uid, handle, name, role (author/editor/manager/deputy/master), muted/banned
read_charter — current Charter
list_chapters — chapters: title, closed/open, fragment order ranges
charter_schema — field guide before update_charter
list_turns — fragments (turnId, you, editable); afterOrder; names via list_members; limit 1–50
list_lore — lore cards; type = category; afterOrder=0 from start; limit 1–50
get_lore — one card by cardId
submit_turn — submit; without confirm:true only a preview; chapterFinal ends the chapter
edit_turn — edit a submitted turn (if allowEdit / staff); without confirm — preview
add_lore — new lore card; without confirm — preview
update_charter — Master: save and publish Charter; without confirm — preview
create_book — book draft; without confirm — preview; activate via update_charter
logout — revoke token

confirm: true on submit_turn deletes your server draft for that book. Never set confirm without explicit consent.

Other clients (Claude, etc.) use the same URL: https://spilnaknyha.com/api/mcp/http

Spilna Knyha · Terms · Privacy