Servidor MCP

Um servidor Model Context Protocol publicado como @capydb/mcp. Roda localmente por stdio, ou remotamente em https://mcp.capydb.dev/mcp por Streamable HTTP, e chama a mesma API do plano de controle que o painel e a CLI - com o mesmo escopo de organização, as mesmas permissões e a mesma trilha de auditoria.

Ele traz um cliente escrito à mão em vez de depender do SDK em tempo de execução, então a instalação é pequena e a inicialização é imediata.

O Claude na web, no desktop e no celular — e qualquer cliente que suporte servidores MCP remotos — se conecta a https://mcp.capydb.dev/mcp. Nada para instalar, nenhuma chave para colar: na primeira vez que uma ferramenta precisa da sua conta, o cliente leva você ao login do CapyDB no navegador, onde você escolhe o workspace que ele pode usar. Bancos efêmeros descartáveis funcionam antes do login.

A conexão é uma chave de API de agente, listada em Configurações → Chaves de API e revogável ali a qualquer momento. Ela expira em 90 dias, e então o cliente pede para você conectar de novo. No Claude Code, adicione a mesma URL com o comando abaixo.

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

Adicione-o à configuração de servidores de qualquer cliente MCP. O servidor cuida da autenticação sozinho: no primeiro uso sem chave, devolve uma URL de login de dispositivo para você aprovar no navegador.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

• -Claude na web, no desktop e no celular pelo servidor remoto; Claude Code remoto ou local
• -Cursor, Windsurf e outros editores com suporte a MCP
• -Qualquer cliente que implemente o Model Context Protocol por stdio ou Streamable HTTP - o servidor atende tanto a revisão atual quanto a anterior
• -Seu próprio agente, por qualquer SDK de MCP

• -Projetos: listar, criar e inspecionar; bancos efêmeros que você pode assumir ou destruir
• -Conexões: obter strings de conexão diretas e agrupadas, e as credenciais do store K/V
• -SQL: consultas somente leitura e, em uma ferramenta separada, comandos que alteram dados, com resultados em JSON estruturado
• -Esquema: inspecionar tabelas, colunas, índices e extensões
• -Previews: criar, listar, redefinir e excluir bancos de preview
• -Backups: criar e listar backups, exportar dumps, criar pontos de restauração, restaurar em uma preview
• -Importações: iniciar e acompanhar uma importação de outro provedor
• -Operação: uso, logs, observabilidade, alertas, jobs e sugestões de índices

Ferramentas somente leitura se declaram somente leitura e as destrutivas se declaram destrutivas, para que um cliente possa restringi-las. Um UPDATE ou DELETE sem WHERE, ou um TRUNCATE, é recusado pelo plano de controle antes de rodar, e a recusa diz ao agente como corrigir a chamada; o servidor MCP nunca pula essa verificação. Para qualquer coisa mais arriscada, a descrição da ferramenta orienta o agente a criar antes um ponto de restauração.

Restaurar por cima de um banco de produção não é exposto como ferramenta, de propósito. Um agente pode restaurar em uma preview e você a promove; ele não pode sobrescrever seus dados de produção por conta própria.

Tudo o que o servidor diz sobre si vai para a saída de erro padrão, porque a saída padrão é o canal do protocolo. Se um cliente mostra lista de ferramentas vazia, a resposta quase sempre está no log MCP do cliente e não no servidor.