# Gradiently MCP: conecte o Claude, o ChatGPT ou qualquer cliente MCP

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

O Gradiently fala MCP, então um assistente de IA pode buscar Marks, ler sua marca e criar designs que abrem no seu Studio. Aqui está a configuração em linguagem simples e como mantê-la segura.

## The short version

- O Gradiently mantém um servidor MCP hospedado em https://gradiently.design/api/mcp ao qual se conecta qualquer cliente MCP capaz de enviar um cabeçalho Authorization.
- Você se conecta com uma chave de API criada por um proprietário ou administrador do workspace em Configurações, em API e agentes, enviada como token Bearer.
- Cada chave pertence a um só workspace e carrega apenas as permissões marcadas quando foi criada, como ler designs ou buscar Marks.
- Depois de conectado, um assistente pode buscar Marks, ler o perfil da sua marca, criar, editar e redimensionar designs, e todo design abre no Studio.
- Uma chave é mostrada uma única vez, pode ser revogada a qualquer momento e nunca transfere a propriedade de um Mark para outra pessoa.

Para usar o servidor **Gradiently MCP**, crie uma chave de API em **Configurações › API e agentes** e depois adicione o endpoint hospedado `https://gradiently.design/api/mcp` ao seu cliente MCP com o cabeçalho `Authorization: Bearer <sua chave>`. Essa é a conexão inteira. A partir daí, um assistente como o Claude pode buscar Marks, ler sua marca, criar designs e alterá-los, e cada design que ele cria abre no seu Studio como qualquer outro.

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

## O que você precisa antes de começar

- **Uma conta do Gradiently** e um workspace do qual você seja **proprietário ou administrador**. Só proprietários e administradores podem criar ou revogar chaves.
- **Um cliente MCP que consiga se conectar a um servidor remoto por HTTP** e enviar um cabeçalho `Authorization` personalizado. O Claude Code consegue; muitos clientes de desktop e de editor também.
- **Um lugar seguro para a chave**, como um gerenciador de senhas ou o armazenamento de segredos do seu cliente. Ela é mostrada uma única vez.

## Passo 1: crie uma chave de API com escopo

1. **Abra Configurações › API e agentes** Escolha, no seletor no topo, o workspace em que o assistente deve trabalhar. Uma chave só age no workspace que a emitiu.
2. **Dê um nome conforme onde ela será usada** “Claude Desktop” ou “Agente de marketing”. O nome é como você vai saber qual revogar depois.
3. **Marque só o que ela precisa** As permissões estão listadas abaixo. Quatro vêm marcadas por padrão; **Reservar Marks** não.
4. **Crie e copie agora** A chave aparece uma única vez, completa. Copie-a para o seu gerenciador de senhas antes de fechar a janela. Depois, as Configurações mostram apenas os primeiros caracteres, quando foi usada pela última vez e quantas permissões ela tem.

| Permissão | O que permite ao assistente fazer |
| --- | --- |
| Ler designs | Listar e abrir designs do workspace |
| Criar e editar designs | Criar novos designs e alterá-los |
| Buscar Marks | Procurar Marks no Mercado |
| Reservar Marks | Reservar um Mark para este workspace (desativada por padrão) |
| Gerar marcas | Criar candidatas de marca a partir de uma descrição |

As permissões que uma chave pode ter, com os nomes que as Configurações usam. Conceda o menor conjunto que resolve o trabalho.

## Passo 2: adicione o endpoint ao seu cliente

A mesma página mostra um trecho pronto em **Conectar um cliente MCP**, com um botão de copiar. Clientes que leem uma configuração em JSON o aceitam como está; coloque sua chave no lugar de `YOUR_KEY`.

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

A configuração de Configurações › API e agentes. Mantenha chaves reais fora de arquivos que você compartilha ou versiona.

No **Claude Code**, adicione o servidor pelo terminal. Guarde a chave em uma variável de ambiente em vez de digitá-la no histórico do shell.

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

Adicionando o Gradiently ao Claude Code por HTTP.

Outros assistentes, incluindo o ChatGPT, podem se conectar onde as configurações do app, do plano e do workspace permitirem um servidor MCP remoto personalizado com cabeçalho de autorização. O suporte varia entre clientes e muda com o tempo, então confira as páginas de ajuda do seu cliente; [criar designs alinhados à marca pelo ChatGPT](https://gradiently.design/pt-br/guide/design-with-chatgpt) mostra o que observar. Depois de conectar, peça ao assistente que liste as ferramentas do Gradiently para confirmar que funcionou.

## O que seu assistente pode fazer depois de conectado

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

| Tarefa | O que o assistente pode fazer |
| --- | --- |
| Encontrar | Buscar Marks por nome, código ou tom; ler a receita de um Mark; listar seus Marks; achar templates para começar |
| Projetar | Pedir ao próprio Designer do Gradiently que crie ou altere um design a partir de um pedido simples; criar um conjunto de designs a partir de um só briefing; começar por um template; editar textos e elementos |
| Redimensionar | Salvar cópias de um design em outros tamanhos, ao lado do original, que continua inalterado |
| Marca | Ler e atualizar o perfil de uma marca; gerar candidatas de marca e configurar uma com um Mark e designs iniciais |
| Marks | Criar na Forge a receita de um Mark a partir de uma descrição e salvá-la como seu rascunho privado; colocar um Mark em um design; reservar um Mark se a chave permitir |
| Compartilhar e exportar | Ativar um link somente de visualização de um design ou renderizá-lo como PNG ou PDF quando o Mark estiver reservado |

Todo design que o assistente cria é salvo no seu workspace e volta com um link que o abre no Studio.

Pedidos simples funcionam melhor. O assistente os passa ao Designer, que lê o perfil da sua marca e o Mark da marca antes de compor qualquer coisa. Como no Studio, o trabalho do Designer é medido em créditos de IA.

Um cartaz vertical de evento para uma festa do solstício em um terraço, sobre um fundo em gradiente brilhante

O que “um cartaz para a nossa festa do solstício no terraço, 21 de junho, do pôr do sol ao nascer” pode voltar como: um design salvo no Mark da sua marca, pronto para abrir e ajustar.

- “Faça seis posts para o nosso lançamento de outono na nossa marca, em vertical para o Instagram.”
- “Pegue o anúncio de ontem e faça um story e um cabeçalho do X a partir dele.”
- “Encontre três Marks escuros com material de seda e me diga os códigos deles.”
- “Atualize o perfil da nossa marca: soamos calmos e precisos, nunca insistentes.”

Para um passo a passo mais completo especificamente com o Claude, veja [criar designs com o Claude pelo Gradiently](https://gradiently.design/pt-br/guide/design-with-claude). Se você quer que o assistente fique na marca, [diretrizes de marca que seu assistente de IA consegue seguir](https://gradiently.design/pt-br/guide/brand-guidelines-for-ai) mostra como escrever o perfil da marca que ele lê.

## Mantendo a conexão segura

### Evite

- Uma chave com todas as permissões, compartilhada por todas as ferramentas
- Colar uma chave em um chat, um documento ou um repositório
- Deixar chaves de ferramentas que você parou de usar
- Marcar Reservar Marks para um agente que só cria designs

### Faça

- Uma chave por cliente, com o nome de onde ela roda
- Guardá-la em um gerenciador de senhas ou cofre de segredos
- Revogar chaves sem uso nas Configurações; elas param na hora
- Conceder o menor conjunto de permissões que funciona

Algumas garantias valem qualquer que seja o cliente. Uma chave só funciona no workspace que a emitiu. Ela age pelas mesmas regras da pessoa que a criou, então não pode fazer nada que o papel dela não possa. Uma chave nunca transfere a propriedade de um Mark para o workspace nem para ninguém. Designs privados continuam privados: um link somente de visualização só existe quando você pede um. E se a pessoa que criou uma chave for removida do workspace ou perder o papel de administradora, as chaves dela também deixam de funcionar.

> **Trabalhando em equipe** As chaves pertencem a um workspace, então os designs de um agente chegam onde seus colegas podem vê-los e comentar. [Trabalhar em equipe no Gradiently](https://gradiently.design/pt-br/guide/teams-and-workspaces) trata de papéis e compartilhamento.

## FAQ

### Qual é o endpoint MCP do Gradiently?

O endpoint hospedado é `https://gradiently.design/api/mcp`. Toda requisição precisa do cabeçalho `Authorization: Bearer` seguido de uma chave de API de Configurações › API e agentes.

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

Proprietários e administradores de um workspace. Cada chave pertence a esse único workspace e carrega apenas as permissões marcadas quando foi criada.

### Funciona com o ChatGPT?

Funciona com qualquer cliente MCP que consiga se conectar a um servidor HTTP remoto e enviar um cabeçalho de autorização. Se o ChatGPT consegue depende do app, do plano e das configurações do workspace que você usa, então confira as páginas de ajuda atuais dele.

### O que acontece se minha chave vazar?

Revogue-a em Configurações › API e agentes. Tudo o que a usa para de funcionar na hora, e você pode criar uma chave nova.

### Um assistente pode reservar Marks para mim?

Só se a chave dele tiver a permissão Reservar Marks, que vem desativada por padrão. Reservar é grátis enquanto o Gradiently está em lançamento.