Paletoo API / MCP
Програмний інтерфейс Paletoo — віддалений сервер Model Context Protocol. AI-асистент або ваш власний агент підключається до нього, людина входить своїм обліковим записом Paletoo, і агент створює та змінює справжні дизайни в її файлах.
Сервер
| Адреса | https://paletoo.com/mcp |
|---|---|
| Транспорт | Streamable HTTP: POST JSON-RPC 2.0; на GET за потоком подій сервер відповідає 405 (власного потоку немає), як дозволяє специфікація |
| Версії протоколу | 2025-06-18, 2025-03-26, 2024-11-05 |
| Вхід | OAuth 2.1, authorization code з PKCE (S256), публічні клієнти; динамічна реєстрація клієнтів і Client ID Metadata Documents. Scope designs |
| Пошук | /.well-known/oauth-protected-resource/mcp (RFC 9728), /.well-known/oauth-authorization-server (RFC 8414), /.well-known/mcp/server-card.json (картка MCP-сервера), /.well-known/api-catalog (RFC 9727) |
| Стан | /mcp/status: чи ввімкнено сервер, у JSON, без даних про людей |
| Можливості | tools, prompts, resources |
Як підключити
- Claude: Settings → Connectors → Add custom connector, URL
https://paletoo.com/mcp. - ChatGPT: Settings → Apps → Advanced → Developer mode → Create, URL
https://paletoo.com/mcp, автентифікація OAuth. - Claude Code:
claude mcp add --transport http paletoo https://paletoo.com/mcp, потім/mcp, щоб увійти. - Codex:
codex mcp add paletoo --url https://paletoo.com/mcp, потімcodex mcp login paletoo. - Ваш агент: будь-який MCP-клієнт зі Streamable HTTP і OAuth. Перший виклик без токена отримує
401ізWWW-Authenticate: Bearer resource_metadata=…; пройдіть за ним, зареєструйтеся, відправте людину ввійти, потім викликайте зAuthorization: Bearer.
Підключення відкриває paletoo.com: людина входить (обліковий запис Paletoo безкоштовний) і натискає Allow. Далі агент працює лише з її файлами, а відключити його можна будь-коли (налаштування облікового запису → Підключені застосунки).
Інструменти
Сервер надає 37 інструментів. Їхні назви й описи — англійською, так їх читає асистент.
Створити
| Інструмент | Що робить | Тип |
|---|---|---|
get_started | What Paletoo can do and how to begin, for the assistant. | читає |
create_design | A finished, editable design from a template, in one call: posts, stories, carousels, thumbnails, cards, posters. | змінює |
compose_design | A design laid out from scratch, element by element, when no template fits. | змінює |
create_campaign | One brief → a post, a story and a banner (or the sizes named) in one look, each laid out for its shape. | змінює |
make_campaign | create_campaign under its older name. | змінює |
bulk_create | Many designs from a table: one row, one design. | змінює |
make_variants | 2–5 alternative layouts of the same words beside the design. | змінює |
style_battle | Three or four different art directions of one idea, side by side. | змінює |
keep_direction | Keeps the direction chosen after a style battle and removes the others. | змінює |
surprise_me | An unexpected but tasteful direction for an idea, with a line on why. | змінює |
brand_from_logo | From a logo: a palette, a type pairing, colour and text styles, a brand sheet. | змінює |
generate_visual | A picture by words: Paletoo’s own library first; AI generation for credits only after the person agrees. | змінює |
upload_picture | A one-time upload link (15 minutes, for the person only) for their own photo or logo. | змінює |
Змінити
| Інструмент | Що робить | Тип |
|---|---|---|
modify_design | Changes words, sizes, colours, the photo or the look; each change is a new version. | змінює |
refine_design | Polishes a design: spacing, hierarchy, contrast. | змінює |
adjust_design | Precise changes to one element: position, size, colour, type. | змінює |
edit_text | Changes the words of a design by role. | змінює |
replace_photo | Puts another photo in a design. | змінює |
remove_background | Cuts the subject out of a photo in a design. | змінює |
apply_effect | Applies an effect: risograph, halftone, glitch, duotone, grain and more. | змінює |
apply_style_recipe | Applies a whole style (a look made of several effects). | змінює |
apply_brand | Puts the person’s brand kit (colours, fonts) on a design. | змінює |
add_element | Adds a shape, an icon, a sticker or a line. | змінює |
resize_design | The same design in another format, laid out again for its shape. | змінює |
translate_design | The design’s words in another language, in a copy. | змінює |
animate_design | Makes a design move with Paletoo’s own motion; with the design open, also the video. | змінює |
motion_preview | A short looping GIF of a design in motion, made by the person’s open editor. | змінює |
mockup_it | Puts a design into a mockup that suits it: a phone, a frame, a tee, a laptop. | змінює |
share_design | Only when the person asks: turns on a share link (view or edit) and returns it. | змінює |
Прочитати й експортувати
| Інструмент | Що робить | Тип |
|---|---|---|
get_preview | A picture of the design, rendered by Paletoo. | читає |
get_design | Reads a design: artboards, words by role, photos and colours. | читає |
describe_design | Says what is where in a design, for precise changes. | читає |
list_designs | The person’s designs, newest first. | читає |
list_styles | The styles, templates and looks. | читає |
describe_catalogue | Paletoo’s catalogue: formats, template families, effects. | читає |
export_design | The design as a file (PNG, JPG, PDF, MP4, GIF, WebM), for the person alone, for an hour. | читає |
export_campaign | Every format of a design in its fitting file, in one zip, for an hour. | читає |
Промпти й ресурси
Промпти: instagram_campaign, event_poster, brand_kit_from_logo, surprise_me, style_battle, get_started. Ресурси: paletoo://brand-kit, paletoo://designs/recent і шаблон paletoo://designs/{id}.
Приклади запитів
- «Зроби допис і сторіз в Instagram про відкриття моєї кав’ярні в суботу, теплий мінімалізм»
- «Зроби постер для джазового вечора з ефектом різографії»
- «Ось мій логотип — зроби бренд-лист із кольорами й шрифтами»
- «Анімуй мій допис і експортуй як MP4»
- «Збільш заголовок і спробуй напівтон»
Ліміти
- Дизайнів на день: 10 на безкоштовному плані, 200 з Pro (лічильник оновлюється опівночі за UTC).
- Не більше 60 викликів інструментів на хвилину на людину.
- Він не може видаляти дизайни, запрошувати людей чи бачити файли, якими з людиною не поділилися. AI-кредити витрачає лише на згенероване зображення і лише після того, як людина погодиться з ціною.
- Вигляд і відео потребують дизайну, відкритого в редакторі людини; прев’ю працюють і з закритим дизайном (їх малює сервер, кількість на день обмежена).
Помилки
Помилки JSON-RPC мають форму JSON-RPC ({"jsonrpc":"2.0","error":{"code","message"}}). Помилки входу — форму OAuth ({"error","error_description"}, RFC 6749 / 6750) з полем hint. Власні адреси сайту /__… — для редактора, а не публічний API; вони відповідають {"error":{"code","message"}}.
Чи є REST API?
Публічного REST API немає, тож немає й опису OpenAPI: власні адреси редактора змінюються разом із ним і не призначені для інших. Усе, що може агент, іде через MCP-сервер вище, за згодою людини.
Ще
- Документація конектора: усі інструменти, конфіденційність, якщо щось не так
- Paletoo у Claude і ChatGPT: як це виглядає
- llms.txt: сайт для мовних моделей; кожна сторінка є й у Markdown (додайте
.mdдо адреси або надішлітьAccept: text/markdown) - Контакти: [email protected]