Gradiently MCP: conecte o Claude, o ChatGPT ou qualquer cliente MCP

Para usar o servidor Gradiently MCP, crie uma chave de API em Configurações › API e agentes e depois adicione o endpoint hospedado https://gradiently.design/api/mcp ao seu cliente MCP com o cabeçalho Authorization: Bearer <sua chave>. Essa é a conexão inteira. A partir daí, um assistente como o Claude pode buscar Marks, ler sua marca, criar designs e alterá-los, e cada design que ele cria abre no seu Studio como qualquer outro.

MCP, o Model Context Protocol, é um padrão aberto que permite que assistentes de IA usem ferramentas reais. Se a ideia é nova, o que é MCP explica em palavras simples, e o site do próprio protocolo, modelcontextprotocol.io, traz a especificação. A referência técnica completa do servidor do Gradiently está na documentação para desenvolvedores.

O que você precisa antes de começar

• Uma conta do Gradiently e um workspace do qual você seja proprietário ou administrador. Só proprietários e administradores podem criar ou revogar chaves.
• Um cliente MCP que consiga se conectar a um servidor remoto por HTTP e enviar um cabeçalho Authorization personalizado. O Claude Code consegue; muitos clientes de desktop e de editor também.
• Um lugar seguro para a chave, como um gerenciador de senhas ou o armazenamento de segredos do seu cliente. Ela é mostrada uma única vez.

Passo 1: crie uma chave de API com escopo

1. 1

   Abra Configurações › API e agentes

   Escolha, no seletor no topo, o workspace em que o assistente deve trabalhar. Uma chave só age no workspace que a emitiu.

2. 2

   Dê um nome conforme onde ela será usada

   “Claude Desktop” ou “Agente de marketing”. O nome é como você vai saber qual revogar depois.

3. 3

   Marque só o que ela precisa

   As permissões estão listadas abaixo. Quatro vêm marcadas por padrão; Reservar Marks não.

4. 4

   Crie e copie agora

   A chave aparece uma única vez, completa. Copie-a para o seu gerenciador de senhas antes de fechar a janela. Depois, as Configurações mostram apenas os primeiros caracteres, quando foi usada pela última vez e quantas permissões ela tem.

Passo 2: adicione o endpoint ao seu cliente

A mesma página mostra um trecho pronto em Conectar um cliente MCP, com um botão de copiar. Clientes que leem uma configuração em JSON o aceitam como está; coloque sua chave no lugar de YOUR_KEY.

{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

No Claude Code, adicione o servidor pelo terminal. Guarde a chave em uma variável de ambiente em vez de digitá-la no histórico do shell.

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Outros assistentes, incluindo o ChatGPT, podem se conectar onde as configurações do app, do plano e do workspace permitirem um servidor MCP remoto personalizado com cabeçalho de autorização. O suporte varia entre clientes e muda com o tempo, então confira as páginas de ajuda do seu cliente; criar designs alinhados à marca pelo ChatGPT mostra o que observar. Depois de conectar, peça ao assistente que liste as ferramentas do Gradiently para confirmar que funcionou.

O que seu assistente pode fazer depois de conectado

O servidor expõe as mesmas ações que você tem no produto, com as mesmas permissões. Agrupadas por tarefa, ficam assim:

Pedidos simples funcionam melhor. O assistente os passa ao Designer, que lê o perfil da sua marca e o Mark da marca antes de compor qualquer coisa. Como no Studio, o trabalho do Designer é medido em créditos de IA.

• “Faça seis posts para o nosso lançamento de outono na nossa marca, em vertical para o Instagram.”
• “Pegue o anúncio de ontem e faça um story e um cabeçalho do X a partir dele.”
• “Encontre três Marks escuros com material de seda e me diga os códigos deles.”
• “Atualize o perfil da nossa marca: soamos calmos e precisos, nunca insistentes.”

Para um passo a passo mais completo especificamente com o Claude, veja criar designs com o Claude pelo Gradiently. Se você quer que o assistente fique na marca, diretrizes de marca que seu assistente de IA consegue seguir mostra como escrever o perfil da marca que ele lê.

Mantendo a conexão segura

Algumas garantias valem qualquer que seja o cliente. Uma chave só funciona no workspace que a emitiu. Ela age pelas mesmas regras da pessoa que a criou, então não pode fazer nada que o papel dela não possa. Uma chave nunca transfere a propriedade de um Mark para o workspace nem para ninguém. Designs privados continuam privados: um link somente de visualização só existe quando você pede um. E se a pessoa que criou uma chave for removida do workspace ou perder o papel de administradora, as chaves dela também deixam de funcionar.