A versão curta
- O Gradiently disponibiliza um servidor MCP alojado para o Claude em https://gradiently.design/api/mcp.
- Na app Claude, o Gradiently é adicionado como conector personalizado com início de sessão por OAuth; no Claude Code, é adicionado com uma chave de API limitada de Definições › API e agentes.
- Uma chave de API nova começa com as permissões de que toda a ferramenta de design precisa, e Reservar Marks fica desligado a menos que o escolhas.
- Quando o Claude compõe um design com as ferramentas do Gradiently, não gasta créditos de IA do Gradiently, e todos os designs guardados abrem no Estúdio.
- Uma chave só funciona no espaço de trabalho que a emitiu, age como o proprietário ou administrador que a criou e pode ser revogada de imediato.
Nesta página
Para configurar o conector do Gradiently para o Claude, aponta o Claude para o servidor MCP alojado do Gradiently em https://gradiently.design/api/mcp. Na app Claude, adiciona-o como conector personalizado e inicia sessão no Gradiently. No Claude Code, adiciona-o a partir do terminal com uma chave de API limitada. De qualquer forma, o Claude pode depois pesquisar Marks, ler o teu kit de marca e criar designs que ficam guardados no teu espaço de trabalho e abrem no Estúdio, com todas as palavras ainda editáveis.
O MCP, o Model Context Protocol, é o padrão aberto que deixa o Claude usar ferramentas reais. O que é o MCP explica-o de forma simples, e o próprio protocolo está documentado em modelcontextprotocol.io.
Que forma de ligar o Claude escolher
Como se liga
Início de sessão
Como se liga
Início de sessão
Como se liga
Início de sessão
Qualquer que seja o caminho, tens de ser proprietário ou administrador do espaço de trabalho do Gradiently. Editores e leitores não podem ligar assistentes nem criar chaves.
Ligar a app Claude com um conector personalizado
- 1
Abre as definições de conectores do Claude
Adiciona um conector personalizado. Que planos do Claude permitem conectores personalizados é decisão da Anthropic, por isso consulta as páginas de ajuda do Claude se não vires a opção. Conectores do Claude explica a funcionalidade.
- 2
Cola o endereço do servidor
Chama-lhe Gradiently e usa
https://gradiently.design/api/mcp. Escolhe o início de sessão por OAuth. - 3
Inicia sessão e escolhe um espaço de trabalho
Na janela do Gradiently, escolhe o espaço de trabalho em que o Claude deve trabalhar e lê as permissões em Permitir que este assistente possa.
- 4
Permite e verifica
Escolhe Permitir ligação. De volta ao Claude, pede-lhe que liste as suas ferramentas do Gradiently para confirmar.
O acesso renova-se automaticamente até 30 dias, depois dos quais voltas a ligar. Um conector personalizado é teu para usar de imediato; uma entrada no diretório público do Claude é outra coisa e precisa de revisão da Anthropic.
Ligar o Claude Code com uma chave de API limitada
O Claude Code usa uma chave em vez de início de sessão. Cria uma no Gradiently em Definições › API e agentes: escolhe o espaço de trabalho, dá-lhe o nome do sítio onde vive (Claude Code, portátil), assinala o que pode fazer e seleciona Criar chave. A chave é mostrada uma só vez, por isso copia-a logo para o teu gestor de palavras-passe.
export GRADIENTLY_API_KEY="gr_live_…"
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Outros clientes que leem um ficheiro JSON costumam aceitar o mesmo servidor e cabeçalho. As Definições mostram um excerto pronto em Ligar um cliente MCP.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Escolher as permissões da chave
Cada permissão é um âmbito. Uma chave nova começa com cinco que cobrem todas as ferramentas de design, por isso a maioria das pessoas não muda nada. Acrescenta as outras só quando o Claude realmente precisar delas.
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
Ligada por defeito
O que permite
O que o Claude pode fazer depois de ligado
O Claude trabalha através das mesmas ações que tens no produto. Pode pesquisar o Mercado por nome, palavras de cor ou código; ler o perfil, a voz e os tipos de letra da tua marca; desenhar um design original, olhar para a imagem resultante e refiná-lo; preencher um dos modelos do Gradiently; alterar as palavras de um design guardado; fazer cópias redimensionadas; e desenhar um design em PNG ou PDF. Quando o Claude compõe o design por si, o Gradiently não cobra créditos de IA. Se lhe pedires que passe o trabalho ao Designer do próprio Gradiently, isso usa créditos como no Estúdio.
O Claude Code torna fácil um tipo de trabalho em particular. Imagina que manténs um blogue e queres uma imagem de ligação para cada artigo. Pede: “Para cada artigo em /content, faz uma pré-visualização de ligação de 1200×630 na nossa marca com o título do artigo e desenha depois cada uma em PNG para /public/og.” O Claude desenha cada imagem no Gradiently, verifica-a e escreve os ficheiros onde o teu site os espera. Tamanho da imagem Open Graph explica porquê 1200×630.
Uma pré-visualização de ligação de 1200×630 desenhada através do servidor MCP do Gradiently e gerada diretamente na pasta de um site.
Pedidos que funcionam bem com o Claude
- “Lê o perfil da nossa marca e faz depois uma publicação de LinkedIn e outra no X a anunciar o nosso novo escritório em Bristol.”
- “Encontra três Marks escuros com material de seda próximos de verde-azulado profundo e dá-me os seus códigos.”
- “Pega no anúncio de ontem e faz dele um story e uma miniatura de YouTube.”
- “Muda a data do cartaz do evento para 14 de novembro e desenha-o em PDF.”
Quanto melhor o teu kit de marca, menos precisas de dizer em cada pedido; voz da marca para a IA mostra o que preencher. Para mais ideias dirigidas a publicações sociais, vê Claude para redes sociais e, para o quadro geral, design com o Claude.
Manter a ligação segura
Uma chave pode
- Trabalhar no único espaço de trabalho que a emitiu
- Fazer o que o papel do seu criador e os seus âmbitos permitem
- Criar designs que pertencem ao espaço de trabalho
- Mostrar quando foi usada pela última vez, nas Definições
Uma chave nunca pode
- Chegar a outro espaço de trabalho, mesmo um a que pertenças
- Pagar nada nem aceder à faturação
- Transferir, listar ou libertar um Mark
- Criar ou gerir outras chaves
Se uma chave vazar ou deixares de a usar, seleciona Revogar ao lado dela em Definições › API e agentes e ela deixa de funcionar de imediato. As chaves também deixam de funcionar quando o seu criador sai do espaço de trabalho ou perde o papel de administrador. Usas também o ChatGPT? Gradiently no ChatGPT tem a sua própria configuração, e a referência completa das ferramentas está nos documentos para programadores.
Perguntas frequentes
Qual é o endereço do servidor MCP do Gradiently para o Claude?
https://gradiently.design/api/mcp. Na app Claude, usa-o como conector personalizado com OAuth; no Claude Code, adiciona-o com a tua chave de API no cabeçalho Authorization.
Preciso de uma chave de API para usar o Gradiently no Claude?
Não na app Claude, que inicia sessão com OAuth. O Claude Code e a maioria dos outros clientes MCP precisam de uma chave limitada de Definições › API e agentes.
O Claude gasta os meus créditos de IA do Gradiently?
Não quando compõe ele próprio os designs com as ferramentas do Gradiently. Passar um trabalho ao Designer do próprio Gradiently usa créditos.
O Claude pode reservar um Mark por mim?
Só com uma chave que tenha a permissão Reservar Marks, que está desligada por defeito. Qualquer reserva que exija pagamento tem de ser concluída no Gradiently.
Porque diz o Claude que não consegue autenticar?
A chave foi mal escrita ou revogada, ou o seu criador já não é proprietário nem administrador do espaço de trabalho. Cria uma chave nova e atualiza o teu cliente.
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