Paletoo API / MCP

Programowalny interfejs Paletoo to zdalny serwer Model Context Protocol. Asystent AI lub Twój własny agent łączy się z nim, osoba loguje się swoim kontem Paletoo, a agent tworzy i zmienia prawdziwe, edytowalne projekty w jej plikach.

Serwer

Adres	`https://paletoo.com/mcp`
Transport	Streamable HTTP: `POST` JSON-RPC 2.0; na `GET` po strumień zdarzeń serwer odpowiada `405` (bez własnego strumienia), na co pozwala specyfikacja
Wersje protokołu	`2025-06-18`, `2025-03-26`, `2024-11-05`
Logowanie	OAuth 2.1, authorization code z PKCE (S256), klienci publiczni; dynamiczna rejestracja klientów i Client ID Metadata Documents. Scope `designs`
Wykrywanie	`/.well-known/oauth-protected-resource/mcp` (RFC 9728), `/.well-known/oauth-authorization-server` (RFC 8414), `/.well-known/mcp/server-card.json` (karta serwera MCP), `/.well-known/api-catalog` (RFC 9727)
Stan	`/mcp/status`: czy serwer działa, w JSON, bez danych o ludziach
Możliwości	tools, prompts, resources

Jak połączyć

Claude: Settings → Connectors → Add custom connector, URL https://paletoo.com/mcp.
ChatGPT: Settings → Apps → Advanced → Developer mode → Create, URL https://paletoo.com/mcp, uwierzytelnianie OAuth.
Claude Code: claude mcp add --transport http paletoo https://paletoo.com/mcp, potem /mcp, aby się zalogować.
Codex: codex mcp add paletoo --url https://paletoo.com/mcp, potem codex mcp login paletoo.
Twój agent: dowolny klient MCP ze Streamable HTTP i OAuth. Pierwsze wywołanie bez tokena dostaje 401 z WWW-Authenticate: Bearer resource_metadata=…; podążaj za nim, zarejestruj się, poproś osobę o zalogowanie, potem wywołuj z Authorization: Bearer.

Połączenie otwiera paletoo.com: osoba loguje się (konto Paletoo jest darmowe) i naciska Allow. Agent działa wtedy tylko w jej plikach, a odłączyć go można w każdej chwili (ustawienia konta → Połączone aplikacje).

Narzędzia

Serwer udostępnia 37 narzędzi. Ich nazwy i opisy są po angielsku, tak czyta je asystent.

Tworzenie

Narzędzie	Co robi	Rodzaj
`get_started`	What Paletoo can do and how to begin, for the assistant.	czyta
`create_design`	A finished, editable design from a template, in one call: posts, stories, carousels, thumbnails, cards, posters.	zmienia
`compose_design`	A design laid out from scratch, element by element, when no template fits.	zmienia
`create_campaign`	One brief → a post, a story and a banner (or the sizes named) in one look, each laid out for its shape.	zmienia
`make_campaign`	create_campaign under its older name.	zmienia
`bulk_create`	Many designs from a table: one row, one design.	zmienia
`make_variants`	2–5 alternative layouts of the same words beside the design.	zmienia
`style_battle`	Three or four different art directions of one idea, side by side.	zmienia
`keep_direction`	Keeps the direction chosen after a style battle and removes the others.	zmienia
`surprise_me`	An unexpected but tasteful direction for an idea, with a line on why.	zmienia
`brand_from_logo`	From a logo: a palette, a type pairing, colour and text styles, a brand sheet.	zmienia
`generate_visual`	A picture by words: Paletoo’s own library first; AI generation for credits only after the person agrees.	zmienia
`upload_picture`	A one-time upload link (15 minutes, for the person only) for their own photo or logo.	zmienia

Zmiany

Narzędzie	Co robi	Rodzaj
`modify_design`	Changes words, sizes, colours, the photo or the look; each change is a new version.	zmienia
`refine_design`	Polishes a design: spacing, hierarchy, contrast.	zmienia
`adjust_design`	Precise changes to one element: position, size, colour, type.	zmienia
`edit_text`	Changes the words of a design by role.	zmienia
`replace_photo`	Puts another photo in a design.	zmienia
`remove_background`	Cuts the subject out of a photo in a design.	zmienia
`apply_effect`	Applies an effect: risograph, halftone, glitch, duotone, grain and more.	zmienia
`apply_style_recipe`	Applies a whole style (a look made of several effects).	zmienia
`apply_brand`	Puts the person’s brand kit (colours, fonts) on a design.	zmienia
`add_element`	Adds a shape, an icon, a sticker or a line.	zmienia
`resize_design`	The same design in another format, laid out again for its shape.	zmienia
`translate_design`	The design’s words in another language, in a copy.	zmienia
`animate_design`	Makes a design move with Paletoo’s own motion; with the design open, also the video.	zmienia
`motion_preview`	A short looping GIF of a design in motion, made by the person’s open editor.	zmienia
`mockup_it`	Puts a design into a mockup that suits it: a phone, a frame, a tee, a laptop.	zmienia
`share_design`	Only when the person asks: turns on a share link (view or edit) and returns it.	zmienia

Odczyt i eksport

Narzędzie	Co robi	Rodzaj
`get_preview`	A picture of the design, rendered by Paletoo.	czyta
`get_design`	Reads a design: artboards, words by role, photos and colours.	czyta
`describe_design`	Says what is where in a design, for precise changes.	czyta
`list_designs`	The person’s designs, newest first.	czyta
`list_styles`	The styles, templates and looks.	czyta
`describe_catalogue`	Paletoo’s catalogue: formats, template families, effects.	czyta
`export_design`	The design as a file (PNG, JPG, PDF, MP4, GIF, WebM), for the person alone, for an hour.	czyta
`export_campaign`	Every format of a design in its fitting file, in one zip, for an hour.	czyta

Prompty i zasoby

Prompty: instagram_campaign, event_poster, brand_kit_from_logo, surprise_me, style_battle, get_started. Zasoby: paletoo://brand-kit, paletoo://designs/recent i szablon paletoo://designs/{id}.

Przykładowe polecenia

«Zrób post i relację na Instagram o otwarciu mojej kawiarni w sobotę, ciepły minimalizm»
«Zrób plakat na wieczór jazzowy w stylu risografii»
«Oto moje logo — zrób arkusz marki z kolorami i fontami»
«Animuj mój post i wyeksportuj jako MP4»
«Powiększ nagłówek i spróbuj efektu półtonu»

Limity

Projektów dziennie: 10 w planie darmowym, 200 z Pro (licznik zeruje się o północy UTC).
Najwyżej 60 wywołań narzędzi na minutę na osobę.
Nie może usuwać projektów, zapraszać ludzi ani widzieć plików, których nie udostępniono tej osobie. Kredyty AI wydaje tylko na wygenerowany obraz i tylko po zgodzie osoby na cenę.
Wygląd i wideo wymagają projektu otwartego w edytorze osoby; podglądy działają też przy zamkniętym projekcie (renderuje je serwer, liczba dzienna jest ograniczona).

Błędy

Błędy JSON-RPC mają kształt JSON-RPC ({"jsonrpc":"2.0","error":{"code","message"}}). Błędy logowania — kształt OAuth ({"error","error_description"}, RFC 6749 / 6750) z polem hint. Własne adresy strony /__… są dla edytora, nie są publicznym API; odpowiadają {"error":{"code","message"}}.

Czy jest REST API?

Nie ma publicznego REST API, więc nie ma też opisu OpenAPI: własne adresy edytora zmieniają się razem z nim i nie są przeznaczone dla innych. Wszystko, co może agent, idzie przez serwer MCP powyżej, za zgodą osoby.

Więcej

Dokumentacja konektora: wszystkie narzędzia, prywatność, rozwiązywanie problemów
Paletoo w Claude i ChatGPT: jak to wygląda
llms.txt: strona dla modeli językowych; każda strona jest też w Markdown (dodaj .md do adresu lub wyślij Accept: text/markdown)
Kontakt: [email protected]