Chave de API: conectar um sistema ao Hub

Quando um sistema da sua empresa precisa ler ou escrever no Hub sem uma pessoa na frente, ele não usa login: usa uma chave de API. A chave carrega um acesso que você define app por app, tem validade, e pode ser revogada a qualquer momento sem mexer na conta de ninguém.

O que é e quando usar

Use uma chave de API para	Use outra coisa para
Um sistema seu ler ou gravar dados no Hub	Uma pessoa acessar o Hub: isso é conta e senha
Uma integração rodar sem ninguém logado	Um assistente de IA operar o Hub por você: isso é a conexão MCP
Dar acesso limitado a um fornecedor de tecnologia	Automatizar entre apps do próprio Hub: isso são as Automações

O que as chaves de API entregam hoje:

Trabalho	O que dá para fazer
Liberar com recorte	Nível geral de acesso, ou escolha app por app entre Sem, Leitura, Operar e Total
Identificar	Nome próprio por chave, para saber onde ela é usada sem abrir a integração
Limitar no tempo	Validade de 7 dias a 1 ano, ou sem expiração
Acompanhar	Lista com o responsável, os apps alcançados, a situação e o último uso
Cortar o acesso	Revogar na hora, mantendo o histórico, ou excluir o registro de uma chave já revogada
Consultar o contrato	Botão Documentação, com os apps que aceitam chamada por chave e a documentação de cada um

Conceitos e acesso

Termo	O que é	Onde aparece
Chave de API	A credencial que um sistema usa no lugar de login	Lista Chaves de API, em Configurações > Desenvolvimento > API
Acessos	Os apps que a chave alcança e o nível em cada um	Coluna Acessos, na lista
Nível	O quanto a chave pode fazer: Sem, Leitura, Operar ou Total	Matriz app por app, na criação
Expira em	A validade da chave. Depois dela, a chave para de funcionar	Na criação e na Visão geral da chave
Situação	Se a chave está Ativa, Expirada ou Revogada	Coluna Situação, na lista
Documentação das APIs	A lista dos apps que aceitam chamada por chave	Botão Documentação, na barra da lista

Onde fica. Em Configurações > Desenvolvimento > API. A barra da lista tem a busca, o filtro, o botão Documentação e o botão Criar chave de API. As conexões de assistente de IA ficam ao lado, em Configurações > Desenvolvimento > MCP.

Não confunda com a chave do MDC. A chave desta tela dá acesso aos apps do Hub. O Marvee Data Connection tem chaves próprias, que servem para consumir os endpoints publicados sobre os seus bancos e APIs, pelo gateway dele. São duas coisas separadas, com telas separadas: veja Limitar o alcance de uma chave de API do MDC quando o assunto for endpoint de dados.

Acesso. O recurso está disponível a partir do plano Colaborador, e a área de Desenvolvimento só abre com o seu e-mail confirmado. Se ainda não estiver, a tela mostra “Confirme seu e-mail para liberar chaves de API e conexões MCP” e o botão Confirmar e-mail. Criar chave é uma ação sensível: o Hub pede uma confirmação a mais na hora, na janela Confirme sua identidade. Quem administra a organização enxerga as chaves de todo mundo e pode filtrar entre Todas as chaves e Só minhas.

Primeiro uso: crie a chave

1. Abra Configurações e, no grupo Desenvolvimento, clique em API.
2. Clique em Criar chave de API. Abre a janela Nova chave de API.
3. Dê um Nome da chave que diga onde ela é usada, no estilo “Integração do ERP”. Quando existirem seis chaves, é esse nome que evita revogar a errada.
4. Em Acesso, escolha o nível. Você pode aplicar um nível geral ou ajustar app por app:

Nível	O que a chave pode
Somente leitura	Consulta o que dá para liberar sem revisar. Não escreve nada
Operação	Todos os acessos que você pode conceder: leitura e escrita, incluindo as ações sensíveis
Personalizado	Você escolhe o nível app por app, entre Sem, Leitura, Operar e Total

5. Em Expira em, deixe 90 dias (recomendado) ou escolha outra validade: 7 dias, 30 dias, 1 ano ou Sem expiração. Prefira sempre uma validade: a chave que expira sozinha não fica esquecida ligada.
6. Clique em Criar chave. Se o Hub pedir, confirme sua identidade na janela Confirme sua identidade, com a passkey, o app autenticador, a senha ou o código por e-mail, conforme o que a sua conta tiver.

Primeiro uso: copie a chave secreta agora

1. A janela Chave criada mostra a chave secreta com o aviso “Esta é a única vez que você vai ver a chave secreta.” Clique no botão de copiar ao lado dela.
2. Guarde a chave no cofre de senhas da empresa ou nos segredos do sistema que vai usá-la, nunca em conversa nem em planilha.
3. Em Configure seu cliente, os trechos de exemplo já trazem a chave e a organização. Use Copiar exemplo REST para levar a configuração para a integração.
4. Clique em Ver conexão. A chave aparece na lista com o nome e o acesso que você escolheu.

Consulte a documentação de cada app

Na barra da lista, clique em Documentação. Abre a janela Documentação das APIs, com os apps que aceitam chamada por chave. Em Buscar API, digite o nome do app e abra a documentação dele. Ela mostra apenas as operações que uma chave consegue alcançar, então o que aparece ali é o que dá para integrar de verdade.

A chamada é autenticada com a chave no cabeçalho de autorização, e o app precisa saber em qual organização trabalhar. Os campos exatos ficam na documentação de cada app, que é a fonte a seguir na hora de escrever a integração.

Administre o que existe

Na lista de chaves você acompanha nome, responsável, o acesso que cada uma carrega, a situação e o último uso. Quem administra a organização enxerga as chaves de todo mundo e pode filtrar entre Todas as chaves e Só minhas.

Clique numa chave para abrir a janela dela, com as abas Atividade, Visão geral e Acessos. A Visão geral mostra o responsável, quando a chave foi criada, quando expira e o último uso.

Duas ações importam:

• Revogar derruba o acesso na hora. O Hub avisa: “A chave perderá o acesso imediatamente. O histórico continuará disponível por até 90 dias.” e pede a confirmação em Revogar chave.
• Excluir aparece na chave que já não está ativa e remove o registro.

Revogue sempre que a integração sair do ar, que o fornecedor mudar, ou na menor suspeita de que a chave vazou. Não existe motivo para manter chave sem uso.

Como saber que deu certo

• A chave aparece na lista com o nome e o acesso que você escolheu, na situação Ativa.
• A primeira chamada do sistema externo responde com dado em vez de recusa, e a coluna Último uso passa a mostrar a data.
• Depois de revogar, a mesma chamada passa a ser recusada.

Limites e erros comuns

Expectativa	Realidade hoje
Dá para ver a chave secreta depois	Não. Ela aparece uma vez, na janela Chave criada. Perdeu, crie outra
A chave alcança tudo o que eu alcanço	Não. Ela alcança o que foi liberado nela, e nem todo app aceita chamada por chave
A chave parou de funcionar sozinha	Ela expirou. A janela da chave mostra Expirada e “Esta chave expirou. Crie uma nova chave para retomar a integração.”
Dá para mudar o acesso de uma chave que já existe	Não. Para mudar os acessos, revogue e crie outra
Uma chave serve para conectar o Claude ou o ChatGPT	Para assistente de IA existe a conexão MCP, ao lado, em Desenvolvimento
Renomear a chave troca a chave secreta	Não. A chave secreta continua a mesma
A chave continua valendo se a pessoa sair da empresa	Trate cada chave como acesso da empresa e revise a lista quando alguém sair

Erros comuns de quem começa: criar uma chave com acesso total porque é mais rápido, escolher Sem expiração sem motivo, e nomear a chave de “teste”, o que garante que ninguém saiba se pode revogar.

Próximo passo

• MCP: o Hub nas mãos da sua IA: quando o de fora é um assistente, não um sistema.
• Chamar um sistema externo no meio do fluxo: o caminho contrário, do Hub para fora.
• Proteger a sua conta: a passkey que tira a dependência do código por e-mail.