Ver categorias

Conecte o Render ao Claude com o MCP.

5 minutos de leitura

MCP · Renderizar para Claude

Perguntar Claude sobre seu banco de dados Render, em inglês simples

Conecte o Claude, o Claude Code, o Cursor ou qualquer cliente MCP ao Query Streams uma única vez. O Claude lê a estrutura do seu banco de dados Render, escreve o SQL, executa-o em modo somente leitura através do Agente que já está conectado aos seus dados e retorna as linhas. Nenhuma senha do banco de dados chega à IA. Leva cerca de dez minutos e o plano gratuito cobre esse processo.

Cerca de 10 minutos Claude, ChatGPT, Cursor + 11 outros clientes As credenciais permanecem com você. Somente leitura, sempre
Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

O resultado final será o que você obterá.

Renderizar logotipoA Claude that can answer questions about your Render Postgres database with live, read-only queries, explain what the columns mean, and follow up when you ask for more — without ever seeing a database login, and without a firewall change: the Agent already inside your network runs the SQL and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

Nova, the Query Streams assistant

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

O Render armazena seus dados na nuvem, sob a gestão do seu provedor. O Claude, por outro lado, reside em um navegador ou terminal e não sabe nada sobre isso. A solução usual é colar um esquema no chat e torcer para que funcione, ou fornecer sua senha do Render para um servidor MCP de código aberto. O Query Streams funciona de forma diferente: o Agente que já está conectado ao seu banco de dados Postgres do Render executa o SQL que o Claude escreve, em modo somente leitura, e o servidor MCP verifica, entre as consultas, quem está fazendo a solicitação, o que pode ser feito e com que frequência. O Claude obtém as respostas. Ele nunca recebe as credenciais.

O Render executa um PostgreSQL gerenciado em conjunto com seus serviços Render. O Agente acessa o banco de dados através do nome de host externo do Render, que sempre utiliza TLS.

ONDE O AGENTE CORREQualquer computador ou servidor sempre ligado com acesso à internet.Sua renderizaçãobanco de dadosAs credenciais permanecem aqui.Agente de fluxos de consultaexecuta o SQL que Claude escreveSomente SELECT, aplicado aqui.Fluxos de consultaServidor MCPVerifica chaves, escopos e limite de taxa; registra todas as chamadas.ONDE VOCÊ PERGUNTAclaude.ai, Claude Desktop, Claude Code, Cursor, ChatGPTSeu cliente de IAContém uma chave ou uma conexão, nunca uma senha.
Claude nunca acessa seu banco de dados Render. Ele consulta o servidor Query Streams MCP, que retransmite a solicitação pela conexão de saída que seu Agente já mantém aberta. O Agente executa a consulta e envia de volta apenas as linhas.

O que você vai precisar

Uma conta do Query Streams

O MCP está disponível em todos os planos, inclusive no plano gratuito. O plano gratuito permite uma chave ou um aplicativo conectado, que é tudo o que este guia precisa. Cadastre-se em my.querystreams.com.

Renderização conectada através do Agente

The Agent installed on any always-on computer, with the Render connection added in Data Agents.

Choose the Render card in the Portal. It pre-fills port 5432 and SSL on. Open your database in the Render Dashboard, click Conectar, and copy the External connection string. Paste it and the host, database, user and password fill in. The internal URL only works inside Render, so the Agent cannot use it.

MCP ativado para você

Criadores, proprietários e administradores têm acesso desde o início. Todos os outros precisam de um administrador para ativar o recurso. MCP alterne ao lado do nome deles abaixo Conta → Controle de acessoAté então, a página do MCP exibe a mensagem "O MCP está desativado para sua conta".

Um cliente de IA

O Claude na web, o Claude Desktop ou os aplicativos móveis do Claude se conectam sem necessidade de chave. O Claude Code, o Cursor, o ChatGPT e cerca de outras dez ferramentas também funcionam; o Portal possui uma configuração pronta para cada uma delas.

Onde o trabalho é realizado? No computador que executa o Agente. Ele recebe o SQL que Claude escreveu, verifica se é um SELECT, executa-o e retorna as linhas. Portanto, esse computador precisa estar ligado quando você fizer a solicitação; seu próprio laptop só precisa do cliente de IA.

Configure em quatro etapas

  1. Abra o MCP no portal.

    Faça login em my.querystreams.com e aberto Transmissões → Ao vivo → MCPA página possui quatro abas: Conectar, Aplicativos Conectados, Minhas chaves e, para administradores, AtividadeVerifique o Minhas chaves Painel lateral: ele lista seu conector de renderização e se a Inteligência de Esquema foi executada nele. A cobertura completa é o que permite que Claude escreva SQL de renderização correto na primeira tentativa.

    Está vendo a mensagem “O MCP está desativado para sua conta”? Sua organização possui MCP, mas seu usuário está desativado. Um administrador o ativa com o MCP alterne ao lado do seu nome abaixo. Conta → Controle de acessoCriadores, proprietários e administradores estão presentes desde o início.

  2. Escolha como você se conectará.

    Existem duas entradas, e ambas terminam no mesmo lugar:

    Aplicativos de bate-papo · sem chave

    claude.ai, Claude Desktop, ChatGPT

    In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Conectar. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcpe conecte-se por meio de um chat. Uma página de Fluxos de Consulta será aberta, você seleciona a organização e as permissões e clica em Aprovar conexãoNada para copiar, nada para manter em segredo. A conexão aparece em Aplicativos Conectados e pode ser revogada lá.

    Ferramentas de desenvolvedor · uma chave

    Claude Code, Cursor, VS Code e amigos

    Sobre Minhas chaves clique Gerar chaveDê uma olhada. Nome da chave como “Código Claude no meu laptop”, mantenha Ler e Executar Com a opção marcada, escolha uma Validade (Nunca, 30 dias, 90 dias ou 1 ano) e clique Gerar chaveCopie-o e então Continue a instalação: o Conectar A aba mostra o trecho de código exato para sua ferramenta com a chave já preenchida.

    Ambas as formas utilizam as mesmas três permissões, que você escolhe na tela de consentimento ou na chave:

    Ler
    Liste conectores, navegue por tabelas e colunas, leia suas consultas salvas e regras de alerta. Nunca retorna dados de linha.
    Executar
    Execute consultas SQL somente leitura e consultas salvas por meio do seu Agente e retorne as linhas. Sem isso, Claude pode descrever seus dados, mas não responder com base neles.
    Analisar
    Criar tabelas de perfil, descobrir relacionamentos e agendar uma execução do Schema Intelligence. Isso consome créditos e dados do Nova AI, portanto, a tela de consentimento nunca é marcada previamente.

    Perdeu a chave? Aberto Minhas chavesO ícone do olho mostra isso novamente e Copiar chave completa copia-o. Revogue-o lá se um laptop desaparecer; todos os clientes que o utilizam falham na próxima chamada, em cerca de cinco minutos.

  3. Conecte-se com Claude

    Escolha a receita do Claude que você usa. O endereço do servidor é o mesmo em todos os lugares: https://mcp.querystreams.com/mcp.

    Claude na web, Claude para desktop e dispositivos móveis. sem chave

    1. Aberto Configurações → Conectores e clique em Navegue pelos conectores. Query Streams is listed in the Anthropic Connectors Directory: find Fluxos de consulta e clique em Conectar. (Or open the directory listing directly and click Conectar there.)
    2. If your organization hides directory connectors, click Adicionar conector personalizado instead. Name it Fluxos de consulta, colar https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Adicionar, then in any chat click + → Navegue pelos conectores → Fluxos de consulta → Conectar.
    3. Uma aba "Fluxos de Consulta" será aberta. Faça login, se solicitado, selecione a organização e revise. Ler e Executar, opcionalmente Limitar a conectores específicose clique Aprovar conexão.
    4. De volta ao Claude, você vê “Conectado aos Fluxos de Consulta”. Na primeira vez que o Claude usa uma ferramenta, ele pergunta: escolha Permitir sempre.

    If you do add it by hand in Claude Desktop, use Configurações → Conectores → Adicionar, não o chat interno Adicionar ao mercado option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

    Código Claude chave

    Um único comando, com a sua chave de "Minhas Chaves":

    terminal
    claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_COLE_SUA_CHAVE_AQUI"

    Isso descreve o projeto atual. .mcp.json. Adicionar --escopo usuário Para ter fluxos de consulta em todos os projetos. Execute /mcp dentro do Código Claude para ver se está conectado.

    Cursor chave

    Aberto Configurações do cursor → MCP → Adicionar novo servidor MCPou editar .cursor/mcp.json na raiz do seu espaço de trabalho:

    .cursor/mcp.json
    { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_COLE_SUA_CHAVE_AQUI" } } } }

    Reinicie o Cursor ou execute MCP: Reiniciar servidores; um fluxos de consulta O ícone aparece na barra de status do MCP.

    Usar outra coisa? O Conectar guia Possui receitas prontas para colar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, além de um Colar e mesclar ferramenta que solta o fluxos de consulta entrada em um arquivo de configuração que você já possui. Qualquer cliente que se comunique via MCP sobre HTTP funciona: servidor https://mcp.querystreams.com/mcp, cabeçalho Chave X-MCP (um Autorização: Portador O cabeçalho com a mesma chave também funciona).

  4. Faça sua primeira pergunta

    Comece com algo cuja resposta você já saiba, para que possa ver Claude escolher a ferramenta certa. Três opções que funcionam bem com seu banco de dados Render Postgres:

    “Quais dados tenho no meu banco de dados Render Postgres?”
    Claude lista as tabelas que consegue visualizar, informa quais possuem Inteligência de Esquema e pergunta o que você deseja examinar.
    “Mostre-me dez linhas de clientes e explique cada coluna.”
    Claude primeiro lê a estrutura da tabela (Ler), depois executa um SELECT através do seu Agente (Executar) e descreve o que nome e cidade significam.
    “Quantas filas de clientes existem por cidade? Qual cidade tem o maior número?”
    Claude escreve o GROUP BY no dialeto de Render, executa-o e responde em uma frase com uma pequena tabela. Continue a conversa no mesmo chat; isso mantém o contexto.

    Para confirmar a fiação, pergunte “Quais conectores de fluxos de consulta eu tenho?”Claude liga qs_list_connectorse em Minhas chaves a chave Último uso A hora é atualizada em poucos segundos. Um aplicativo conectado aparece abaixo. Aplicativos Conectados com a hora em que foi conectado e a última vez que foi usado.

É isso. Agora, Claude responde a partir do seu banco de dados Render Postgres sempre que você pergunta, em qualquer instância do Claude que você tenha aberto. Nada saiu da sua rede, exceto as linhas necessárias para a pergunta, e ninguém digitou uma senha em uma IA.

O que Claude pode fazer quando estiver conectado

Claude vê dezenove pequenas ferramentas. Você nunca as nomeia; Claude escolhe a certa para a sua pergunta. Em outras palavras:

Entenda seus dados

Liste os conectores, bancos de dados e agentes. Leia as tabelas e colunas do seu banco de dados Render com descrições, valores de exemplo e relacionamentos após a execução do Schema Intelligence.

Perfil e exploração

Analise o perfil de uma coluna para ver seus valores reais antes de filtrá-la. Descubra junções entre tabelas que nunca tiveram uma chave estrangeira declarada. (Analisar)

Utilize suas consultas salvas

Liste as consultas parametrizadas salvas em que sua equipe confia e execute-as com novos valores. Consultas federadas que abrangem várias fontes são executadas no servidor e retornam já unidas.

Executar SQL somente leitura

Escreva e execute um SELECT no dialeto correto para Render. Por padrão, até 1.000 linhas e 60 segundos; Claude pode solicitar mais, até 50.000 linhas e cinco minutos. (Executar)

Verificar alertas

Liste suas regras de alerta, o estado atual delas e as ativações recentes. Claude pode criar uma regra como teste; uma pessoa a ativa na página de Alertas.

Melhorar o modelo

Verifique a cobertura do Schema Intelligence por banco de dados e, com sua concordância, agende uma execução para que as próximas respostas sejam melhores. (Analisar)

Os nomes das ferramentas, caso queira reconhecê-las nas respostas de Claude.
PermissãoFerramentas
Lerqs_list_organizações qs_list_agentes qs_list_connectors qs_get_si_status qs_get_connector_schema qs_get_table_schema qs_get_relacionamentos qs_list_saved_queries qs_get_task_status qs_list_alert_rules qs_get_alert_state qs_list_alertas_recentes
Analisartabela_de_perfil_qs qs_descobrir_relacionamentos qs_request_si_analysis qs_setup_si
Executarqs_executar_consulta qs_executar_consulta_salva qs_create_alert_rule (apenas propõe; nunca armado por Claude)

Por que a Inteligência de Esquema é importante aqui?

Cada resposta que Claude recebe é etiquetada com a origem da estrutura, e Claude ajusta o grau de confiança que deposita no que vê.

NívelO que Claude vêResultado
Inteligência de esquemasDescrições para cada tabela e coluna, valores de exemplo, significados de enumerações, junções declaradas e descobertas.Claude escreve o código SQL correto para renderização logo na primeira tentativa e explica os dados em termos de negócio.
Esquema capturadoNomes de tabelas e colunas, tipos, chaves.Claude trabalha, mas infere significados a partir de nomes e pode solicitar informações adicionais.
Esquema ao vivoO banco de dados está fora da seleção de captura do conector, portanto a estrutura é lida em tempo real a cada solicitação (requer permissão de Execução; SQL Server, MySQL e PostgreSQL).As consultas ainda são executadas. Claude explora com seleções menores quando precisa de mais informações.

Se um banco de dados for importante, execute o Schema Intelligence nele uma vez a partir de Nova → Inteligência. O Minhas chaves A aba mostra um painel de cobertura para cada conector. Como funciona a Inteligência de Esquemas.

O que os planos permitem

O MCP está incluído em todos os planos, inclusive no plano gratuito, sem custo adicional. O que cada plano define é a quantidade de chaves ou aplicativos conectados que você pode armazenar e quantas chamadas Claude pode fazer por minuto:

PlanoChaves por usuárioChaves por organizaçãoChamadas por minuto
Gratuito1130
Núcleo Pessoal1160
Personal Plus1190
Núcleo de negócios23120
Negócios Plus35150
Business Max510240
Núcleo Empresarial525300
Enterprise Plus850450
Empresa Max10100600

Um aplicativo conectado conta como uma chave. Além do valor por minuto, cada chave pode executar no máximo 10 consultas por minuto. Uma consulta retorna até 1.000 linhas e leva até 60 segundos para ser executada, a menos que Claude solicite mais, com um limite máximo de 50.000 linhas e cinco minutos. As linhas recebidas por Claude são contabilizadas no seu limite do Data Realm, o mesmo pool usado pelas suas consultas do Excel e do Planilhas Google, e o MCP (Maximum Charge Point - Ponto Máximo de Compressão) é medido antes da compressão, portanto, um resultado amplo custa mais aqui do que as mesmas linhas em uma planilha. As execuções do Schema Intelligence iniciadas por Claude consomem créditos do Nova AI, exatamente como acontece no Portal. Consulte a página de preços. pelas verbas.

Mantendo-o seguro

Somente leitura, verificado pelo agente.

Somente instruções SELECT são executadas. A verificação ocorre no computador que executa o Agente, antes que o banco de dados Render veja o SQL, portanto, nada que Claude escreva pode alterar os dados.

Sem credenciais em IA

O login do Render permanece no Agente. Claude possui uma chave ou conexão do Query Streams, que você pode revogar na página do MCP; a alteração entra em vigor em cerca de cinco minutos.

Tudo é registrado.

Cada chamada de ferramenta aparece no MCP. Atividade A guia e cada consulta no Histórico de Consultas são registradas como tipo de cliente MCP, atribuídas à pessoa cuja chave ou conexão as executou. O texto SQL e a própria chave nunca são gravados no log de atividades.

O que o provedor de IA recebe

Os nomes das tabelas e colunas, as descrições do Schema Intelligence, incluindo valores de exemplo, e as linhas das consultas que você solicita são enviados ao provedor de IA que você conectou, de acordo com os termos dele. O Query Streams nunca vê seu chat.

Boas próximas jogadas

  • Salve as consultas que você considera canônicas. No Construtor de Consultas, Claude prioriza as consultas salvas, portanto, "clientes ativos" significa o que sua equipe define.
  • Use um projeto Claude Com o recurso Query Streams anexado, você pode inserir suas regras personalizadas nas instruções: qual banco de dados de renderização usar por padrão e quais consultas salvas são as definições oficiais.
  • Conceda a função de Analisar quando desejar respostas mais aprofundadas. Analisar o perfil de uma coluna antes de filtrá-la é a diferença entre adivinhar um código de status e usar o correto. Isso consome créditos de IA da Nova, portanto, ficará desativado até que você o desative.
  • Peça um gráfico. O claude.ai gera gráficos a partir das linhas que Claude recebe de volta.

Quando algo não funciona

O que você vêO que significaConsertar
Claude não exibe nenhuma ferramenta de fluxos de consulta.O conector foi adicionado, mas nunca se conectou a partir de um chat, ou a chave foi colada no lugar errado.Em Claude: + → Procurar conectores → Consultar fluxos → ConectarEm uma ferramenta de desenvolvedor: reinicie-a e verifique. Último uso Nas minhas chaves.
CHAVE MCP OBRIGATÓRIA ou 401Nenhuma chave chegou ao servidor, geralmente devido a uma quebra de linha perdida ao copiar e colar ou à chave estar no cabeçalho errado.Copie a chave novamente de "Minhas Chaves" e envie-a em seguida. Chave X-MCP cabeçalho.
MCP_USUÁRIO_DESATIVADOUm administrador desativou o MCP para o seu usuário.Peça-lhes para virar o MCP ligue novamente em Conta → Controle de acesso.
MCP_SCOPE_REQUIRED ou MCP_SCOPE_NEGADOA chave ou a conexão não possui permissão para essa ação, geralmente Executar.Edite a chave em Minhas Chaves e marque a caixa. ExecutarOu então, reconecte o aplicativo e aprove-o.
MCP_KEY_ORG_LIMIT_EXCEEDEDO limite de chaves do seu plano foi atingido. No plano gratuito, isso corresponde a uma chave ou um aplicativo conectado.Cancele um plano que você não usa mais ou mude para um plano superior.
MCP_AGENT_NOT_CONNECTED ou MCP_AGENT_NOT_REGISTEREDO agente que possui seu banco de dados Render não está conectado no momento.Aberto Dados → Agentes de Dados e inicie o Agente no computador dele.
MCP_DATABASE_NOT_CAPTUREDO banco de dados está fora da seleção de captura do conector, portanto não há esquema armazenado nem Inteligência de Esquema para ele. As consultas ainda funcionam.Adicione-o à seleção de captura no conector e, em seguida, execute a Inteligência de Esquema se desejar respostas mais detalhadas.
MCP_TAXA_LIMITADAMuitas chamadas por minuto para o seu plano, ou mais de 10 consultas por minuto em uma única tecla.Aguarde um momento. A Inteligência de Esquema permite que Claude atenda em menos chamadas.
MCP_QUERY_TIMEOUT ou MCP_OUTPUT_TOO_LARGEA consulta excedeu o tempo limite ou retornou mais informações do que Claude pode processar em uma única resposta.Peça para reduzir o número de linhas ou colunas, ou para usar um filtro de data. Normalmente, Claude sugere isso por conta própria.
MCP_DATA_REALM_EXAUSTADOO limite de dados da sua organização para o período foi esgotado.Aguarde até que o saldo seja redefinido ou recarregue-o pelo Portal.
violação de modo somente leituraO SQL não era um SELECT.Por design. Nada escreve através do MCP.

Perguntas que as pessoas fazem

Claude pode alterar meus dados de renderização?

Não. O Agente aceita apenas instruções SELECT e verifica isso antes da execução do SQL. Claude pode enfileirar uma execução do Schema Intelligence ou criar uma regra de alerta como teste; ambas gravam nos metadados do Query Streams, nunca no seu banco de dados Render.

Preciso abrir uma porta ou usar uma VPN?

Não. O agente estabelece uma conexão de saída na porta 443, e tanto as requisições quanto as linhas trafegam por ela. Se o HTTPS de saída funcionar, o MCP funciona.

O plano gratuito realmente cobre isso?

Sim. O plano gratuito é permanente, não um período de teste com prazo de validade. O MCP está incluído em todos os planos; o plano gratuito permite uma tecla ou um aplicativo conectado e 30 chamadas por minuto. Veja exatamente o que o plano gratuito inclui. página de preços.

Quais outras ferramentas de IA funcionam além do Claude?

Qualquer ferramenta que utilize MCP via HTTP: ChatGPT, Cursor, VS Code com Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, todas possuem uma receita pronta na aba Conectar.

Claude consegue enxergar a organização como um todo?

Uma chave alcança todos os conectores da sua organização. Um aplicativo conectado pode ser limitado a conectores específicos mediante sua aprovação. Cada chave ou conexão pertence a uma organização; conecte-se apenas uma vez por organização, conforme necessário.

Qual a diferença entre este e o Nova?

Nova é o assistente dentro do Portal Query Streams e compartilha o mesmo modelo de Inteligência de Esquema. Use Nova quando quiser respostas dentro do Query Streams; use MCP quando quiser seus dados dentro do Claude, junto com tudo o que você já faz lá.

Claude conhece o dialeto SQL de Render?

Sim. Cada resposta de esquema informa ao Claude qual tipo de conector está sendo analisado, e o Claude escreve o SQL para esse mecanismo. Com a Inteligência de Esquema, ele também vê as descrições das colunas e os valores de exemplo, então para de ter que adivinhar o que um código de status ou uma abreviação significa.

Meu banco de dados Render Postgres precisa estar no mesmo computador que o Claude?

Não. Apenas o Agente precisa estar onde seu banco de dados Render Postgres está localizado, ou em qualquer computador sempre ligado com acesso à internet. O Claude pode estar no seu laptop, no seu celular ou em um servidor em outro lugar; ele só se comunica com os Fluxos de Consulta.

Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.
Atualizado em setembro 28, 2026

Desenvolvido por BetterDocs