Gradiently MCP: koppel Claude, ChatGPT of elke MCP-client

Om de Gradiently MCP-server te gebruiken, maak je een API-sleutel in Instellingen › API en agents en voeg je het gehoste endpoint https://gradiently.design/api/mcp toe aan je MCP-client, met de header Authorization: Bearer <je sleutel>. Dat is de hele verbinding. Vanaf dan kan een assistent als Claude Marks zoeken, je merk lezen, ontwerpen maken en wijzigen, en elk ontwerp dat hij maakt opent in je Studio zoals elk ander.

MCP, het Model Context Protocol, is een open standaard waarmee AI-assistenten echte tools kunnen gebruiken. Is het idee nieuw, dan legt wat MCP is het uit in gewone woorden, en de site van het protocol zelf op modelcontextprotocol.io heeft de specificatie. De volledige technische referentie voor de server van Gradiently staat in de ontwikkelaarsdocumentatie.

Wat je nodig hebt voordat je begint

• Een Gradiently-account en een workspace waarvan je eigenaar of beheerder bent. Alleen eigenaren en beheerders kunnen sleutels maken of intrekken.
• Een MCP-client die via HTTP met een externe server kan verbinden en een eigen Authorization-header kan sturen. Claude Code kan dat; veel desktop- en editorclients ook.
• Een veilige plek voor de sleutel, zoals een wachtwoordmanager of de geheime opslag van je client. Hij wordt maar één keer getoond.

Stap 1: maak een API-sleutel met beperkte rechten

1. 1

   Open Instellingen › API en agents

   Kies bovenaan met de kiezer de workspace waarin de assistent moet werken. Een sleutel werkt alleen in de workspace die hem heeft uitgegeven.

2. 2

   Noem hem naar waar hij wordt gebruikt

   “Claude Desktop” of “Marketingagent”. De naam is hoe je later weet welke je moet intrekken.

3. 3

   Vink alleen aan wat hij nodig heeft

   De rechten staan hieronder. Vier zijn standaard aangevinkt; Marks claimen niet.

4. 4

   Maak hem aan en kopieer hem nu

   De sleutel verschijnt één keer, volledig. Kopieer hem naar je wachtwoordmanager voordat je het venster sluit. Daarna toont Instellingen alleen de eerste tekens, wanneer hij voor het laatst is gebruikt en hoeveel rechten hij heeft.

Stap 2: voeg het endpoint toe aan je client

Dezelfde pagina toont een kant-en-klaar fragment onder Een MCP-client verbinden, met een kopieerknop. Clients die een JSON-configuratie lezen nemen het zoals het is; zet je sleutel op de plek van YOUR_KEY.

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

Voeg in Claude Code de server toe vanuit je terminal. Bewaar de sleutel in een omgevingsvariabele in plaats van hem in je shellgeschiedenis te typen.

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

Andere assistenten, waaronder ChatGPT, kunnen verbinden waar hun app, abonnement en workspace-instellingen een eigen externe MCP-server met een authorization-header toestaan. Ondersteuning verschilt per client en verandert in de tijd, dus bekijk de eigen helppagina’s van je client; on-brand ontwerpen maken vanuit ChatGPT behandelt waar je op let. Vraag na het verbinden de assistent zijn Gradiently-tools op te sommen om te bevestigen dat het werkte.

Wat je assistent kan zodra hij verbonden is

De server biedt dezelfde acties als in het product, met dezelfde rechten. Gegroepeerd naar taak zien ze er zo uit:

Gewone verzoeken werken het best. De assistent geeft ze door aan de Designer, die je merkprofiel en de Mark van het merk leest voordat hij iets samenstelt. Net als in de Studio wordt het werk van de Designer gemeten in AI-tegoed.

• “Maak zes posts voor onze herfstlancering in onze huisstijl, staand voor Instagram.”
• “Neem de aankondiging van gisteren en maak er een story en een X-header van.”
• “Zoek drie donkere Marks met een zijden materiaal en geef me hun codes.”
• “Werk ons merkprofiel bij: we klinken rustig en precies, nooit verkoperig.”

Voor een uitgebreidere uitleg specifiek met Claude, zie ontwerpen met Claude via Gradiently. Wil je dat de assistent in je huisstijl blijft, dan laat huisstijlrichtlijnen die je AI-assistent kan volgen zien hoe je het merkprofiel schrijft dat hij leest.

De verbinding veilig houden

Enkele garanties gelden wat de client ook doet. Een sleutel werkt alleen in de workspace die hem heeft uitgegeven. Hij handelt volgens dezelfde regels als de persoon die hem maakte, dus hij kan niets wat hun rol niet kan. Een sleutel draagt het eigendom van een Mark nooit over aan de workspace of iemand anders. Privéontwerpen blijven privé: een weergavelink bestaat alleen als je erom vraagt. En als de persoon die een sleutel maakte uit de workspace wordt verwijderd of zijn beheerdersrol verliest, stoppen ook zijn sleutels met werken.