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://; Claude: https:// 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.
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
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
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.
# 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"Para chamar a API diretamente, envia o mesmo cabeçalho em cada pedido:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"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.