Credenciais

Credenciais guardam os segredos que a MarIA usa para falar com outros sistemas — chaves de API, tokens, dados de conexão. Elas são cadastradas uma vez, em um só lugar, e reutilizadas por ferramentas e servidores MCP.

Clique em Credenciais na barra lateral.

A tabela mostra Credencial, Tipo, Escopo, Status e Atualizada em. O campo Buscar credenciais e a opção Mostrar credenciais inativas ajudam quando a lista cresce.

Criar

Clique em Nova credencial. O formulário tem três blocos.

Identidade

Nome, Tipo, Descrição e Credencial ativa. Dê nomes que digam a que sistema a credencial pertence — você vai escolhê-la por esse nome ao configurar uma ferramenta.

Uso e delegação

Campo	O que faz
Allowed targets	Um padrão por linha, com * como curinga. Em branco, permite qualquer domínio
Soluções autorizadas	Disponível para todas as soluções ou uma seleção específica

Vale a pena preencher os dois. Allowed targets impede que a credencial seja usada contra um endereço inesperado, e a lista de Soluções autorizadas limita quem pode usá-la — só as soluções autorizadas verão a credencial na hora de configurar uma ferramenta.

Autenticação e tokens

Define onde o segredo entra na requisição: Enviar token / API key em Header ou Query string, o Nome do header e o valor da chave.

O segredo não volta a aparecer

Depois de salvo, o valor do segredo não é exibido novamente — a tela mostra apenas que ele existe. Para trocar, informe um valor novo.

Rotacionar sem parar o serviço

Como a credencial é referenciada por nome pelas ferramentas, trocar o segredo dentro dela atualiza todas as ferramentas de uma vez, sem editar nenhuma. É o motivo para nunca digitar uma chave direto no header de uma ferramenta.

Quando a chamada falha por autorização

1. Confirme que a credencial está Ativa.
2. Confirme que a solução da ferramenta está entre as Soluções autorizadas.
3. Verifique se o endereço chamado casa com os Allowed targets.
4. Se o sistema do outro lado rotacionou a chave, atualize o segredo aqui.