MercadoExplorarExperimentar
Preços
EntrarComeçar
Desenvolvedores

Chaves de API e escopos

Uma chave de API permite que uma ferramenta ou um assistente de IA trabalhe em um workspace como a pessoa que a criou, limitada aos escopos que você escolher. Trate-a como uma senha.

Atualizado em 4 de outubro de 2026

Documentação para desenvolvedores

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

Nesta página

Criar uma chaveEscoposTrocar uma chaveRevogar uma chaveO que uma chave nunca pode fazerMantenha as chaves seguras

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. Uma chave pertence a um workspace, age como o proprietário ou admin que a criou e só alcança os endpoints que os escopos dela permitem. As chaves têm o formato gr_live_ seguido de 43 letras, dígitos, hifens e sublinhados.

Adicione um conector personalizado com ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp 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.

Criar uma chave

  1. 1

    Abra API e agentes

    No Gradiently, vá em Configurações › API e agentes e escolha o workspace da chave. Só proprietários e admins desse workspace podem criar chaves.

  2. 2

    Dê um nome

    Em Criar uma chave, preencha o Nome com o lugar onde você vai usá-la, como Claude Code ou Exportação noturna, para saber depois qual revogar.

  3. 3

    Escolha o que ela pode fazer

    Em O que ela pode fazer, selecione as permissões de que ela precisa, pelo menos uma. A próxima seção explica cada uma.

  4. 4

    Copie uma única vez

    Selecione Criar chave. A chave aparece em Copie sua chave agora, e esta é a única vez que ela é exibida. Copie para um gerenciador de senhas ou para o seu cofre de segredos e depois selecione Já salvei.

Quem criou a chave recebe um e-mail quando ela é criada e quando é revogada, com o nome, o início da chave e as permissões dela. A lista em Configurações mostra, para cada chave ativa, o nome, o início da chave, quando foi usada pela última vez e quantas permissões ela tem.

Escopos

Um escopo é uma permissão. Uma requisição precisa de todos os escopos que o endpoint dela lista, e cada ferramenta MCP precisa dos escopos de todas as requisições que faz. Conceda só o que a tarefa exige.

designs:read

Em Configurações

Ler designs

O que permite

Ler marcas, designs, miniaturas e uploads, renderizar designs e acompanhar conjuntos do Designer.
designs:write

Em Configurações

Criar e editar designs

O que permite

Criar, alterar, duplicar, compartilhar e excluir designs, enviar e excluir imagens e usar o Designer.
marks:read

Em Configurações

Buscar Marks

O que permite

Buscar no Mercado, ler Marks e seus rascunhos, montar e revisar receitas e ler as versões dos Marks.
marks:claim

Em Configurações

Reservar Marks

O que permite

Reservar um Mark disponível, ou um que outro dono colocou à venda, para quem criou a chave.
brand:generate

Em Configurações

Gerar marcas

O que permite

Gerar e adotar marcas, salvar e alterar Marks em rascunho e gerenciar versões de Marks.
workspaces:read

Em Configurações

Ler o espaço de trabalho

O que permite

Ler o workspace, os membros e o registro de auditoria. Com designs:read, ler /api/me.
personalities:write

Em Configurações

Editar marcas

O que permite

Criar, renomear e excluir marcas, e alterar o Mark, o perfil e o estilo de uma marca.
members:write

Em Configurações

Convidar membros

O que permite

Enviar convites para entrar no workspace.
EscopoEm ConfiguraçõesO que permite
designs:readLer designsLer marcas, designs, miniaturas e uploads, renderizar designs e acompanhar conjuntos do Designer.
designs:writeCriar e editar designsCriar, alterar, duplicar, compartilhar e excluir designs, enviar e excluir imagens e usar o Designer.
marks:readBuscar MarksBuscar no Mercado, ler Marks e seus rascunhos, montar e revisar receitas e ler as versões dos Marks.
marks:claimReservar MarksReservar um Mark disponível, ou um que outro dono colocou à venda, para quem criou a chave.
brand:generateGerar marcasGerar e adotar marcas, salvar e alterar Marks em rascunho e gerenciar versões de Marks.
workspaces:readLer o espaço de trabalhoLer o workspace, os membros e o registro de auditoria. Com designs:read, ler /api/me.
personalities:writeEditar marcasCriar, renomear e excluir marcas, e alterar o Mark, o perfil e o estilo de uma marca.
members:writeConvidar membrosEnviar convites para entrar no workspace.

Comece pelo padrão

Uma chave nova começa com designs:read, designs:write, marks:read, brand:generate e workspaces:read, o que cobre criar designs com um assistente de IA. Adicione marks:claim, personalities:write ou members:write só se a chave precisar reservar Marks, alterar marcas ou convidar pessoas.

Chaves novas começam com Ler designs, Criar e editar designs, Buscar Marks, Gerar marcas e Ler o espaço de trabalho selecionados. Reservar Marks fica desativado até você escolher, porque uma reserva torna você, quem criou a chave, o titular de um Mark.

Trocar uma chave

As chaves não expiram, e o nome e os escopos de uma chave não podem ser alterados depois que ela é criada. Para trocar uma chave, ou mudar o que ela pode fazer, substitua-a:

  1. 1

    Crie a nova chave

    Crie uma chave com os escopos que você quer, com um nome que a diferencie da antiga.

  2. 2

    Mude suas ferramentas

    Coloque a nova chave em todos os lugares que usavam a antiga: seu cliente MCP, seu cofre de segredos ou as configurações de deploy.

  3. 3

    Revogue a chave antiga

    Quando a data de usada em da chave antiga parar de mudar na lista, revogue-a.

Revogar uma chave

Em Configurações › API e agentes, selecione Revogar ao lado da chave e confirme com Revogar chave. Tudo o que a usa para de funcionar imediatamente, e isso não pode ser desfeito. Proprietários e admins do workspace podem revogar qualquer chave dele.

Uma chave também para de funcionar sozinha quando quem a criou sai do workspace, perde a função de admin ou tem a conta desativada. As chaves que uma pessoa criou são revogadas quando ela é removida do workspace ou rebaixada.

O que uma chave nunca pode fazer

Algumas coisas sempre exigem uma pessoa com login feito no Gradiently, sejam quais forem os escopos da chave:

  • Criar, listar ou revogar chaves.
  • Alterar a conta: perfil, e-mail, senha, sessões de login ou a exclusão da conta.
  • Acessar a cobrança: planos, checkout, pagamentos, recargas de créditos de IA, Saldo e repasses. Uma reserva ou compra que exige pagamento para e pede o checkout no Gradiently.
  • Abrir mão de um Mark: transferi-lo para outra pessoa, liberá-lo, colocá-lo à venda, renová-lo ou publicá-lo.
  • Passar a titularidade ou a licença de um Mark para o workspace. Os Marks que uma chave reserva ficam com quem a criou, e qualquer licença continua sendo dessa pessoa.
  • Mudar quem está no workspace ou as funções das pessoas, ou renomear, transferir ou excluir o workspace. Com members:write, ela só pode enviar convites.
  • Alcançar qualquer workspace além do seu, mesmo um do qual quem a criou faça parte.
  • Usar a administração do Gradiently.

Mantenha as chaves seguras

Não faça

  • Fazer commit de uma chave em um repositório ou colá-la em um arquivo de configuração compartilhado.
  • Colocar uma chave em uma página web, um app de celular ou qualquer coisa que rode no dispositivo de outra pessoa.
  • Compartilhar uma chave entre pessoas ou ferramentas.
  • Enviar uma chave por e-mail ou chat.
  • Deixar Reservar Marks ativado em uma chave que não faz reservas.

Faça

  • Crie uma chave para cada ferramenta ou assistente, com o nome dele.
  • Conceda o menor número de escopos que resolve a tarefa.
  • Guarde as chaves em um gerenciador de senhas, um cofre de segredos ou uma variável de ambiente.
  • Revogue uma chave assim que ela puder ter vazado e crie outra.
  • Confira de vez em quando as datas de último uso e revogue as chaves que ninguém usa.

O Gradiently guarda só um hash de cada chave e o início dela para exibição, então uma chave perdida não pode ser mostrada de novo: revogue-a e crie outra. Se você acha que uma chave foi mal usada, revogue-a e avise a gente.

Precisa de ajuda?

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

Enviar uma solicitação

Encontre o visual que é só seu.

Cada Mark é um fundo vivo com um único dono. Experimente um Mark ainda disponível e reserve o seu quando sentir que é ele.

Começar a criarVer a oferta de lançamento

Marks livres para reservar

50de 1.000

950 reservados até agoraEncontre o seu

Verificar um certificado

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

Funciona com ChatGPT e Claude

Peça um design à sua IA. Ela cria no seu Mark, pronto para editar.

ChatGPTClaude
Como conectar

Produto

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

Aprender

  • Guia prático
  • Central de ajuda
  • Novidades

Desenvolvedores

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

Empresa

  • Sobre
  • Fale conosco
  • Entrar

Jurídico

  • Termos
  • Privacidade
  • Reembolsos
  • Proteção do Mark
  • Cookies
  • Todas as políticas
Passe pelas letras. Cada uma veste um Mark de verdade.Toque em uma letra para ver o Mark dela.Um nome. Dez Marks dentro dele.
© 2026 Gradiently