MCP och AI-assistenter

Model Context Protocol är en öppen standard för att ge AI-assistenter verktyg. Gradiently driver en hostad MCP-server på https://gradiently.design/api/mcp. Anslut den en gång med en API-nyckel, så kan din assistent anropa Gradientlys verktyg medan du pratar med den. Varje verktyg gör samma API-förfrågningar som din egen kod skulle göra, så det har samma behörigheter, licenser, krediter och gränser.

Innan du ansluter

• Skapa en nyckel i Inställningar › API och agenter (se API-nycklar och behörigheter). Nyckeln avgör vilken arbetsyta assistenten arbetar i och vilka verktyg som fungerar.
• Varje förfrågan till servern måste bära nyckeln som Authorization: Bearer gr_live_…, även den första. Utan den svarar servern 401.
• Servern använder Streamable HTTP, tillståndslöst, med JSON-svar. Den behöver ingen session och har ingen separat händelseström att öppna.
• Servern tar bara emot API-nycklar. Den erbjuder ingen inloggning via OAuth.

Anslut Claude Code

Lägg till Gradiently som fjärrserver över HTTP, med din nyckel i huvudet. Förvara nyckeln i en miljövariabel så att den aldrig hamnar i skalets historik eller i en incheckad fil.

export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Starta en ny session i Claude Code och be den lista Gradientlys verktyg för att kontrollera anslutningen. Om den rapporterar ett autentiseringsfel är nyckeln felskriven eller återkallad, eller så är skaparen inte längre ägare eller admin i arbetsytan.

Andra klienter

Alla klienter som kan lägga till en fjärransluten MCP-server över Streamable HTTP och skicka ett eget huvud i förfrågan kan använda Gradiently med samma URL och huvud. Om din klient kan det beror på klienten och dess version.

• Claude Desktop och claude.ai lägger till fjärrservrar som anpassade kopplingar. Om formuläret för kopplingen låter dig ange ett Authorization-huvud använder du URL:en och huvudet ovan. Om det bara erbjuder inloggning via OAuth går Gradiently inte att ansluta där ännu.
• ChatGPT och andra assistenter: samma regel. Där klienten stöder fjärranslutna MCP-servrar med ett bearer-huvud ansluter du den med URL:en och din nyckel.
• Klienter som konfigureras med en JSON-fil accepterar ofta formatet nedan, som också visas i Inställningar under Anslut en MCP-klient. Se klientens dokumentation för exakt format.

{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Så beter sig verktygen

• Varje verktyg returnerar sitt resultat som JSON-text. När något misslyckas returnerar verktyget i stället API:ts felmeddelande, till exempel en saknad behörighet eller en okänd mall.
• Verktyg som behöver ett varumärke tar en valfri personality (dess id eller slug). Utan den använder de arbetsytans första varumärke.
• Verktyg som sparar en design returnerar dess länk till Studion, designens adress /studio/<id> på gradiently.design.
• Flera verktyg slår först upp dina varumärken via /api/me, som kräver både workspaces:read och designs:read. De verktygen listar båda behörigheterna nedan.
• Ett verktygsanrop räknas mot nyckelns hastighetsgräns en gång för MCP-förfrågan och en gång för varje API-förfrågan som verktyget gör.

Marks

En säkring som kräver betalning misslyckas med ett meddelande om att den behöver gå via kassan; slutför den i Gradiently. En nyckel kan inte betala för något.

Varumärken och arbetsyta

tone tar upp till tre av calm, bold, warm, cool, playful, luxe, natural, technical, editorial och nocturnal; en förfrågan med fler avvisas. colours tar upp till åtta hexfärger och count ber om ett till åtta förslag; fler än så avvisas också. För att anta ett förslag skickar du exakt samma indata som genererade det, tillsammans med förslagets key: servern skapar förslaget på nytt från den indatan och litar aldrig på ett recept som klienten skickar.

Designa

design och create_designs förbrukar arbetsytans AI-krediter, precis som Designer i Studion. När saldot är för lågt misslyckas de med ett meddelande om det; fyll på under Inställningar › AI-krediter. Högst två uppsättningar körs samtidigt per person, och en färdig uppsättning går att läsa i ungefär tjugo minuter. Själva designerna finns kvar.

En komposition anger en size (ett id för en förinställd storlek som ig-post, x-post eller li-banner, eller {w, h} i pixlar), en layout (statement, editorial, poster, split, stat, quote, list, event eller minimal) och blocks i läsordning, var och en med en role som headline, body eller cta och sin text.

{
  "composition": {
    "size": "ig-post",
    "layout": "event",
    "blocks": [
      { "role": "eyebrow", "text": "Summer supper club" },
      { "role": "headline", "text": "Long table on the roof" },
      { "role": "details", "text": "", "items": ["Saturday 21 June", "7pm till late"] },
      { "role": "cta", "text": "Book a seat" }
    ]
  }
}

Redigera och exportera

wear_mark på en design kräver designs:read och designs:write. För att göra en Mark till ett varumärkes Mark krävs workspaces:read, designs:read och personalities:write, och en Mark som du innehar med en aktiv licens. Om du anger Marken med dess kod krävs också marks:read.

render_design tar width och height från 1 till 4096 pixlar och format png eller pdf. page räknas från 0: PNG renderar som standard första sidan och PDF alla sidor. En PDF behåller varje sida i dess storlek i Studion, så storleken du begär måste stämma. Rendering kräver samma exportlicens för designens Mark som i Studion, och den publicerar eller ändrar aldrig designen.

Exempel på uppmaningar

• ”Hitta mörka Marks på Marknaden med krom i och visa mig de tre som ligger närmast djup petrol.” Använder search_marks.
• ”Generera varumärkesriktningar för Hearth, ett kvartersbageri, lugnt och varmt, och anta den med mjukast palett.” Använder generate_brand och adopt_brand.
• ”Smid en Mark som heter Night Harbour: en tom grund, marinblått till natriumorange, ett stilla kornlager. Åtgärda allt som granskningen flaggar och spara den sedan.” Använder make_mark och save_mark.
• ”Ändra rubriken på design 4f1c… till ’Dörrarna öppnar klockan sju’ och gör kopior för en Instagram-story och ett inlägg på X.” Använder get_design, update_design_text och resize_copies.
• ”Rendera design 4f1c… som en PNG på 1080 gånger 1350 och spara den som launch.png.” Använder render_design.
• ”Gör en affisch för vår solståndsfest på taket, 21 juni, från solnedgång till soluppgång.” Använder design, som kräver workspaces:read.

Hela referensen för slutpunkterna bakom de här verktygen finns i API-referens. För allt annat, skicka en förfrågan.