MercadoExplorarExperimentar
Preços
Iniciar sessãoComeçar

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 4 de outubro de 2026

Documentação para programadores

  • Visão geral
  • MCP e assistentes de IA
  • Referência da API
  • Chaves de API e âmbitos

Nesta página

O que podes fazerMCP ou a APIInício rápidoComo uma chave atuaO resto da documentação

O Gradiently tem uma API HTTP e um servidor MCP alojado. Liga um assistente com OAuth ou uma chave API limitada a um espaço. O servidor aceita tokens de acesso OAuth e chaves API do espaço. Ambos usam as mesmas permissões, licenças, créditos e limites.

Adiciona um conector personalizado com ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp e escolhe o início de sessão OAuth. Inicia sessão no Gradiently, escolhe um espaço e revê as permissões. Só os proprietários e administradores podem ligar um assistente. As ligações expiram após uma hora e renovam-se automaticamente durante um máximo de 30 dias. Revoga uma ligação em Definições › API e agentes para parar imediatamente o acesso e a renovação.

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.

Os âmbitos decidem o que funciona

Cada chave tem âmbitos, e cada ferramenta e endpoint precisa de âmbitos específicos. Uma nova chave começa com os cinco de que a maioria das ferramentas precisa, e podes adicionar ou remover qualquer um dos oito. Chaves de API e âmbitos lista-os todos, e cada ferramenta em MCP e assistentes de IA indica os âmbitos de que precisa.

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.

bash
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY

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

  • MCP e assistentes de IA: como ligar o Claude Code e outros clientes, cada ferramenta com as suas entradas e âmbitos, e exemplos de pedidos.
  • Referência da API: o URL base, a autenticação, cada endpoint que uma chave pode chamar, erros, limites de pedidos e paginação.
  • Chaves de API e âmbitos: criar, rodar e revogar chaves, o que cada âmbito permite e como manter as chaves seguras.
  • Novo no MCP? O que é o MCP explica-o em palavras simples, e modelcontextprotocol.io tem a especificaçã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

Encontra o visual que é só teu.

Cada Mark é um fundo vivo com um só dono. Experimenta um Mark ainda disponível e reserva o teu quando te parecer certo.

Começar a criarVer a oferta de lançamento

Marks por reservar

50de 1000

950 reservados até agoraEncontra o teu

Verificar um certificado

Escreve um número de certificado ou o código de um Mark para veres quem é o dono.

Funciona com o ChatGPT e o Claude

Pede um design à tua IA. Ela cria-o no teu Mark, pronto a editar.

ChatGPTClaude
Como ligar

Produto

  • Mercado
  • Explorar
  • Preços
  • Pacotes de lançamento
  • Certificados

Aprender

  • Guia Prático
  • Centro de ajuda
  • Novidades

Programadores

  • Visão geral
  • ChatGPT e Claude
  • Referência da API
  • Chaves de API

Empresa

  • Sobre nós
  • Contactos
  • Iniciar sessão

Legal

  • Termos
  • Privacidade
  • Reembolsos
  • Proteção de Marks
  • Cookies
  • Todas as políticas
Passa pelas letras. Cada uma veste um Mark real.Toca numa letra para veres o seu Mark.Um nome. Dez Marks lá dentro.
© 2026 Gradiently