Resumindo
- 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.
Nesta página
Para usar o servidor Gradiently MCP, crie uma chave de API em Configurações › API e agentes e depois adicione o endpoint hospedado https:// 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 explica em palavras simples, e o site do próprio protocolo, modelcontextprotocol.io, traz a especificação. A referência técnica completa do servidor do Gradiently está na documentação para desenvolvedores.
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
Authorizationpersonalizado. 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.
O que permite ao assistente fazer
O que permite ao assistente fazer
O que permite ao assistente fazer
O que permite ao assistente fazer
O que permite ao assistente fazer
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.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}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.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"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 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:
O que o assistente pode fazer
O que o assistente pode fazer
O que o assistente pode fazer
O que o assistente pode fazer
O que o assistente pode fazer
Pedidos simples funcionam melhor. O assistente pode montar e editar designs sozinho com as ferramentas do Gradiently, sem gastar créditos de IA do Gradiently. Se você pedir o próprio Designer do Gradiently, ele lê o perfil da sua marca e o Mark da marca antes de compor qualquer coisa e, como no Studio, o trabalho dele é medido em créditos de IA.
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. Se você quer que o assistente fique na marca, diretrizes de marca que seu assistente de IA consegue seguir 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.
Perguntas frequentes
Qual é o endpoint MCP do Gradiently?
O endpoint hospedado é https://. 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 um Mark é um pagamento único, então marque essa permissão só para um assistente que você queira que reserve por você.
Escrito pelo Gradiently
A equipe por trás do Gradiently, uma ferramenta de design criada em torno dos Marks: gradientes vivos que fazem tudo o que você cria ter a sua cara.
Ver nosso perfil