Chaves API MCP
A seção MCP API Keys permite criar e gerenciar chaves de acesso seguras utilizadas por ferramentas MCP e integrações dentro do Gaio DataOS. Essas chaves controlam quais projetos podem acessar recursos habilitados via MCP e integrações externas.
O que é uma MCP API Key?
Uma MCP API Key é um token de autenticação vinculado a um projeto, utilizado para:
Autorizar ferramentas MCP
Permitir comunicação segura entre o Gaio e serviços externos compatíveis com MCP
Controlar acesso no nível de projeto
Cada chave pode ser:
Ativada ou desativada individualmente
Renovada (rotacionada)
Associada a um ou mais projetos
Visualizando MCP API Keys Existentes
Acesse:
Settings → MCP API Keys
Nesta tela, você verá as seguintes colunas:
ID
Identificador interno da chave.
Status
Indica se a chave está:
Active – Pode ser utilizada normalmente
Inactive – Está desabilitada
Nome
Nome descritivo da chave (ex: OpenAI, Internal MCP, Automation Key).
Token
Valor secreto utilizado para autenticação.
Os tokens ficam ocultos por padrão
É possível clicar em Renew para gerar um novo token
Projetos
Quantidade de projetos onde a chave está habilitada.
Criando uma Nova MCP API Key
Clique em New
Preencha o campo:
MCP API Key Name Nome descritivo da chave
Ative o Status caso deseje que a chave esteja ativa imediatamente
Clique em Add
A chave será gerada automaticamente.
Associando Projetos a uma MCP API Key
Após criar a chave:
Clique no badge Projetos
Selecione um ou mais projetos
Confirme a associação
Apenas os projetos selecionados poderão utilizar essa MCP API Key.
Renovando uma MCP API Key
Se o token for comprometido ou precisar de rotação:
Localize a chave na lista
Clique em Renew
Um novo token será gerado
Atualize os sistemas externos que utilizam essa chave
Ao renovar, o token anterior é invalidado imediatamente.
Editando ou Excluindo uma Chave
Edit
Permite alterar:
Nome da chave
Projetos associados
Delete
Remove permanentemente a chave.
Qualquer integração que utilize essa chave deixará de funcionar imediatamente.
Boas Práticas
Utilize uma MCP API Key por integração ou finalidade
Associe a chave apenas aos projetos que realmente precisam de acesso
Realize rotação periódica utilizando Renew
Desabilite ou exclua chaves que não estejam em uso
Nunca compartilhe tokens em repositórios públicos ou código client-side
Segurança
MCP API Keys são armazenadas com segurança e mascaradas na interface
Tokens são exibidos apenas no momento da criação ou renovação
O controle de acesso é aplicado no nível de projeto
Chaves podem ser revogadas instantaneamente ao serem desativadas ou excluídas
As MCP API Keys fornecem uma forma controlada, auditável e segura de conectar o Gaio DataOS a ferramentas MCP e sistemas externos.
Atualizado