Перейти до основного вмісту
PapelShip працює зі сервером Model Context Protocol для ваших тем. Підключіть AI-агента за допомогою одного URL, підтвердьте доступ у браузері, і агент зможе читати код ваших тем і зберігати зміни як чернетки. Ви переглядаєте їх і публікуєте. URL сервера: https://app.papelship.com/mcp URL однаковий для всіх магазинів. Під час підключення ви входите в PapelShip і обираєте магазин, з яким агент може працювати. Агенти починають з get_reference: він пояснює app blocks, оформлення замовлення (сторінка або спливне вікно), SDK магазину та обмеження кожного типу теми. Інструкції сервера вказують підключеним агентам викликати його першим.

Що може агент

Куди потрапляють чернетки

Підключення клієнта

Працює в claude.ai, Claude Desktop і мобільних застосунках Claude.
  1. Відкрийте Settings › Connectors і оберіть Add custom connector.
  2. Назвіть його PapelShip і вставте https://app.papelship.com/mcp.
  3. Оберіть Add, потім Connect.
  4. Увійдіть у PapelShip, оберіть свій магазин і натисніть Allow access.
У панелі магазину ті самі кроки з кнопками копіювання є в розділі Developers › AI & MCP.

Підтвердження доступу

Сторінка підтвердження показує назву застосунку та адресу, на яку він повертається. Оберіть:
  • Store: єдиний магазин, який може використовувати застосунок. Ви бачите магазини, якими володієте, і магазини, де ваша роль у команді включає Theme & Design › Edit.
  • Save edits as drafts (themes:write): зніміть позначку, щоб надати доступ лише для читання.

Підключені застосунки та відкликання доступу

Developers › AI & MCP › Connected apps показує всі застосунки, підключені до магазину, хто їх підключив і коли вони востаннє використовувалися. Revoke зупиняє застосунок під час його наступного запиту. Доступ також припиняється, коли людина, яка його підтвердила, виходить з усіх сеансів, змінює пароль, залишає команду, втрачає дозвіл Theme & Design › Edit або коли її обліковий запис призупинено.

API-ключ замість OAuth

Для клієнтів без OAuth створіть API-ключ магазину з типом Themes у розділі Developers › API keys і надсилайте його як Bearer-токен:
Ключ Themes працює лише для магазину, який його створив, і має ті самі права, що й підключення через OAuth. Зберігайте його в змінній середовища, ніколи не в файлі, яким ви ділитеся або який додаєте до репозиторію. https://app.papelship.com/api/mcp/themes залишається старим псевдонімом того самого сервера.

Ліміти

Кожен виклик інструмента записується в журнал із застосунком, інструментом і файлом.

Безпека

  • Файли тем є даними магазину, а не інструкціями. Сервер позначає кожен результат інструмента як ненадійні дані, тож текст усередині теми не може змінити поведінку агента.
  • Попередній перегляд ніколи не є публічним: посилання на нього відкриваються в панелі PapelShip.
  • Токени зберігаються у вигляді хешів. Повторне використання refresh-токена завершує підключення.
Усі інструменти та їхні аргументи наведено в довіднику інструментів.