Black Friday15% de desconto no Individual mensal. 5% de desconto no anual + 1 assento de cortesia. Oferta válida até 29 de novembro.
Servidor MCP local

Servidor MCP local

No Kerry Studio, o servidor MCP local liga as conexões salvas a um cliente de IA no desktop, como Claude Desktop, ChatGPT, Gemini, Conductor, Cursor, OpenCode, entre outros. Sem ele, listar tabelas, ver colunas ou executar SQL no chat exige colar schema ou resultado à mão.

O servidor escuta só no seu computador. Senha, SSH e certificado ficam protegidos no app. O MCP não os expõe. O assistente recebe projeto, ambiente, tipo de banco, nome da base, schema e o resultado das consultas que ele executar. O Kerry não envia isso aos servidores da Sireeus. O que chega até o assistente é configurável: quais projetos e ambientes o servidor pode usar, e quais valores omitir no mcp.log e na resposta. O cliente de IA ainda pode enviar o que o MCP devolveu ao modelo na nuvem dele. Use só com agentes em que você confia.

Antes de começar

Você precisa de:

  • Um workspace aberto no Kerry Studio
  • Um cliente de IA no desktop com suporte a MCP

Abrir o painel

  1. Abra um workspace.
  2. Na barra lateral direita, clique no ícone Servidor MCP.
  3. Ou use o rodapé do workspace (MCP ativado / MCP desativado) ou a paleta de comandos (⌘K / CtrlK) e escolha Abrir Painel MCP.

Por padrão o servidor não religa quando você fecha e abre o Kerry Studio. As preferências de início ficam em Configurações → MCP (ícone de engrenagem no cabeçalho Configuração do painel, ou paleta ⌘K / CtrlK → Configurações: MCP):

  • Ao iniciar o app → Iniciar com o servidor ligado: religa o servidor MCP ao abrir o Kerry Studio (padrão desligado).
  • Ao iniciar o app → Iniciar sempre no modo somente leitura: na próxima abertura, volta ao modo somente leitura mesmo que a sessão anterior estivesse em modo completo (padrão ligado).

No painel, o ícone de livro ao lado da engrenagem abre a documentação (Abrir documentação).

Configurar o cliente de IA

  1. No painel, ative Ativar servidor MCP.
  2. Clique em Copiar JSON.
  3. Cole o JSON nas configurações MCP do seu cliente (ou junte com a configuração que você já tem).
  4. Reinicie o cliente se ele não recarregar servidores sozinho.

Se o cliente cadastra MCP como um binário local, como o OpenCode, não cole o JSON. Use o comando em Como usar no OpenCode.

O endereço padrão é http://127.0.0.1:18765/mcp. No painel, Porta HTTP muda essa porta. Com o servidor ligado, o campo fica bloqueado. Copiar JSON usa a porta atual e o token real. Não use o YOUR_TOKEN de exemplo.

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

Como usar no OpenCode

Alguns clientes de IA no desktop, como o OpenCode, cadastram um servidor MCP como um binário local por padrão. O Kerry não é esse tipo de servidor. Ele escuta em HTTP no seu computador. Nesses apps, cadastre o Kerry pela URL, não como comando.

O JSON no formato mcpServers vale para clientes que colam a configuração. No OpenCode, com o servidor ligado no painel, rode:

bash
opencode mcp add kerry-studio --global --url http://127.0.0.1:18765/mcp --header 'Authorization=Bearer YOUR_TOKEN'

Troque YOUR_TOKEN pelo token que Copiar JSON coloca no JSON. Se você mudou Porta HTTP, use essa porta na URL. O --global deixa o Kerry disponível em todos os projetos do OpenCode. Se o comando recusar esse flag, a sua versão não tem essa opção. Rode o mesmo comando sem --global.

Somente leitura e modo completo

Por padrão o servidor fica em somente leitura: o assistente pode listar conexões, ver schema e rodar 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.

A troca de modo no painel vale na hora, então não precisa reiniciar o Kerry Studio.

Em Configurações → MCP → Somente leitura, Forçar somente leitura ao iniciar o servidor (padrão ligado) mantém o interruptor Modo somente leitura do painel marcado e bloqueado, e aplica somente leitura sempre que o servidor é ligado.

Permissões

No Kerry Studio, Permissões restringem quais projetos e ambientes salvos o servidor MCP local pode usar. Sem essa restrição, qualquer conexão salva fica disponível para o assistente. O padrão é todos os projetos e ambientes.

Somente leitura e leitura e escrita têm listas próprias. Assim você pode deixar o modo de leitura ver o catálogo inteiro e, no modo completo, liberar só alguns projetos.

Abra Permissões pelo Configurar do painel MCP, em Configurações → MCP, ou na paleta (⌘K / CtrlK) em MCP Permissões.

Em Permissões do servidor MCP, o topo troca entre Somente leitura e Leitura e escrita. Em uso mostra qual dessas listas o painel está aplicando agora: se Modo somente leitura estiver ligado, a marca fica em Somente leitura; se estiver desligado, fica em Leitura e escrita. Ajustar uma lista não altera a outra.

Na lista Leitura e escrita, Padrão de gravação define Inserir, Atualizar e Excluir para a lista, com os três ligados por padrão. Cada projeto ou conexão pode divergir desse padrão. A troca vale na próxima requisição do assistente.

Se Permitir todos os projetos e ambientes estiver ligado, o servidor usa o catálogo inteiro naquela lista. Desligue quando quiser escolher projeto a projeto.

Com o interruptor desligado, cada projeto e cada ambiente do projeto ganha o próprio controle. Em Incluir automaticamente o acesso a, você decide se Projetos novos e seus ambientes atuais e Ambientes novos nos projetos entram sozinhos. A busca restringe o que aparece por projeto, alias SQL (@alias) ou ambiente. Ativar todos e Desativar todos valem para o que está visível. A seta ao lado aplica a mesma ação a um ambiente: Ativar todos neste ambiente ou Desativar todos neste ambiente.

Quando você liga ou desliga Modo somente leitura no painel, o Kerry passa a aplicar a lista correspondente. A troca vale na próxima requisição do assistente. Se o projeto não estiver nessa lista, o Kerry não abre a conexão para o assistente. Uma consulta com @alias, por exemplo @billing.orders, aponta para uma conexão salva e também é bloqueada se essa conexão não estiver acessível.

O que o assistente acessa

Erros de conexão não devolvem usuário, host, senha nem caminho de arquivo. O resultado do SQL que o assistente recebe também não leva caminho, host, URI de conexão nem chave. O grid da aba no Kerry continua intacto.

A lista de conexões mostra projeto, ambiente, tipo de banco e nome da base (em arquivo local, o nome do arquivo, não o caminho).

Com o servidor ligado, o assistente também recebe:

  • nomes de tabelas e views
  • colunas e detalhes de tabela
  • até 500 linhas do resultado de cada SQL que o assistente executar
  • controle da aba de diagrama ER no workspace aberto

Controlar o diagrama ER

No Kerry Studio, o assistente pode usar a aba de diagrama ER como se fosse você. Ele abre a aba daquele projeto e ambiente se ela ainda não existir, ou foca a que já está aberta. Se essa aba ainda não estiver conectada, usar o diagrama (sincronizar, filtrar, enquadrar) conecta e atualiza o schema. O assistente só controla abas de diagrama ER. As permissões do MCP valem para abrir, sincronizar e trocar de ambiente. Ele também filtra tabelas, troca o layout, foca relacionamentos, ajusta o zoom e exporta a imagem. Na exportação, o Kerry salva o arquivo na pasta de Configurações → MCP. O padrão é a área de trabalho. Se não conseguir, pede onde salvar. O assistente recebe o caminho completo. O MCP não escolhe a pasta.

O SQL sem @alias continua numa sessão à parte e não troca a aba. SQL com @alias, por exemplo @billing.orders, usa a aba SQL ativa.

Enquanto o assistente controla o diagrama, a aba mostra a marca MCP. O rodapé do workspace mostra controlando a UI.

Exemplos:

  • “Abra o diagrama ER do projeto billing no ambiente Desenvolvimento.”
  • “No diagrama, mostre somente as tabelas que se relacionam com public.orders.”
  • “Enquadre o diagrama e exporte em PNG.”

Como pedir no chat

Fale o projeto e o ambiente, não só o nome técnico da conexão (por exemplo postgres).

Exemplos:

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

O assistente usa as conexões salvas no Kerry. SQL sem @alias roda numa sessão à parte: não troca a aba nem a barra Entidades. SQL com @alias, por exemplo @billing.orders, usa a aba SQL ativa, como Executar Query: @projeto.tabela segue o ambiente da aba. A aba ativa precisa ser SQL e estar ligada a esse projeto e ambiente. Só projetos salvos entram na barra Entidades.

O que o assistente pode fazer

ModoO assistente consegue
Somente leituraListar conexões, achar um projeto e ambiente, ver tabelas e colunas, buscar no schema, executar SQL de leitura, abrir e controlar a aba de diagrama ER
CompletoTudo acima, mais o SQL de escrita liberado em Permissões (Inserir, Atualizar e Excluir)

Ver quem está conectado

A seção Observabilidade do painel mostra os apps ligados ao Kerry.

  • O número no rodapé conta quantos apps estão conectados.
  • Cada cartão é um app. O número do cartão é quantas sessões no banco aquele app abriu.
  • Um aviso aparece quando um app liga, desliga ou passa a consultar um banco, mesmo com o painel fechado.

Para encerrar um app: clique na lixeira do cartão (Derrubar conexão) e confirme. Isso derruba a conexão daquele app. Se outro app ainda usa o mesmo banco, ele continua. Se for o último, o Kerry fecha as conexões MCP daquele banco.

Auditando o servidor

No Kerry Studio, o arquivo mcp.log registra cada troca com o assistente, com o app e a sessão. No arquivo, REQUEST é a requisição que o assistente enviou, inclusive o SQL. RESPONSE é o que o Kerry devolveu. Abra o arquivo no cabeçalho Observabilidade do painel MCP ou em Configurações, MCP. Se os logs estiverem desligados, o ícone fica desativado.

O Kerry oculta o valor quando o nome do campo é o termo da lista ou o contém. Também oculta se o SQL der outro nome à coluna, ao usá-la numa expressão, ou ler o campo dentro de um JSON e devolver o valor com outro nome. Isso vale em PostgreSQL, MySQL, Oracle e SQLite.

Por padrão, é ocultado:

  • No arquivo e na resposta ao assistente: valores de senhas, tokens, autorização e chaves privadas, quando o campo casa com a lista padrão daquele destino.
  • Só no arquivo mcp.log: valores de campos cujo nome é ou contém email, e e-mails que aparecem no meio do texto, mesmo quando não são uma coluna chamada email.
  • Só na resposta ao assistente: textos de conexão, chaves e trechos de erro que trariam host, usuário, caminho ou senha. Isso não depende do nome da coluna.

O SQL entra no mcp.log porque a auditoria guarda a requisição como ela chegou. Use o arquivo para conferir se alguma coluna do seu banco ainda aparece com o valor real no RESPONSE. Isso importa para campos que o Kerry não conhece, como um nome completo ou um documento. Se aparecer, em Valores omitidos no painel MCP ou na paleta de comandos (⌘K / CtrlK), acrescente o campo, escolha o destino (arquivo, assistente ou ambos) e se a correspondência é igual ou contém.

Se você desligar o log, essa escolha permanece. Se o arquivo já existir, o Kerry pede confirmação e o remove.

Se algo der errado

  • O cliente de IA não alcança o Kerry: confira se a URL usa 127.0.0.1, não localhost, e se a porta é a mesma de Porta HTTP. Depois de mudar a porta, use Copiar JSON de novo.
  • O cliente não conecta depois de colar o JSON: desligue e ligue o servidor no painel, ou reinicie o cliente de IA.
  • O OpenCode não conecta: o Kerry não é um MCP binário. Use opencode mcp add com --url e o header Authorization. Se o comando recusar --global, omita o flag.
  • A consulta foi recusada: o servidor está em somente leitura, ou aquele tipo de operação está desligado em Permissões. Ative o modo completo se a escrita for intencional e ligue Inserir, Atualizar ou Excluir conforme o SQL. SHOW e EXPLAIN de um SELECT são leitura; FOR UPDATE e SELECT INTO não.
  • Não achou o banco: peça pelo projeto e ambiente (nome ou @alias), não pelo rótulo da conexão.
  • SQL com @alias falhou: foque uma aba SQL ligada a esse projeto e ambiente, como em Executar Query.
  • O diagrama ER não abriu ou o ambiente foi recusado: confira Permissões e peça o projeto e o ambiente que estão nessa lista. O painel MCP só existe com um workspace aberto.

Se você regenerar o token no painel, cole o JSON de novo no cliente.