Підключити клієнта штучного інтелекту (MCP)

Kept запускає MCP сервер за вашою адресою Kept, за якою слідує /mcp, наприклад https://kept.example.org/mcp. Застосунок AI, що розуміє MCP, тоді може відповідати «де дриль?» з вашого інвентарю та, якщо ви дозволите, додавати, переміщувати та змінювати речі.

Ця сторінка стосується застосунків поза Kept. Власний помічник Kept використовує ті самі інструменти і описано у Провайдери AI. Як сервер працює всередині — у Сервер MCP.

Є два способи підключити застосунок:

• Особистий токен: будь-який MCP-клієнт, що дозволяє задати адресу сервера та заголовок Authorization.
• Конектор (OAuth): застосунок перенаправляє вас до Kept, щоб увійти і обрати, що йому дозволено. Для цього Kept має бути за https-адресою, яку може досягти застосунок.

Ще не перевірено з застосунками

Тести Kept підключають MCP-клієнта обома способами. Перевірки з claude.ai, ChatGPT та Claude Desktop ще очікують, тому ще не підтверджено, які з них підключаються як конектори.

Початок роботи

• Увімкніть «Підключити ChatGPT або Claude» у кожній локації, яку має досягати застосунок. Це знаходиться в Налаштування локації → Що відстежувати, і увімкнене лише в пресеті Завершити. Власник та адміністратори змінюють це. У локації, де це вимкнене, токен або конектор нічого не досягає.
• Застосунок створює токени лише через https. Налаштування → З’єднання відмовляють створювати токен, коли KEPT_PUBLIC_URL — просте http. Немає налаштування, щоб вимкнути це. Див. HTTPS. У домашній мережі через http особа, що керує сервером, може створити його там: kept admin token create.

Створити особистий токен

Відкрийте Налаштування → З’єднання та оберіть Новий токен.

Поле	Що ввести
Назва	Де ви його використовуватимете: «Claude Desktop, мій ноутбук».
Локації	Одна вже позначена. Додайте іншу лише якщо застосунку потрібні обидві.
Що він може	Лише читання: знаходити речі та читати записане. Читати та змінювати: також додавати, переміщувати або змінювати їх. Жоден не може видаляти або бачити секретні поля.
Термін дії	Дата, або порожньо, щоб діяв, поки ви його не відкличете. Закінчується в кінець цього дня.

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

Токен, kpt_ з двома частинами, з’являється раз, з кнопкою Копіювати. Kept зберігає лише відбиток його, тому втрачений токен не можна показати знову: відкличте його і створіть інший.

У локації, що вимагає двофакторну автентифікацію, токен працює лише якщо ви створили його, увійшовши з другим фактором.

Підключити клієнта з токеном

Під новим токеном Підключити застосунок показує два значення, кожне з кнопкою копіювання:

Server address   https://kept.example.org/mcp
Authorization    Bearer kpt_…

У застосунку додайте MCP-сервер (може називатися конектором або інтеграцією) з цією адресою, і надсилайте токен у цьому заголовку. Kept не надає файл налаштувань для жодного конкретного застосунку; де вводити адресу та заголовок — у документації самого застосунку.

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

Підключити як конектор (OAuth)

Застосунки, що підтримують це, можуть підключитися без токена, що ви копіюєте. Це увімкнене саме за умові, що KEPT_PUBLIC_URL — https. Адміністрування → Статус → З’єднання з інших застосунків показує MCP- ендпоінт і Доступний або Потрібна публічна https-адреса.

1. У застосунку додайте https://kept.example.org/mcp як конектор.
2. Застосунок знаходить вхід Kept за адресою і надсилає вас до Kept. Увійдіть.
3. Kept показує Застосунок хоче користуватися вашим Kept. Назва — та, яку дає собі застосунок; Kept не може перевірити, хто його зробив. Оберіть Що він може та Де (означте лише потрібні локації), потім Дозволити або Заборонити. Сторінка також каже, що застосунок залишається увійшеним після того, як ви вийдете з цього браузера, і що все, що виходить з усіх ваших інших пристроїв, змушує його знову увійти.
4. Застосунок з’являється у Підключені застосунки у Налаштування → З’єднання.

Застосунок залишається підключеним, поки ви не натиснете Відкликати на ньому і не підтвердите (Kept питає Відключити Застосунок?), або поки йому 30 днів не використовували; тоді він має знову увійти. Кожен токен доступу, що він отримує, діє годину, і застосунок оновлює його без повторного запиту; Kept перевіряє ваш дозвіл на кожному виклику, тому Відкликати у Налаштування → З’єднання спрацьовує миттєво.

Застосунок має знову увійти після всього, що виходить з ваших інших пристроїв: Вийти з усіх інших пристроїв, новий пароль або скидання пароля, зміна двофакторної автентифікації, резервних кодів чи passkey, відв’язування зовнішнього входу, нова електронна адреса, або адміністратор виходить скрізь або вимикає ваш обліковий запис. Вихід з одного обраного пристрою залишає застосунок увійшеним.

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

Що зупиняє конектор:

• Застосунок не може досягти Kept. Веб-застосунок, як claude.ai, підключається зі своїх серверів, тому Kept має бути досяжним з інтернету, а не лише у вашій домашній мережі або tailnet.
• Kept не може досягти застосунку. Застосунок ідентифікує себе https-адресою документа, що його описує, і Kept завантажує цей документ. Приватні та локальні адреси відхиляються.
• Застосунок реєструє себе. Kept приймає застосунки, що описують себе таким документом (Client ID Metadata Documents), і має вимкнено динамічну реєстрацію клієнта. Застосунок, що може лише динамічно реєструватися, не може підключитися як конектор; використовуйте особистий токен, якщо він його приймає.

Що застосунок може і не може

• Він бачить лише обрані вами локації, і в кожній лише інструменти для частин Kept, що там увімкнені. Де ваша роль приховує значення, вони приховані й від застосунку.
• Зміни застосовуються відразу і з’являються під Нещодавні зміни з’єднань на сторінці З’єднань, з Скасування протягом 7 днів. Скасування відмовляється, якщо поле змінилося зтоді.
• Немає нічого деструктивного для виклику. Жоден інструмент не видаляє, не смітить, не зливає, не передає власність, не розкриває секретне поле, не завантажує файл і не запускає власний запит.
• Файли йдуть через вас. attach_link дає застосунку посилання, що відкриває аркуш захоплення Kept; ви додаєте фото чи чек там, увійшовши.
• Ліміти на токен: 120 читань і 30 змін на хвилину. Відповіді короткі і сторінковані, 20 речей, якщо застосунок не просить більше, аж до 200.
• Текст, що написали люди, позначений як недовірчий. Назви та нотатки йдуть до застосунку під ключем untrusted, і Kept каже йому ніколи не слідувати інструкціям, знайденим у них.

Інструменти

Застосунок бачить лише інструменти, що може викликати в кожній локації; capabilities їх перелічує. Приховування Personal не змінює те, що дано застосунку. Інструменти читання працюють з обома видами доступу; інструменти змін потребують Читати та змінювати та роль учасника чи вище. Частина Kept, що потрібна інструменту — це назва під Що відстежувати.

Інструмент	Рід	Потребує	На що відповідає
capabilities	читання		Що я можу у кожній локації: її частини та інструменти, що я там можу викликати.
list_locations	читання		Які локації я бачу, з моєю ролью та їх часовими поясами.
search_things	читання		Які речі відповідають цим словам: назви, псевдоніми, типи, бренди та нотатки, з фільтрами.
where_is	читання		Де реч: найкращі збіги з їх повним шляхом місця.
get_thing	читання		Що ми знаємо про цю реч (за id або коротким ID), хто її має, і частини набору.
list_contents	читання		Що в цьому місці чи контейнері, 1–3 рівні глибини.
thing_history	читання		Що трапилося з цією речю, найновіші перші: хто що робив і коли.
find_documents	читання		Де чек, інструкція чи гарантія для чогось.
upcoming	читання	Нагадування	Що заборговано, прострочено або скоро закінчується: розклади, гарантії, позичання та низький запас.
add_thing	зміна		Додати одну або кілька речей, з новим місцем, якщо його ще немає, і кожним полем, що задає аркуш створення застосунку (див. нижче).
update_thing	зміна		Змінити будь-яке з полів речі, що змінює форма редагування застосунку (див. нижче); null очищає одне.
move_thing	зміна		Перемістити речу, або частину кількості, в інше місце чи контейнер.
mark_seen	зміна		Я щойно побачив цю речу там, де каже Kept.
create_place	зміна		Додати місце під іншим місцем, або на вершині локації. З template додати меблі та місце для кожного відсіку в один крок, як Меблі з відсіками робить; одне Скасування повертає все назад. Кімната бере свій реальний розмір, width_cm і length_cm (50 см – 100 м), і потрапляє на карту з ним. Шаблон стійки бере units і numbering (Серверні стійки).
update_place	зміна		Змінити місце, як його сторінка: перейменувати, змінити рідновид, перемістити в інше місце чи на вершину, задати його поля, і порядок місць у ньому (А–Я або Користувацький порядок, потім Вгору або Вниз). turn (right або left, куди пішло його верх) перевертає меблі з відсіками на бік чи спину, з renumber true чи false. Скасування на 7 днів, крім руху вгору чи вниз: протилежний рух його скасовує.
turn_into_boxes	зміна		Перетворити до 50 місць у коробки, як Перетворити місця на коробки. Кожне зберігає свій ID, мітку та те, що в ньому; одне з місцями всередині залишається місцем, і так само одне на вершині локації (перетворіть його в Kept). Одне Скасування повертає всі назад.
attach_link	зміна		Посилання, що відкриває аркуш захоплення Kept для додавання фото, чеку чи документа.
log_reading	зміна		Записати показники лічильника: одометр, нагодинки, електрика.
lend_thing	зміна	Позичання	Позичити реч комусь, з опціональною датою повернення. Коробка чи набір йдуть з усім усередині, кожне власний рядок.
return_thing	зміна	Позичання	Позичена чи запозичена реча повернулась, вся або частина кількості. Коробка чи набір повертають те, що ще з ними.
borrow_thing	зміна	Позичення	Зафіксувати запозичену реч у когось, з опціональною датою повернення.
complete_schedule	зміна	Нагадування	Заплановане завдання виконано, за датою або значенням лічильника.
snooze_schedule	зміна	Нагадування	Відкласти заплановане завдання до дати або значення лічильника.
add_warranty	зміна	Чеки та гарантії	Зафіксувати гарантію: її рідновид, і коли закінчується або скільки місяців.
open_claim	зміна	Чеки та гарантії	Відкрити гарантійний претензійний випадок для речі.
update_claim	зміна	Чеки та гарантії	Змінити статус претензійного випадку або посилання.
log_service	зміна		Зафіксувати обслуговування: дата, хто робив, сума, рядки (кожен може списати зі складу витратного матеріалу), розклади, що завершує, і нотатки.
log_fuel	зміна	Пальне	Зафіксувати заправку: кількість, одиниця, вартість, чи повний бак, і одометр.
adjust_stock	зміна	Речі, які у вас закінчуються	Додати до або взяти зі складу витратного матеріалу.
list_tags	читання		Які теги є, з кількістю речей, що мають кожен.
tag_things	зміна		Додати теги до речей, або зняти їх; нова назва створює тег.
list_moves	читання	Переїзд	Які переїзди є, з кількістю коробок, що упаковані, в дорозі та розпаковані.
get_move	читання	Переїзд	Де кожна коробка переїзду, і які номери ще відсутні.
start_move	зміна	Переїзд	Розпочати переїзд, в іншу локацію або між кімнатами цієї.
add_box	зміна	Переїзд	Додати наступну нумеровану коробку: нову, або контейнер, що у вас є.
pack_into_box	зміна	Переїзд	Упакувати речі в коробку.
set_box_status	зміна	Переїзд	Позначити коробку упакованою або в дорозі, або обрати її кімнату.
unpack_box	зміна	Переїзд	Розпакувати коробку в кімнату; все в ній йде з нею.

Поля речі. add_thing і update_thing беруть кожне поле, що можна задати на речі в застосунку, кожне в власному полі, а не в нотатках: назва, скільки, тип (за назвою, англійською або арабською, або за id), бренд (створюється, якщо новий), модель, серійний номер, штрихкод, колір, стан, нотатки, інші назви, теги (нова назва створює тег, для учасників і вище), чия це (особа, створюється, якщо нова), посилання на інструкцію, термін дії і скільки днів до нагадування, мінімум витратного матеріалу, і власні поля типу за ключем. add_thing також бере, куди йде, і покупку (дата, ціна однієї з валютою, і магазин); update_thing також бере, звідки прийшла, і її покупку: дату, магазин, її рядок у чеку, ціну однієї з валютою та нотатки, змінюючи покупку, що є, або записуючи її, як робить сторінка речі. Ціна потребує увімкнених Грошей і ролі, що бачить гроші, як у застосунку; мінімум потребує Речей, які у вас закінчуються. Тип, якого Kept не знає, пропускається, і у відповіді not_set каже це; картка помічника показує це як «не задано» з вибором. Обладнання в стійці бере rack_units (його висота, 0 поруч із рейками) і rack_at (найменший номер юніта, який воно займає, за нумерацією самої стійки, як його дає get_thing, сторона і чи на всю глибину); зайнятий юніт відхиляється, як в аплікації.

Інструменти переїзду — лише для підключених застосунків; помічник у Kept їх не використовує.

Кожен інструмент, що приймає id, також приймає 6-символьний короткий ID, як K7D2QX. Повні контракти в packages/mcp/src/tools.ts.

Відкликати доступ

У Налаштування → З’єднання знайдіть токен або застосунок (фільтр за Рідновид, Локація або Стан) і оберіть Відкликати.

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

Kept також сам завершує доступ, і список каже чому: Прострочено, Завершено: ви покинули локацію, Завершено: ваша роль змінилася, Відкликано адміністратором, або Відключено застосунком.