Gradiently para desenvolvedores

Crie com o Gradiently

Use a API e o servidor MCP do Gradiently para que seu código, ou seu assistente de IA, busque Marks e crie designs que abrem no Studio.

Atualizado em 1 de outubro de 2026

O Gradiently oferece duas formas de acesso. O servidor MCP permite que um assistente de IA como o Claude Code use as ferramentas do Gradiently enquanto você conversa com ele. A API permite que seu próprio código chame os mesmos endpoints diretamente. Os dois se autenticam com uma chave de API que pertence a um workspace, e os dois passam pelas mesmas verificações do app: funções no workspace, licenças de Marks, créditos de IA e limites de requisições.

O que você pode fazer

  • Buscar no Mercado e ler a receita completa de qualquer Mark público.
  • Gerar propostas de marca a partir de um nome e uma descrição e depois adotar uma: um Mark em rascunho, uma marca e três designs iniciais em uma única etapa.
  • Criar designs com o próprio Designer do Gradiently, com o motor de layout ou a partir de um modelo, e receber um link que abre no Studio.
  • Editar designs salvos elemento por elemento, mudar o texto, salvar cópias em outros tamanhos e colocar outro Mark neles.
  • Renderizar um design salvo em PNG ou PDF, ou publicar um link de visualização para ele.
  • Forjar receitas de Mark a partir de uma intenção, revisar a cor e a legibilidade delas e guardar versões dos seus rascunhos.

MCP ou API

Servidor MCP

  • Para assistentes de IA compatíveis com servidores MCP remotos.
  • Um único endereço: https://gradiently.design/api/mcp.
  • As ferramentas encontram sua marca, salvam designs e devolvem links do Studio para você.
  • Ideal quando você quer pedir o trabalho com palavras simples.

API

  • Para scripts, back-ends e automações.
  • JSON sobre HTTPS em https://gradiently.design/api.
  • Você escolhe a marca, envia o documento do design e trata cada resposta.
  • Ideal quando você precisa de controle exato e repetível.

As ferramentas MCP são construídas sobre a API. Uma chamada de ferramenta faz as mesmas requisições que o seu código faria, com a mesma chave, então conta para os mesmos limites e falha com as mesmas mensagens.

Início rápido

  1. 1

    Crie uma chave

    No Gradiently, abra Configurações › API e agentes, escolha o workspace, dê à chave o nome do lugar onde você vai usá-la, escolha o que ela pode fazer e selecione Criar chave. Copie a chave quando ela aparecer: ela é exibida uma única vez. Só proprietários e admins podem criar chaves.

  2. 2

    Conecte seu assistente

    No Claude Code, adicione o Gradiently como servidor MCP remoto com sua chave no cabeçalho Authorization (o comando está abaixo). Outros clientes estão em MCP e assistentes de IA.

  3. 3

    Peça alguma coisa

    Experimente “Gere três direções de marca para uma pequena padaria chamada Hearth, calma e acolhedora, e depois adote a primeira.” O assistente chama generate_brand e adopt_brand, e você recebe uma nova marca com o próprio Mark em rascunho e designs iniciais no seu workspace.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Guarde a chave em uma variável de ambiente ou em um gerenciador de segredos, nunca em um arquivo que você faz commit.

Para chamar a API, envie o mesmo cabeçalho em cada requisição:

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

Como uma chave age

Uma chave age como a pessoa que a criou, dentro do único workspace para o qual foi criada. Ela nunca alcança outro workspace, mesmo um do qual essa pessoa faça parte. Ela só funciona enquanto quem a criou continuar sendo proprietário ou admin desse workspace e a conta dessa pessoa estiver ativa; se ela for removida, rebaixada ou desativada, a chave para de funcionar.

  • Designs, marcas e uploads que uma chave cria pertencem ao workspace, exatamente como se quem a criou os tivesse feito no app.
  • Os Marks que uma chave reserva ficam com quem a criou, nunca com o workspace, e qualquer licença continua sendo dessa pessoa.
  • O trabalho do Designer iniciado por uma chave gasta os créditos de IA do workspace, como o Designer no Studio.
  • Uma chave não pode gerenciar chaves, alterar a conta, acessar a cobrança nem transferir um Mark para outra pessoa. Chaves de API e escopos lista o que ela nunca pode fazer.

O resto da documentação

  • MCP e assistentes de IA: como conectar o Claude Code e outros clientes, todas as ferramentas com suas entradas e escopos, e exemplos de pedidos.
  • Referência da API: a URL base, a autenticação, todos os endpoints que uma chave pode chamar, erros, limites de requisições e paginação.
  • Chaves de API e escopos: como criar, trocar e revogar chaves, o que cada escopo permite e como manter as chaves seguras.
  • Novo no MCP? O que é MCP explica com palavras simples, e modelcontextprotocol.io tem a especificação.

Travou, ou falta algo de que você precisa? Envie uma solicitação e uma pessoa vai responder.

Precisa de ajuda?

Envie uma solicitação com o tópico API e MCP, e uma pessoa vai responder.

Enviar uma solicitação