Como usar MCP com um banco sem expor as credenciais?

Pedir ajuda a uma IA para trabalhar com um banco de dados geralmente envolve copiar informações para o chat: o schema de uma tabela, uma query que não funciona ou o resultado de uma consulta. Embora pareça inofensivo, esse hábito pode expor dados de produção, informações pessoais e outros detalhes que você talvez não quisesse compartilhar.

Usar um servidor MCP não elimina esse risco automaticamente. Se o agente precisar receber as credenciais de acesso ao banco, você estará apenas mudando a forma de compartilhá-las.

O Kerry Studio adota outra abordagem. O servidor MCP roda localmente e permite que clientes de IA para desktop, como Claude Desktop, ChatGPT, Gemini, Conductor e Cursor, trabalhem com as conexões que você já configurou no aplicativo. As credenciais permanecem no Kerry, sem precisar ser fornecidas ao assistente.

Isso não significa que os dados consultados nunca chegam à IA. O assistente recebe as informações necessárias para executar as tarefas, como o projeto, o ambiente, o tipo de banco, a base de dados, o schema e os resultados das consultas. Se você usa um modelo na nuvem, o cliente de IA pode enviar essas informações ao provedor do modelo. O Kerry Studio não as envia aos servidores da Sireeus.

Você também controla o que o assistente pode fazer. Por padrão, o acesso é somente leitura. Você pode limitar os projetos e ambientes disponíveis e, se precisar permitir alterações, ativar o modo completo e liberar Inserir, Atualizar ou Excluir. O arquivo mcp.log registra as solicitações que o assistente envia ao servidor e as respostas que o Kerry devolve.

Há um limite importante: quando o assistente consulta o banco, o schema e até 500 linhas de cada resultado precisam chegar ao cliente de IA para o modelo analisar. Por isso, evite conceder acesso a ambientes ou dados que o assistente não deveria consultar, e use apenas clientes de IA em que você confia.

A ideia é simples: dar à IA acesso controlado aos seus bancos sem entregar a ela as credenciais de conexão. Você mantém as senhas no Kerry Studio e define quais dados e operações ficam disponíveis para o assistente.

Como ligar o servidor

O painel MCP não aparece na tela de seleção de workspaces. Abra um workspace.

1. Na barra lateral direita, clique no ícone Servidor MCP. Também vale o rodapé (MCP ativado / MCP desativado) ou a paleta (⌘K / CtrlK) → Abrir Painel MCP.
2. Ative Ativar servidor MCP.
3. Clique em Copiar JSON e cole nas configurações MCP do cliente.
4. Reinicie o cliente se ele não recarregar servidores sozinho.

O endereço padrão é http://127.0.0.1:18765/mcp. Use 127.0.0.1, nunca localhost. O Kerry só aceita 127.0.0.1. Copiar JSON usa a porta atual e o token real. Não use o YOUR_TOKEN de exemplo.

{
  "mcpServers": {
    "kerry-studio": {
      "url": "http://127.0.0.1:18765/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Por padrão o servidor não religa quando você fecha e abre o Kerry Studio. Em Configurações → MCP, Ao iniciar o app → Iniciar com o servidor ligado muda isso.

Começar em somente leitura

Por padrão o servidor fica em somente leitura. O assistente lista conexões, vê schema e roda consultas de leitura: SELECT, SHOW, DESCRIBE, EXPLAIN (inclusive com ANALYZE de um SELECT). INSERT, UPDATE, DELETE, SELECT … FOR UPDATE, SELECT INTO, INTO OUTFILE e consultas WITH que alteram dados são recusados.

Somente leitura já abre o banco na sessão do assistente. Sem isso não há schema nem SELECT. As abas SQL do Kerry não precisam estar conectadas.

Forçar somente leitura ao iniciar o servidor (padrão ligado) mantém o interruptor Modo somente leitura marcado e bloqueado sempre que o servidor liga.

Limitar o que o assistente pode acessar

Sem restrição, qualquer conexão salva fica disponível para o assistente. O padrão é todos os projetos e ambientes. Permissões muda isso.

Abra Permissões pelo Configurar do painel MCP, em Configurações → MCP, ou na paleta em MCP Permissões.

Somente leitura e leitura e escrita têm listas próprias. Dá para deixar o modo de leitura ver o catálogo e, no modo completo, liberar só alguns projetos. Desligue Permitir todos os projetos e ambientes quando quiser escolher projeto a projeto.

Se o projeto não estiver na lista em uso, o Kerry não abre a conexão para o assistente. Uma consulta com @alias, por exemplo @billing.orders, também é bloqueada se essa conexão não estiver acessível.

Como pedir pelo projeto e pelo ambiente

Fale o projeto e o ambiente, não só o tipo do banco. Sem isso o assistente escolhe a conexão errada ou pergunta de novo.

Exemplos:

• “no projeto billing, ambiente Desenvolvimento, liste as tabelas”
• “no Billing / Desenvolvimento, quais colunas tem em public.products?”

SQL sem @alias roda numa sessão à parte: não troca a aba nem a barra Entidades. SQL com @alias usa a aba SQL ativa, que precisa estar ligada a esse projeto e ambiente.

Conferir o que saiu no mcp.log

No Kerry Studio, o arquivo mcp.log registra cada troca com o assistente. REQUEST é o que o assistente enviou, inclusive o SQL. RESPONSE é o que o Kerry devolveu. Abra o arquivo no cabeçalho Observabilidade do painel MCP.

Por padrão o Kerry oculta senhas, tokens, autorização e chaves privadas no arquivo e na resposta. E-mails somem só no arquivo. Textos de conexão, host, usuário e caminho somem só na resposta ao assistente. Se uma coluna do seu banco ainda aparecer com o valor real no RESPONSE, acrescente o campo em Valores omitidos.

Na seção Observabilidade, cada cartão é um app ligado ao Kerry. A lixeira (Derrubar conexão) encerra aquele app.

O detalhe de cada controle está em Servidor MCP local.