O Gradiently tem uma API HTTP e um servidor MCP hospedado. Conecte 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.
Adicione um conector personalizado com ChatGPT: https://; Claude: https:// e escolha o login OAuth. Entre no Gradiently, escolha um espaço e revise as permissões. Somente os proprietários e administradores podem conectar um assistente. As conexões expiram após uma hora e se renovam automaticamente por até 30 dias. Revogue uma conexão em Configurações › API e agentes para parar o acesso e a renovação imediatamente.
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
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
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.
# 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, envie o mesmo cabeçalho em cada requisição:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"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.