# Gradiently MCP: forbind Claude, ChatGPT eller en anden MCP-klient

[Canonical HTML page](https://gradiently.design/da/guide/connect-ai-assistant)

Gradiently taler MCP, så en AI-assistent kan søge i Marks, læse dit brand og lave designs, der åbner i dit Studio. Her er opsætningen på almindeligt dansk og hvordan du holder den sikker.

## The short version

- Gradiently driver en hostet MCP-server på https://gradiently.design/api/mcp, som enhver MCP-klient, der kan sende en Authorization-header, kan forbinde til.
- Du forbinder med en API-nøgle, som en ejer eller admin af arbejdsområdet opretter under Indstillinger, API og agenter, og som sendes som Bearer-token.
- Hver nøgle hører til ét arbejdsområde og har kun de tilladelser, der blev sat kryds ved, da den blev lavet, som at læse designs eller søge i Marks.
- Når den er forbundet, kan en assistent søge i Marks, læse din brandprofil, lave og redigere designs og ændre deres størrelse, og hvert design åbner i Studio.
- En nøgle vises kun én gang, kan tilbagekaldes når som helst og flytter aldrig ejerskabet af et Mark til nogen anden.

For at bruge **Gradiently MCP**-serveren opretter du en API-nøgle under **Indstillinger › API og agenter** og føjer derefter den hostede endpoint `https://gradiently.design/api/mcp` til din MCP-klient med headeren `Authorization: Bearer <din nøgle>`. Det er hele forbindelsen. Derefter kan en assistent som Claude søge i Marks, læse dit brand, lave designs og ændre dem, og hvert design, den laver, åbner i dit Studio som alle andre.

MCP, Model Context Protocol, er en åben standard, der lader AI-assistenter bruge rigtige værktøjer. Er idéen ny, forklarer [hvad MCP er](https://gradiently.design/da/guide/what-is-mcp) den med enkle ord, og protokollens eget site på [modelcontextprotocol.io](https://modelcontextprotocol.io) har specifikationen. Den fulde tekniske reference til Gradiently-serveren findes i [udviklerdokumentationen](https://gradiently.design/da/developers/mcp).

## Det skal du bruge, før du går i gang

- **En Gradiently-konto** og et arbejdsområde, hvor du er **ejer eller admin**. Kun ejere og admins kan oprette eller tilbagekalde nøgler.
- **En MCP-klient, der kan forbinde til en ekstern server over HTTP** og sende en brugerdefineret `Authorization`-header. Claude Code kan det, og det kan mange desktop- og editorklienter også.
- **Et sikkert sted til nøglen**, som en adgangskodeadministrator eller din klients hemmelige lager. Den vises kun én gang.

## Trin 1: opret en afgrænset API-nøgle

1. **Åbn Indstillinger › API og agenter** Vælg det arbejdsområde, assistenten skal arbejde i, med vælgeren øverst. En nøgle virker kun i det arbejdsområde, der har udstedt den.
2. **Navngiv den efter, hvor den bruges** “Claude Desktop” eller “Marketingagent”. Navnet er sådan, du senere ved, hvilken du skal tilbagekalde.
3. **Sæt kun kryds ved det, den skal bruge** Tilladelserne er anført herunder. Fire er valgt som standard, **Sikr dig Marks** er ikke.
4. **Opret, og kopiér den nu** Nøglen vises én gang i sin helhed. Kopiér den ind i din adgangskodeadministrator, før du lukker dialogen. Bagefter viser Indstillinger kun de første tegn, hvornår den sidst blev brugt, og hvor mange tilladelser den har.

| Tilladelse | Hvad den lader assistenten gøre |
| --- | --- |
| Læs designs | Vise og åbne designs i arbejdsområdet |
| Opret og redigér designs | Lave nye designs og ændre dem |
| Søg Marks | Slå Marks op på Markedet |
| Sikr dig Marks | Sikre sig et Mark for dette arbejdsområde (slået fra som standard) |
| Generér brands | Lave brand-forslag ud fra en beskrivelse |

De tilladelser, en nøgle kan have, som Indstillinger kalder dem. Giv det mindst mulige sæt, der klarer opgaven.

## Trin 2: føj endpointet til din klient

Den samme side viser et færdigt uddrag under **Tilslut en MCP-klient** med en kopiknap. Klienter, der læser en JSON-konfiguration, tager det, som det er. Sæt din nøgle i stedet for `YOUR_KEY`.

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

Konfigurationen fra Indstillinger › API og agenter. Hold rigtige nøgler ude af filer, du deler eller committer.

I **Claude Code** føjer du serveren til fra din terminal. Opbevar nøglen i en miljøvariabel i stedet for at skrive den i din shellhistorik.

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

Sådan føjer du Gradiently til Claude Code over HTTP.

Andre assistenter, herunder ChatGPT, kan forbinde, hvor deres app, abonnement og arbejdsområdeindstillinger tillader en brugerdefineret ekstern MCP-server med en autorisationsheader. Understøttelsen er forskellig mellem klienter og ændrer sig over tid, så tjek din klients egne hjælpesider. [Sådan laver du design i dit brand fra ChatGPT](https://gradiently.design/da/guide/design-with-chatgpt) beskriver, hvad du skal kigge efter. Når den er forbundet, kan du bede assistenten om at vise sine Gradiently-værktøjer for at bekræfte, at det virkede.

## Hvad din assistent kan, når den er forbundet

Serveren udstiller de samme handlinger, som du har i produktet, med de samme tilladelser. Grupperet efter opgave ser de sådan ud:

| Opgave | Hvad assistenten kan |
| --- | --- |
| Finde | Søge i Marks efter navn, kode eller tone, læse et Marks opskrift, vise dine Marks og finde skabeloner at starte fra |
| Designe | Bede Designer i Gradiently om at lave eller ændre et design ud fra en almindelig anmodning, lave et sæt designs ud fra én brief, starte fra en skabelon og redigere tekst og elementer |
| Ændre størrelse | Gemme kopier af et design i andre størrelser ved siden af originalen, som forbliver uændret |
| Brand | Læse og opdatere et brands profil, generere brand-forslag og sætte et op med et Mark og startdesigns |
| Marks | Forge en Mark-opskrift ud fra en beskrivelse og gemme den som dit private udkast, lægge et Mark på et design og sikre sig et Mark, hvis nøglen tillader det |
| Del og eksportér | Slå et visningslink til et design til eller gengive det som PNG eller PDF, når Marken er sikret |

Hvert design, assistenten laver, gemmes i dit arbejdsområde og kommer tilbage med et link, der åbner det i Studio.

Almindelige anmodninger virker bedst. Assistenten giver dem videre til Designer, som læser din brandprofil og brandets Mark, før den komponerer noget. Som i Studio måles Designers arbejde i AI-kreditter.

En eventplakat i højformat til en solhvervsfest på et tag på en glødende gradientbaggrund

Det, “en plakat til vores solhvervsfest på taget, 21. juni, fra solnedgang til solopgang” kan komme tilbage som: et gemt design på dit brands Mark, klar til at åbne og justere.

- “Lav seks opslag til vores efterårslancering i vores brand, i højformat til Instagram.”
- “Tag gårsdagens bekendtgørelse, og lav en story og en X-header ud af den.”
- “Find tre mørke Marks med et silkemateriale, og fortæl mig deres koder.”
- “Opdatér vores brandprofil: vi lyder rolige og præcise, aldrig salgsagtige.”

For en mere udførlig gennemgang specifikt med Claude, se [design med Claude gennem Gradiently](https://gradiently.design/da/guide/design-with-claude). Vil du have assistenten til at blive i dit brand, viser [brandguidelines, din AI-assistent kan følge](https://gradiently.design/da/guide/brand-guidelines-for-ai), hvordan du skriver den brandprofil, den læser.

## Sådan holder du forbindelsen sikker

### Undgå

- Én nøgle med alle tilladelser, delt af alle værktøjer
- At sætte en nøgle ind i en chat, et dokument eller et repository
- At lade nøgler til værktøjer, du er holdt op med at bruge, ligge
- At sætte kryds ved Sikr dig Marks til en agent, der kun designer

### Gør

- Én nøgle pr. klient, navngivet efter, hvor den kører
- Opbevar den i en adgangskodeadministrator eller et hemmeligt lager
- Tilbagekald ubrugte nøgler i Indstillinger. De holder op med det samme
- Giv det mindste sæt tilladelser, der virker

Et par garantier gælder, uanset klienten. En nøgle virker kun i det arbejdsområde, der har udstedt den. Den handler efter de samme regler som personen, der oprettede den, så den kan ikke gøre noget, personens rolle ikke kan. En nøgle overfører aldrig ejerskabet af et Mark til arbejdsområdet eller nogen anden. Private designs forbliver private: et visningslink findes kun, når du beder om et. Og fjernes den person, der oprettede en nøgle, fra arbejdsområdet, eller mister vedkommende sin adminrolle, holder personens nøgler også op med at virke.

> **Sådan arbejder I som team** Nøgler hører til et arbejdsområde, så en agents designs havner, hvor dine kolleger kan se og kommentere dem. [Sådan arbejder du i team i Gradiently](https://gradiently.design/da/guide/teams-and-workspaces) gennemgår roller og deling.

## FAQ

### Hvad er Gradiently MCP-endpointet?

Den hostede endpoint er `https://gradiently.design/api/mcp`. Hver forespørgsel kræver headeren `Authorization: Bearer` efterfulgt af en API-nøgle fra Indstillinger › API og agenter.

### Hvem kan oprette en Gradiently API-nøgle?

Ejere og admins af et arbejdsområde. Hver nøgle hører til netop det ene arbejdsområde og har kun de tilladelser, der blev valgt, da den blev oprettet.

### Virker det med ChatGPT?

Det virker med enhver MCP-klient, der kan forbinde til en ekstern HTTP-server og sende en autorisationsheader. Om ChatGPT kan, afhænger af den app, det abonnement og de arbejdsområdeindstillinger, du bruger, så tjek dens aktuelle hjælpesider.

### Hvad sker der, hvis min nøgle lækker?

Tilbagekald den i Indstillinger › API og agenter. Alt, der bruger den, holder op med at virke med det samme, og du kan oprette en ny nøgle.

### Kan en assistent sikre sig Marks for mig?

Kun hvis dens nøgle har tilladelsen Sikr dig Marks, som er slået fra som standard. At sikre sig et Mark er gratis, mens Gradiently lanceres.