A versão curta
- 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.
Nesta página
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 explica-a em palavras simples, e o site do próprio protocolo, modelcontextprotocol.io, tem a especificação. A referência técnica completa do servidor da Gradiently está na documentação para programadores.
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
Authorizationpersonalizado. 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 |
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.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}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.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"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 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 |
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.
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. Se queres que o assistente se mantenha fiel à marca, as diretrizes de marca que o teu assistente de IA consegue seguir 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.
Perguntas frequentes
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.
Escrito pela Gradiently
A equipa por trás da Gradiently, uma ferramenta de design construída em torno dos Marks: gradientes vivos que fazem tudo o que crias parecer teu.
Ver o nosso perfil
