OwlectOwlect
Почати безкоштовно

Для розробників · MCP

Користуйтеся Owlect із Claude і ChatGPT

Owlect має віддалений сервер Model Context Protocol (MCP). Додайте його до свого AI-асистента один раз, увійдіть через Google - і керуйте колекціями в розмові: додавайте цілу полицю зі списку чи фото, виправляйте деталі, виставляйте речі на продаж або ставте запитання про те, що у вас є.

Адреса сервера

https://owlect.app/api/mcp
Віддалений MCPStreamable HTTPOAuth 2.1 + PKCE11 інструментівПереглянути як Markdown →

Що можна попросити

Після підключення просто розмовляйте з асистентом. Потрібні інструменти Owlect він обере сам.

  • “Додай ці 20 настільних ігор на мою полицю: [вставте список або додайте фото]”
  • “Вистав на продаж за $40 усі ігри Stonemaier з моїх настільних ігор”
  • “Які з моїх наборів LEGO неповні?”
  • “Створи колекцію вінілу «Джаз» і додай альбоми з цього фото”
  • “Скільки предметів я ще можу додати на своєму тарифі?”
  • “Перейменуй колекцію «Бажане» на «Купити»”

Швидкий старт

  1. 1

    Скопіюйте адресу сервера

    Адреса вище працює в усіх клієнтах. API-ключ не потрібен.

  2. 2

    Додайте її до асистента

    У Claude чи ChatGPT додайте власний конектор (у ChatGPT - застосунок) із цією адресою. Покрокові інструкції для кожного клієнта - нижче.

  3. 3

    Увійдіть і дозвольте доступ

    Асистент відкриє Owlect. Увійдіть через той самий акаунт Google, що й в Owlect, перевірте, який застосунок просить доступ, оберіть, що він зможе робити, і натисніть «Дозволити».

Налаштування клієнта

Owlect працює з будь-яким клієнтом, що підтримує віддалені MCP-сервери з входом через OAuth. Нижче - інструкції для найпоширеніших.

Claude (веб, десктоп і мобільний)

Власні конектори доступні на всіх тарифах Claude. На безкоштовному тарифі - один власний конектор.

  1. 1Відкрийте claude.ai і перейдіть у Налаштування -> Конектори (Settings -> Connectors).
  2. 2Натисніть «Додати власний конектор» (Add custom connector).
  3. 3Назвіть його «Owlect» і вставте адресу сервера. Поля OAuth-клієнта залиште порожніми: Owlect зареєструє Claude автоматично.
  4. 4Натисніть «Додати», а потім «Підключити». Увійдіть в Owlect через Google і натисніть «Дозволити».
  5. 5У чаті відкрийте меню + -> Конектори (Connectors) і переконайтеся, що Owlect увімкнено.

Конектори, додані на claude.ai, з'являються і в десктопному та мобільному застосунках Claude. На тарифах Team і Enterprise спершу власник має додати конектор для організації.

ChatGPT

ChatGPT підключається до власних MCP-серверів у режимі розробника.

  1. 1Відкрийте ChatGPT у браузері, перейдіть у Налаштування -> Застосунки та конектори -> Додаткові налаштування (Settings -> Apps & Connectors -> Advanced settings) і увімкніть режим розробника (Developer mode).
  2. 2Поверніться в «Застосунки та конектори» і натисніть «Створити» (Create).
  3. 3Назвіть його «Owlect», вставте адресу сервера й оберіть OAuth як спосіб автентифікації.
  4. 4Натисніть «Створити». Відкриється вікно входу: увійдіть в Owlect через Google і натисніть «Дозволити».
  5. 5У новому чаті оберіть Owlect у меню інструментів (+), щоб ChatGPT міг ним користуватися.

Режим розробника і власні застосунки залежать від тарифу ChatGPT і налаштувань робочого простору. Якщо ви не бачите цієї опції, можливо, її має дозволити адміністратор.

Claude Code

Додайте сервер у терміналі, а потім увійдіть зсередини Claude Code.

  1. 1Виконайте команду нижче.
  2. 2Запустіть Claude Code, введіть /mcp, оберіть owlect і натисніть Authenticate. У браузері відкриється вхід в Owlect.
bash
claude mcp add --transport http owlect https://owlect.app/api/mcp

VS Code (режим агента GitHub Copilot)

Додайте Owlect у MCP-конфігурацію робочого простору чи користувача.

  1. 1Створіть .vscode/mcp.json (або відкрийте MCP-конфігурацію користувача) з фрагментом нижче.
  2. 2Натисніть Start над записом сервера. VS Code відкриє вхід в Owlect у браузері.
json
{
  "servers": {
    "owlect": {
      "type": "http",
      "url": "https://owlect.app/api/mcp"
    }
  }
}

Cursor та інші клієнти

Клієнти, які працюють лише через stdio або входять через власну схему адрес (наприклад, cursor://), можуть підключитися через міст mcp-remote, що виконує вхід на localhost.

  1. 1Додайте фрагмент нижче в MCP-конфігурацію клієнта (для Cursor: ~/.cursor/mcp.json).
  2. 2Перезапустіть клієнт. Під час першого запуску mcp-remote відкриє вхід в Owlect у браузері.
json
{
  "mcpServers": {
    "owlect": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://owlect.app/api/mcp"
      ]
    }
  }
}

Owlect приймає лише https-адреси повернення або http на localhost. Тому для власних схем адрес потрібен міст.

MCP Inspector (для розробників)

Офіційний Inspector - найшвидший спосіб побачити інструменти й викликати їх вручну.

  1. 1Виконайте команду нижче.
  2. 2Оберіть Streamable HTTP, вставте адресу сервера й натисніть Connect. Завершіть вхід і відкрийте вкладку Tools.
bash
npx -y @modelcontextprotocol/inspector

Інструменти

Кожен інструмент працює лише з даними користувача, який увійшов. Асистент ніколи не передає ідентифікатор користувача: він береться з токена доступу.

Читання

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

get_account

Читання

Ваш тариф і скільки предметів і колекцій ви вже використали з ліміту.

Без параметрів.

list_collections

Читання

Усі ваші колекції з типом, кількістю предметів і публічним посиланням, нещодавно змінені - першими.

Без параметрів.

get_collection

Читання

Одна колекція з її власними полями (ключ, назва, тип, допустимі варіанти). Асистенти викликають її перед додаванням чи зміною предметів, щоб значення потрапили у правильні поля.

  • collectionIdОбов'язковий

    uuid

    Ідентифікатор однієї з колекцій користувача (зі списку колекцій).

search_items

Читання

Предмети однієї колекції, найновіші першими, з необов'язковим пошуком за назвою і фільтром «на продаж». Повертає сторінки з курсором наступної сторінки.

  • collectionIdОбов'язковий

    uuid

    Колекція для пошуку.

  • query

    string, max 200

    Пошук за назвою предмета без урахування регістру.

  • forSale

    boolean

    true - предмети на продаж, false - решта.

  • limit

    integer 1-50, default 20

    Предметів на сторінці.

  • cursor

    string (nextCursor from the previous page)

    nextCursor з попередньої сторінки. Для першої сторінки не передавайте.

get_item

Читання

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

  • itemIdОбов'язковий

    uuid

    Ідентифікатор предмета (зі списку чи пошуку в колекції).

Запис

Інструментам створення потрібен дозвіл на створення, інструментам зміни - дозвіл на зміну.

create_collection

Запис

Створює колекцію. Вбудовані типи отримують свої стандартні поля. Власний тип (custom) потребує Owlect Plus.

  • nameОбов'язковий

    string, 1-100

    Назва колекції.

  • typeОбов'язковий

    dolls | board_games | coins | stamps | music | pokemon_cards | sneakers | retro_games | funko_pop | lego | comic_books | books | watches | cars | hot_wheels | custom

    Тип колекції. Визначає стандартні поля та пошук у застосунку.

  • description

    string, max 500

    Показується на сторінці колекції.

  • fieldDefinitions

    array of { key, label, type, options?, required? }

    Власні поля. Не передавайте, щоб отримати стандартні поля типу.

update_collection

Запис

Перейменовує колекцію, змінює опис або замінює визначення полів. Те, чого ви не надіслали, лишається без змін.

  • collectionIdОбов'язковий

    uuid

    Колекція, яку змінюємо.

  • name

    string, 1-100

    Нова назва.

  • description

    string, max 500

    Новий опис.

  • fieldDefinitions

    array of { key, label, type, options?, required? }

    Замінює весь список полів.

create_items

Запис

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

  • collectionIdОбов'язковий

    uuid

    Колекція, до якої додаємо.

  • itemsОбов'язковий

    array, 1-50 items

    Предмети для створення.

  • items[].nameОбов'язковий

    string, 1-200

    Назва предмета.

  • items[].description

    string, max 1000

    Довільні нотатки.

  • items[].quantity

    integer 1-999

    Скільки примірників у вас є.

  • items[].customFieldValues

    object: field key -> string | number | boolean | null

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

  • items[].forSale

    boolean

    Виставляє предмет на продаж.

  • items[].salePrice

    integer (whole currency units) | null

    Ціна в цілих одиницях, наприклад 40 для $40.

  • items[].saleCurrency

    currency code, e.g. USD, EUR, UAH

    Валюта ціни. За замовчуванням USD.

  • items[].completeness

    complete | incomplete | partial | sealed | unknown | null

    Чи предмет повний, запечатаний тощо.

  • items[].barcode

    string, max 64 | null

    EAN, UPC або ISBN.

  • items[].coverUrl

    https URL | null

    Посилання на зображення обкладинки. Зберігається як посилання, файл не завантажується.

update_item

Запис

Змінює лише надіслані поля. Власні поля об'єднуються за ключем, а null очищує поле. Щоб виставити предмет на продаж, задайте forSale і salePrice.

  • itemIdОбов'язковий

    uuid

    Предмет, який змінюємо.

  • name

    string, 1-200

    Нова назва.

  • description

    string, max 1000

    Довільні нотатки.

  • quantity

    integer 1-999

    Скільки примірників у вас є.

  • customFieldValues

    object: field key -> string | number | boolean | null

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

  • forSale

    boolean

    Виставляє предмет на продаж.

  • salePrice

    integer (whole currency units) | null

    Ціна в цілих одиницях, наприклад 40 для $40.

  • saleCurrency

    currency code, e.g. USD, EUR, UAH

    Валюта ціни. За замовчуванням USD.

  • completeness

    complete | incomplete | partial | sealed | unknown | null

    Чи предмет повний, запечатаний тощо.

  • barcode

    string, max 64 | null

    EAN, UPC або ISBN.

  • coverUrl

    https URL | null

    Посилання на зображення обкладинки. Зберігається як посилання, файл не завантажується.

Видалення

Незворотні. Потрібен дозвіл на видалення (вимкнений, поки ви його не позначите), мають окремий невеликий денний ліміт, а асистентам сказано викликати їх лише на ваше прохання.

delete_collection

Видалення

Видаляє колекцію разом з усіма предметами. Відмовляє, якщо confirmName не збігається з точною назвою колекції.

  • collectionIdОбов'язковий

    uuid

    Колекція, яку видаляємо.

  • confirmNameОбов'язковий

    string (the collection's exact name)

    Має точно збігатися з назвою колекції.

delete_items

Видалення

Видаляє до 25 предметів з однієї колекції.

  • collectionIdОбов'язковий

    uuid

    Колекція, до якої належать предмети.

  • itemIdsОбов'язковий

    array of uuid, 1-25

    Ідентифікатори предметів для видалення.

Дозволи та ліміти

Натискаючи «Дозволити», ви обираєте, що може робити асистент. Усі підключені застосунки видно в Owlect у розділі Налаштування -> Підключені застосунки, і будь-який можна відключити.

read

Переглядати ваші колекції та предмети. Завжди увімкнено.

create

Додавати колекції та предмети. Увімкнено за замовчуванням.

update

Змінювати колекції та предмети. Вимкнено, поки ви не позначите.

delete

Видаляти колекції та предмети. Вимкнено, поки ви не позначите.

Ліміти для кожного підключеного застосунку

  • 120 викликів інструментів на хвилину.
  • 500 змін на день.
  • 20 викликів видалення на день. Більше - лише в застосунку Owlect.
  • Разом для всіх підключених застосунків: 1000 змін і 40 викликів видалення на день.
  • До 50 предметів за виклик create_items і до 25 за виклик delete_items.
  • Ліміти предметів і колекцій вашого тарифу діють так само, як у застосунку.

Чого конектор не може

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

Безпека і приватність

  • Ви входите на owlect.app через Google. Асистент ніколи не бачить ні пароля Google, ні вашої сесії Owlect.
  • Екран дозволу показує вебадресу, на яку застосунок поверне вас. Owlect позначає застосунки, які не перевіряв. Дозволяйте доступ лише тим, які ви почали підключати самі.
  • Термін дії токена доступу: 1 година, далі він оновлюється автоматично. Owlect зберігає лише хеш кожного токена.
  • Відключення застосунку в Налаштування -> Підключені застосунки зупиняє його одразу, разом із токенами, які він уже має.
  • Видалення незворотне. Асистентам сказано видаляти лише на ваше прохання, а для видалення колекції потрібна її точна назва.

Вирішення проблем

У вікні входу написано «Це посилання для підключення не працює».

Запит на підключення був неповним або надійшов від застосунку, якого Owlect не знає. Видаліть конектор в асистенті й додайте знову.

Асистент каже, що не автентифікований, або просить перепідключитися.

Застосунок відключили в налаштуваннях або минув термін входу. Перепідключіть його в налаштуваннях конекторів асистента.

Асистент каже, що підключенню не дозволено змінювати (створювати чи видаляти).

Ви не позначили цю дію на екрані дозволу. Відключіть застосунок у Налаштування -> Підключені застосунки і підключіть знову, позначивши, що він має вміти.

Помилки «Unknown field» під час додавання предметів.

У кожної колекції свої поля. Попросіть асистента спершу переглянути поля колекції. Допустимі ключі він також отримує в тексті помилки.

Досягнуто ліміту предметів чи колекцій.

Діють ті самі ліміти тарифу, що й у застосунку. Використання можна перевірити через get_account; щоб отримати більше місця, перейдіть на Plus або запросіть друзів.

Зміни не видно у відкритій вкладці Owlect.

Оновіть сторінку. Зміни, зроблені асистентом, з'являються після оновлення.

Cursor (чи інший клієнт) не може увійти.

Скористайтеся налаштуванням через mcp-remote вище. Клієнти, що входять через власну схему адрес, напряму не приймаються.

Технічний довідник

Для розробників, які створюють або налагоджують клієнт.

MCP-ендпоінт
https://owlect.app/api/mcp
Транспорт
Streamable HTTP без стану (без сесій). JSON-RPC 2.0.
Метадані захищеного ресурсу (RFC 9728)
https://owlect.app/.well-known/oauth-protected-resource/api/mcp
Метадані сервера авторизації (RFC 8414)
https://owlect.app/.well-known/oauth-authorization-server
Динамічна реєстрація клієнтів (RFC 7591)
POST https://owlect.app/api/oauth/register. Лише публічні клієнти (token_endpoint_auth_method: none). Адреси повернення - https або http на localhost.
Ендпоінт авторизації
https://owlect.app/oauth/authorize
Ендпоінт токенів
POST https://owlect.app/api/oauth/token
Відкликання (RFC 7009)
POST https://owlect.app/api/oauth/revoke
PKCE
Обов'язковий, лише S256.
Області доступу
read, create, update, delete
Термін дії токенів
Доступ - 1 година, оновлення - 30 днів, оновлюється при кожному використанні. Повторне використання витраченого токена оновлення відкликає весь ланцюжок.
Запити без автентифікації
401 із заголовком WWW-Authenticate: Bearer ... resource_metadata="...", що вказує на метадані захищеного ресурсу.