Gradiently para programadores

Cria com o Gradiently

Usa a API e o servidor MCP do Gradiently para que o teu código, ou o teu assistente de IA, pesquise Marks e crie designs que abrem no Estúdio.

Atualizado a 1 de outubro de 2026

O Gradiently dá-te duas formas de entrar. O servidor MCP permite que um assistente de IA como o Claude Code use as ferramentas do Gradiently enquanto falas com ele. A API permite que o teu próprio código chame diretamente os mesmos endpoints. Ambos se autenticam com uma chave de API que pertence a um espaço de trabalho, e ambos passam pelas mesmas verificações da app: funções no espaço de trabalho, licenças de Marks, créditos de IA e limites de pedidos.

O que podes fazer

  • Pesquisar o Mercado e ler a receita completa de qualquer Mark público.
  • Gerar propostas de marca a partir de um nome e de uma descrição e depois adotar uma: um Mark em rascunho, uma marca e três designs iniciais num só passo.
  • Criar designs com o Designer do próprio Gradiently, com o motor de paginação ou a partir de um modelo, e receber um link que abre no Estúdio.
  • Editar designs guardados elemento a elemento, mudar as suas palavras, guardar cópias noutros tamanhos e pôr-lhes outro Mark.
  • Gerar um design guardado em PNG ou PDF, ou publicar um link de visualização para ele.
  • Forjar receitas de Marks a partir de uma intenção, rever a sua cor e legibilidade, e guardar versões dos teus rascunhos.

MCP ou a API

Servidor MCP

  • Para assistentes de IA que suportam servidores MCP remotos.
  • Um só endereço: https://gradiently.design/api/mcp.
  • As ferramentas encontram a tua marca, guardam designs e devolvem-te links do Estúdio.
  • Ideal quando queres pedir trabalho em palavras simples.

API

  • Para scripts, back ends e automatizações.
  • JSON sobre HTTPS em https://gradiently.design/api.
  • Escolhes a marca, envias o documento do design e tratas cada resposta.
  • Ideal quando precisas de controlo exato e repetível.

As ferramentas MCP assentam na API. Uma chamada de ferramenta faz os mesmos pedidos que o teu código faria, com a mesma chave, por isso conta para os mesmos limites e falha com as mesmas mensagens.

Início rápido

  1. 1

    Cria uma chave

    No Gradiently, abre Definições › API e agentes, escolhe o espaço de trabalho, dá à chave o nome do sítio onde a vais usar, escolhe o que pode fazer e seleciona Criar chave. Copia a chave quando aparecer: só é mostrada uma vez. Só proprietários e admins podem criar chaves.

  2. 2

    Liga o teu assistente

    No Claude Code, adiciona o Gradiently como servidor MCP remoto com a tua chave no cabeçalho Authorization (o comando está abaixo). Os outros clientes estão em MCP e assistentes de IA.

  3. 3

    Pede alguma coisa

    Experimenta “Gera três direções de marca para uma pequena padaria chamada Hearth, calma e acolhedora, e depois adota a primeira.” O assistente chama generate_brand e adopt_brand, e ficas com uma nova marca no teu espaço de trabalho, com o seu próprio Mark em rascunho e designs iniciais.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Guarda a chave numa variável de ambiente ou num gestor de segredos, nunca num ficheiro que envias para o repositório.

Para chamar a API diretamente, envia o mesmo cabeçalho em cada pedido:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Pesquisar o Mercado precisa de uma chave com a permissão Pesquisar Marks (marks:read).

Como uma chave atua

Uma chave atua como a pessoa que a criou, dentro do único espaço de trabalho para o qual foi criada. Nunca chega a outro espaço de trabalho, mesmo que o seu criador pertença a ele. Só funciona enquanto o seu criador for proprietário ou admin desse espaço de trabalho e a conta estiver ativa; se for removido, despromovido ou desativado, a chave deixa de funcionar.

  • Os designs, marcas e carregamentos que uma chave cria pertencem ao espaço de trabalho, exatamente como se o seu criador os tivesse feito na app.
  • Os Marks que uma chave reserva ficam com o seu criador, nunca com o espaço de trabalho, e qualquer licença continua a ser dele.
  • O trabalho do Designer que uma chave inicia gasta os créditos de IA do espaço de trabalho, como o Designer no Estúdio.
  • Uma chave não pode gerir chaves, alterar a conta, aceder à faturação nem dar um Mark a outra pessoa. Chaves de API e âmbitos lista o que nunca pode fazer.

O resto da documentação

Sem saída, ou falta-te algo de que precisas? Envia-nos um pedido e uma pessoa responde-te.

Precisas de ajuda?

Envia-nos um pedido com o tema API e MCP, e uma pessoa responde-te.

Enviar um pedido