# Gradiently MCP: liga o Claude, o ChatGPT ou outro cliente MCP

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

A Gradiently fala MCP, por isso um assistente de IA pode pesquisar Marks, ler a tua marca e criar designs que abrem no teu Studio. Eis a configuração em linguagem simples e como a manter segura.

## The short version

- A Gradiently tem um servidor MCP alojado em https://gradiently.design/api/mcp a que se pode ligar qualquer cliente MCP capaz de enviar um cabeçalho Authorization.
- Ligas-te com uma chave de API criada por um proprietário ou administrador do espaço de trabalho em Definições, em API e agentes, enviada como token Bearer.
- Cada chave pertence a um espaço de trabalho e leva apenas as permissões assinaladas quando foi criada, como ler designs ou pesquisar Marks.
- Depois de ligado, um assistente pode pesquisar Marks, ler o perfil da tua marca, criar e editar designs e redimensioná-los, e cada design abre no Studio.
- Uma chave é mostrada uma só vez, pode ser revogada em qualquer momento e nunca passa a titularidade de um Mark para mais ninguém.

Para usar o servidor **Gradiently MCP**, cria uma chave de API em **Definições › API e agentes** e depois adiciona o endpoint alojado `https://gradiently.design/api/mcp` ao teu cliente MCP com o cabeçalho `Authorization: Bearer <a tua chave>`. É toda a ligação. A partir daí, um assistente como o Claude pode pesquisar Marks, ler a tua marca, criar designs e alterá-los, e cada design que cria abre no teu Studio como qualquer outro.

O MCP, o Model Context Protocol, é um padrão aberto que permite aos assistentes de IA usar ferramentas reais. Se a ideia é nova, o guia sobre [o que é o MCP](https://gradiently.design/pt-pt/guide/what-is-mcp) explica-a em palavras simples, e o site do próprio protocolo, [modelcontextprotocol.io](https://modelcontextprotocol.io), tem a especificação. A referência técnica completa do servidor da Gradiently está na [documentação para programadores](https://gradiently.design/pt-pt/developers/mcp).

## O que precisas antes de começar

- **Uma conta Gradiently** e um espaço de trabalho de que sejas **proprietário ou administrador**. Só proprietários e administradores podem criar ou revogar chaves.
- **Um cliente MCP que se consiga ligar a um servidor remoto por HTTP** e enviar um cabeçalho `Authorization` personalizado. O Claude Code consegue; muitos clientes de ambiente de trabalho e de editor também.
- **Um sítio seguro para a chave**, como um gestor de palavras-passe ou o armazenamento de segredos do teu cliente. É mostrada uma só vez.

## Passo 1: cria uma chave de API com permissões

1. **Abre Definições › API e agentes** Escolhe o espaço de trabalho em que o assistente deve trabalhar, com o seletor no topo. Uma chave só atua no espaço de trabalho que a emitiu.
2. **Dá-lhe o nome do sítio onde é usada** “Claude Desktop” ou “Agente de marketing”. O nome é o que te permite saber qual revogar mais tarde.
3. **Assinala só o que precisa** As permissões estão listadas abaixo. Quatro vêm assinaladas por predefinição; **Reservar Marks** não.
4. **Cria e copia-a agora** A chave aparece uma só vez, completa. Copia-a para o teu gestor de palavras-passe antes de fechar a caixa de diálogo. Depois, as Definições mostram apenas os primeiros carateres, quando foi usada pela última vez e quantas permissões tem.

| Permissão | O que permite ao assistente fazer |
| --- | --- |
| Ler designs | Listar e abrir designs no espaço de trabalho |
| Criar e editar designs | Fazer novos designs e mudá-los |
| Pesquisar Marks | Procurar Marks no Mercado |
| Reservar Marks | Reservar um Mark para este espaço de trabalho (desligada por predefinição) |
| Gerar marcas | Fazer propostas de marca a partir de uma descrição |

As permissões que uma chave pode ter, com os nomes das Definições. Concede o menor conjunto que faz o trabalho.

## Passo 2: adiciona o endpoint ao teu cliente

A mesma página mostra um excerto pronto em **Ligar um cliente MCP**, com um botão de copiar. Os clientes que leem uma configuração JSON aceitam-no tal como está; põe a tua chave no lugar de `YOUR_KEY`.

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

A configuração de Definições › API e agentes. Mantém as chaves reais fora dos ficheiros que partilhas ou submetes.

No **Claude Code**, adiciona o servidor a partir do terminal. Guarda a chave numa variável de ambiente em vez de a escreveres no histórico da shell.

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

Adicionar a Gradiently ao Claude Code por HTTP.

Outros assistentes, incluindo o ChatGPT, podem ligar-se sempre que a sua aplicação, o plano e as definições do espaço de trabalho permitam um servidor MCP remoto personalizado com um cabeçalho de autorização. O suporte difere entre clientes e muda com o tempo, por isso consulta as páginas de ajuda do teu cliente; o guia sobre [criar designs fiéis à marca a partir do ChatGPT](https://gradiently.design/pt-pt/guide/design-with-chatgpt) explica o que procurar. Depois de ligado, pede ao assistente que liste as suas ferramentas da Gradiently para confirmar que funcionou.

## O que o teu assistente pode fazer depois de ligado

O servidor expõe as mesmas ações que tens no produto, com as mesmas permissões. Agrupadas por tarefa, ficam assim:

| Tarefa | O que o assistente pode fazer |
| --- | --- |
| Encontrar | Pesquisar Marks por nome, código ou tom; ler a receita de um Mark; listar os teus Marks; encontrar modelos para começar |
| Desenhar | Pedir ao Designer da própria Gradiently que crie ou altere um design a partir de um pedido simples; criar um conjunto de designs a partir de um só pedido; começar por um modelo; editar texto e elementos |
| Redimensionar | Guardar cópias de um design noutros tamanhos, ao lado do original, que fica inalterado |
| Marca | Ler e atualizar o perfil de uma marca; gerar propostas de marca e configurar uma com um Mark e designs iniciais |
| Marks | Forjar a receita de um Mark a partir de uma descrição e guardá-la como rascunho privado teu; pôr um Mark num design; reservar um Mark se a chave o permitir |
| Partilhar e exportar | Ativar uma ligação só de leitura para um design, ou exportá-lo em PNG ou PDF quando o Mark está reservado |

Cada design que o assistente cria fica guardado no teu espaço de trabalho e volta com uma ligação que o abre no Studio.

Os pedidos simples funcionam melhor. O assistente passa-os ao Designer, que lê o perfil da tua marca e o Mark da marca antes de compor seja o que for. Tal como no Studio, o trabalho do Designer é medido em créditos de IA.

Um cartaz vertical de evento para uma festa do solstício no telhado sobre um fundo em gradiente luminoso

No que “um cartaz para a nossa festa do solstício no telhado, 21 de junho, do pôr do sol ao nascer do sol” se pode transformar: um design guardado no Mark da tua marca, pronto a abrir e a ajustar.

- “Faz seis publicações para o lançamento de outono na nossa marca, em vertical para o Instagram.”
- “Pega no anúncio de ontem e faz dele um story e um cabeçalho para o X.”
- “Encontra três Marks escuros com um material acetinado e diz-me os códigos.”
- “Atualiza o perfil da nossa marca: soamos calmos e precisos, nunca comerciais.”

Para um passo a passo mais completo com o Claude em concreto, vê [criar designs com o Claude através da Gradiently](https://gradiently.design/pt-pt/guide/design-with-claude). Se queres que o assistente se mantenha fiel à marca, as [diretrizes de marca que o teu assistente de IA consegue seguir](https://gradiently.design/pt-pt/guide/brand-guidelines-for-ai) mostram como escrever o perfil da marca que ele lê.

## Manter a ligação segura

### Evita

- Uma chave com todas as permissões, partilhada por todas as ferramentas
- Colar uma chave numa conversa, num documento ou num repositório
- Deixar chaves de ferramentas que deixaste de usar
- Assinalar Reservar Marks para um agente que só desenha

### Faz

- Uma chave por cliente, com o nome do sítio onde corre
- Guardá-la num gestor de palavras-passe ou num cofre de segredos
- Revogar as chaves sem uso nas Definições; param de imediato
- Conceder o menor conjunto de permissões que funciona

Algumas garantias mantêm-se seja qual for o cliente. Uma chave só funciona no espaço de trabalho que a emitiu. Atua com as mesmas regras da pessoa que a criou, por isso não pode fazer nada que a função dessa pessoa não possa. Uma chave nunca transfere a titularidade de um Mark para o espaço de trabalho nem para mais ninguém. Os designs privados continuam privados: uma ligação só de leitura só existe quando a pedes. E se a pessoa que criou uma chave for removida do espaço de trabalho ou perder a função de administrador, as suas chaves também deixam de funcionar.

> **Trabalhar em equipa** As chaves pertencem a um espaço de trabalho, por isso os designs de um agente ficam onde os teus colegas os podem ver e comentar. O guia sobre [trabalhar em equipa na Gradiently](https://gradiently.design/pt-pt/guide/teams-and-workspaces) explica as funções e a partilha.

## FAQ

### Qual é o endpoint MCP da Gradiently?

O endpoint alojado é `https://gradiently.design/api/mcp`. Cada pedido precisa do cabeçalho `Authorization: Bearer` seguido de uma chave de API de Definições › API e agentes.

### Quem pode criar uma chave de API da Gradiently?

Os proprietários e administradores de um espaço de trabalho. Cada chave pertence a esse único espaço de trabalho e leva apenas as permissões assinaladas quando foi criada.

### Funciona com o ChatGPT?

Funciona com qualquer cliente MCP que se consiga ligar a um servidor HTTP remoto e enviar um cabeçalho de autorização. Se o ChatGPT o consegue depende da aplicação, do plano e das definições do espaço de trabalho que usas, por isso consulta as suas páginas de ajuda atuais.

### O que acontece se a minha chave for divulgada?

Revoga-a em Definições › API e agentes. Tudo o que a usa deixa de funcionar de imediato e podes criar uma nova chave.

### Um assistente pode reservar Marks por mim?

Só se a sua chave tiver a permissão Reservar Marks, que vem desligada por predefinição. Reservar é gratuito durante o lançamento da Gradiently.