MCP를 통해 클로드까지 철도를 연결하세요

MCP · 클로드행 철도

묻다 클로드 귀사의 철도 데이터베이스에 관하여, 쉽게 말해서

Claude, Claude Code, Cursor 또는 기타 MCP 클라이언트를 Query Streams에 한 번만 연결하세요. Claude는 Railway 데이터베이스의 구조를 읽고 SQL 쿼리를 작성한 후, 이미 데이터가 저장된 에이전트를 통해 읽기 전용으로 실행하고 결과를 행 단위로 반환합니다. 데이터베이스 암호는 AI에 절대 전달되지 않습니다. 소요 시간은 약 10분이며, 무료 플랜으로 이용 가능합니다.

약 10분 Claude, ChatGPT, Cursor 외 11개 클라이언트 자격증명은 영구적으로 보관됩니다. 항상 읽기 전용입니다.

당신이 최종적으로 얻게 될 것

A Claude that can answer questions about your Railway 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:

클로드 챗GPT 커서 클로드 코드 VS 코드 윈드서핑 제미니 CLI 젯브레인즈 사본+5개 더읽기 전용

무엇이 들어있나요? 고객 내 철도 데이터베이스에서 몇 개의 행을 보여주고 각 열이 무엇을 의미하는지 알려주세요.

qs_get_table_schema qs_run_query 스키마 인텔리전스

먼저 테이블 구조를 살펴본 후, 에이전트를 통해 읽기 전용 쿼리를 실행했습니다. 다음은 고객 행 세 개입니다.

customer_id	이름	도시
1042	노스윈드 트레이더스	시애틀
1057	알파인 아웃피터스	덴버
1063	하버 푸드	핼리팩스

customer_id 행을 식별합니다. 이름 그리고 도시 are described in your Schema Intelligence model, so I can filter on them by name.

Which three 도시 values brought in the most revenue this quarter, and how does that compare with last quarter? Anything I should look into?

qs_get_relationships qs_run_query qs_run_query

I joined 고객 에게 주문 on the relationship Schema Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

도시	This quarter	Last quarter	Change
덴버	184,200	133,900	+38%
시애틀	171,650	168,400	+2%
핼리팩스	96,300	129,700	−26%

덴버 is the story: revenue up 38% on almost the same number of customers, so average order value rose. 핼리팩스 fell 26%, and the drop is two customers who ordered every month last quarter and not at all this quarter — worth a call before month end. Seattle is flat. Want the two Halifax accounts by name?

선택만 가능하며, 담당자가 확인합니다. MCP 활동 탭에 로그인됨 9 rows returned across 3 queries 14개의 MCP 클라이언트에서 동일한 연결

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.

Railway는 제공업체가 운영하는 클라우드에 데이터를 저장합니다. 반면 Claude는 브라우저나 터미널에서 실행되며 데이터에 대해 아무것도 알지 못합니다. 일반적인 연결 방식은 스키마를 채팅창에 붙여넣거나 오픈 소스 MCP 서버에 Railway 비밀번호를 전달하는 것입니다. Query Streams는 다릅니다. Railway Postgres 데이터베이스와 함께 설치된 에이전트가 Claude가 작성하는 SQL 쿼리를 읽기 전용으로 실행하고, 그 사이에 MCP 서버가 누가 어떤 작업을 얼마나 자주 요청하는지 확인합니다. Claude는 응답만 받고 자격 증명은 절대 받지 않습니다.

철도 데이터베이스는 기본적으로 비공개입니다. 에이전트는 공개 액세스가 활성화되면 철도의 TCP 프록시를 통해 연결합니다.

필요한 것

Query Streams 계정

MCP는 무료 플랜을 포함한 모든 플랜에서 이용 가능합니다. 무료 플랜에서는 키 하나 또는 연결된 앱 하나만 사용할 수 있으며, 이 가이드에서는 그것으로 충분합니다. 가입은 다음 링크에서 하세요. my.querystreams.com.

대리점을 통해 연결된 철도

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

선택하세요 철도 card in the Portal. It pre-fills database railway, user 포스트그레스 and SSL on. In Railway, enable public access for the Postgres service under Settings, Networking. Then copy DATABASE_PUBLIC_URL from its Variables tab and paste it, and the TCP-proxy host and port fill in. The .railway.internal host only works inside Railway, and the form rejects it.

MCP가 활성화되었습니다.

제작자, 소유자 및 관리자는 처음부터 해당 권한을 갖습니다. 그 외의 모든 사용자는 권한을 변경하려면 관리자의 승인이 필요합니다. MCP 이름 옆에 있는 스위치를 누르세요. 계정 → 접근 제어그때까지 MCP 페이지에는 "귀하의 계정에 대해 MCP가 비활성화되었습니다."라는 메시지가 표시됩니다.

AI 클라이언트

Claude 웹 버전, Claude 데스크톱 버전 또는 Claude 모바일 앱은 키 입력 없이 연결됩니다. Claude Code, Cursor, ChatGPT를 비롯한 약 10가지 도구도 사용 가능하며, 포털에는 각 도구에 대한 사용 방법이 미리 준비되어 있습니다.

네 단계로 설정하세요

1. 포털에서 MCP를 엽니다.

   로그인하세요 my.querystreams.com 그리고 열기 스트림 → 라이브 → MCP이 페이지에는 네 개의 탭이 있습니다. 연결하다, 연결된 앱, 내 열쇠 그리고 관리자의 경우, 활동확인해 보세요 내 열쇠 여기 있는 동안 사이드 패널을 확인해 보세요. 여기에는 Railway 커넥터와 해당 커넥터에서 스키마 인텔리전스가 실행되었는지 여부가 표시됩니다. 완벽한 적용 범위 덕분에 Claude는 첫 시도에 정확한 Railway SQL을 작성할 수 있습니다.

   MCP 열기

   "MCP가 귀하의 계정에서 비활성화되었습니다"라는 메시지가 표시되나요? 귀 조직은 MCP를 사용하고 있지만 해당 사용자는 비활성화되어 있습니다. 관리자가 다음 명령어를 사용하여 MCP를 활성화합니다. MCP 이름 옆에 있는 스위치를 누르세요. 계정 → 접근 제어제작자, 소유자 및 관리자는 처음부터 참여합니다.

2. 연결 방식을 선택하세요

   들어가는 길은 두 가지이며, 두 길 모두 같은 곳으로 이어집니다.

   채팅 앱 · 키 없음

   claude.ai, 클로드 데스크톱, ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click 연결하다. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcp채팅을 통해 연결할 수도 있습니다. 쿼리 스트림 페이지가 열리면 조직과 권한을 선택하고 클릭합니다. 연결 승인복사할 것도 없고, 비밀로 할 것도 없습니다. 연결은 아래에 있습니다. 연결된 앱 그리고 그곳에서 취소될 수 있습니다.

   개발자 도구 · 핵심

   Claude Code, Cursor, VS Code 및 관련 프로그램

   ~에 내 열쇠 딸깍 하는 소리 키를 생성합니다. 줘 보세요 키 이름 예를 들면, "내 노트북의 클로드 코드"처럼, 계속 읽다 그리고 실행하다 체크 표시를 하셨다면, 하나를 선택하세요. 만료 (절대, 30일, 90일 또는 1년)을 선택하고 클릭하세요. 키를 생성합니다복사한 다음 설치를 계속 진행하세요: 그 연결하다 탭에는 키가 이미 채워진 해당 도구의 정확한 코드 조각이 표시됩니다.

   두 방법 모두 동의 화면이나 키에서 선택하는 동일한 세 가지 권한을 사용합니다.

   읽다

   커넥터 목록을 확인하고, 테이블과 열을 탐색하고, 저장된 쿼리와 알림 규칙을 읽어보세요. 행 데이터는 절대 반환하지 않습니다.

   실행하다

   에이전트를 통해 읽기 전용 SQL 및 저장된 쿼리를 실행하고 행을 반환합니다. 에이전트가 없으면 Claude는 데이터를 설명할 수는 있지만 데이터를 기반으로 답변을 제공할 수는 없습니다.

   분석하다

   프로필 테이블을 생성하고, 관계를 파악하며, 스키마 인텔리전스 실행을 대기열에 추가합니다. 이 기능은 Nova AI 크레딧과 데이터 허용량을 소모하므로 동의 화면에서 자동으로 선택 해제되지 않습니다.

   열쇠를 잃어버리셨나요? 열려 있는 내 열쇠눈 모양 아이콘을 클릭하면 다시 표시됩니다. 전체 키를 복사하세요 복사합니다. 노트북을 분실하면 해당 권한을 취소하세요. 그렇지 않으면 해당 권한을 사용하는 모든 클라이언트가 약 5분 이내에 다음 통화에서 오류가 발생합니다.

3. 클로드에게 연결하세요

   사용하는 클로드에 맞는 레시피를 선택하세요. 서버 주소는 어디에서나 동일합니다. https://mcp.querystreams.com/mcp.

   웹 버전 클로드, 데스크톱 버전 클로드 및 모바일 버전 열쇠 없음

   1. 열려 있는 설정 → 커넥터 클릭하고 클릭하세요 커넥터 찾아보기. Query Streams is listed in the Anthropic Connectors Directory: find 쿼리 스트림 클릭하고 클릭하세요 연결하다. (Or open the directory listing directly and click 연결하다 there.)
   2. If your organization hides directory connectors, click 사용자 지정 커넥터 추가 instead. Name it 쿼리 스트림, 반죽 https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click 추가하다, then in any chat click + → 커넥터 찾아보기 → 쿼리 스트림 → 연결하다.
   3. '쿼리 스트림' 탭이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택한 후 검토하세요. 읽다 그리고 실행하다선택적으로 특정 커넥터로 제한그리고 클릭하세요 연결 승인.
   4. 클로드 화면으로 돌아가면 "쿼리 스트림에 연결됨"이라는 메시지가 표시됩니다. 클로드가 도구를 처음 사용할 때 선택하라는 메시지가 나타납니다. 항상 허용하세요.

   If you do add it by hand in Claude Desktop, use 설정 → 커넥터 → 추가채팅창이 아니라 마켓플레이스 추가 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.

   클로드 코드 열쇠

   '내 키'에서 키를 사용하여 한 번의 명령으로 모든 작업을 완료하세요.

   단말기

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

   그것이 현재 프로젝트의 내용을 작성합니다. .mcp.json. 추가하다 --scope 사용자 모든 프로젝트에 쿼리 스트림을 포함시키려면 실행하세요. /mcp 클로드 코드 내부를 살펴보면 연결된 것을 확인할 수 있습니다.

   커서 열쇠

   열려 있는 커서 설정 → MCP → 새 MCP 서버 추가또는 편집 .cursor/mcp.json 워크스페이스의 최상위 폴더:

   .cursor/mcp.json

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

   커서를 다시 시작하거나 실행하세요 MCP: 서버 재시작; 아 쿼리스트림 배지가 MCP 상태 표시줄에 나타납니다.

   다른 걸 사용하시나요? 그만큼 연결하다 꼬리표 ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev 및 JetBrains AI용 바로 붙여넣을 수 있는 레시피가 포함되어 있습니다. 붙여넣기 및 병합 떨어뜨리는 도구 쿼리스트림 기존 설정 파일에 항목을 추가합니다. HTTP를 통해 MCP를 지원하는 모든 클라이언트가 작동합니다. 서버 https://mcp.querystreams.com/mcp헤더 X-MCP-키 (한 권한: 무기명 동일한 키를 가진 헤더도 작동합니다.

4. 첫 번째 질문을 해보세요

   클로드가 적절한 도구를 찾는 모습을 볼 수 있도록, 이미 답을 알고 있는 것부터 시작해 보세요. 철도 Postgres 데이터베이스와 잘 어울리는 세 가지 도구는 다음과 같습니다.

   "내 철도 Postgres 데이터베이스에는 어떤 데이터가 있나요?"

   Claude는 볼 수 있는 테이블 목록을 보여주고, 스키마 인텔리전스가 있는 테이블을 알려주며, 어떤 테이블을 보고 싶은지 묻습니다.

   "고객 데이터에서 10개 행을 보여주고 각 열에 대해 설명해 주세요."

   클로드는 먼저 테이블 구조를 읽고(읽기), 에이전트를 통해 하나의 SELECT 쿼리를 실행한 다음(실행), 이름과 도시가 무엇을 의미하는지 설명합니다.

   "도시별로 고객 예약 건수는 총 몇 건인가요? 어느 도시에 가장 많은 예약 건수가 있나요?"

   클로드는 철도 사투리로 그룹화 조건을 입력하고 실행한 다음, 작은 표와 함께 한 문장으로 답합니다. 같은 채팅창에서 후속 대화를 나누면 맥락을 유지할 수 있습니다.

   배선이 제대로 되었는지 확인하려면 문의하십시오. “내가 보유한 Query Streams 커넥터는 무엇인가요?”클로드가 전화합니다. qs_list_connectors그리고 위에 내 열쇠 열쇠의 마지막 사용 시간은 몇 초 내에 업데이트됩니다. 연결된 앱은 아래에 표시됩니다. 연결된 앱 연결 시간과 마지막 사용 시간을 함께 표시합니다.

클로드가 연결되면 할 수 있는 일

클로드는 열아홉 개의 작은 도구를 봅니다. 당신은 직접 그것들을 부르지 않습니다. 클로드가 당신의 질문에 딱 맞는 도구를 골라냅니다. 쉽게 말해서,

스키마 인텔리전스가 중요한 이유

클로드가 받는 모든 답변에는 해당 구조의 출처가 표시되며, 클로드는 자신이 보는 정보를 얼마나 신뢰할지 조정합니다.

데이터베이스가 중요하다면, 스키마 인텔리전스를 한 번 실행해 보세요. 노바 → 인텔리전스그. 내 열쇠 탭에는 커넥터별 적용 범위 패널이 표시됩니다. 스키마 인텔리전스는 어떻게 작동할까요?.

계획이 허용하는 것

MCP는 무료 플랜을 포함한 모든 플랜에 별도 요금 없이 포함되어 있습니다. 각 플랜은 보유할 수 있는 키 또는 연결된 앱의 수와 클로드(Claude)가 분당 걸 수 있는 통화 횟수를 설정합니다.

연결된 앱은 하나의 키로 간주됩니다. 분당 사용량 외에도, 하나의 키로 분당 최대 10개의 쿼리를 실행할 수 있습니다. 쿼리는 최대 1,000개의 행을 반환하며, Claude가 추가 요청을 하지 않는 한 최대 60초 동안 실행됩니다. 단, 최대 행 수는 50,000개, 실행 시간은 5분입니다. Claude가 수신하는 행 수는 사용자의 Data Realm 할당량에 포함되며, 이는 Excel 및 Sheets 쿼리에서 사용하는 것과 동일한 풀입니다. MCP는 압축 전에 측정되므로, 결과가 클수록 스프레드시트에서 동일한 행을 사용하는 경우보다 비용이 더 많이 발생합니다. Claude에서 시작된 스키마 인텔리전스 실행은 포털에서 실행되는 것과 마찬가지로 Nova AI 크레딧을 사용합니다. 가격 페이지를 참조하세요. 수당에 대해서요.

안전하게 보관하기

좋은 다음 행보입니다

• 표준적이라고 생각하는 쿼리를 저장하세요. 쿼리 빌더에서 클로드는 저장된 쿼리를 먼저 사용하므로 "활성 고객"은 팀에서 정의한 의미를 갖습니다.
• Claude Project를 사용하세요 쿼리 스트림을 첨부하고 해당 지침에 사용자 규칙을 추가하세요. 예를 들어 기본적으로 사용할 철도 데이터베이스, 저장된 쿼리 중 공식 정의로 사용할 쿼리 등을 지정할 수 있습니다.
• 보다 심층적인 답변을 원하시면 Grant Analyze를 이용하세요. 필터링하기 전에 열을 프로파일링하는 것은 상태 코드를 추측하는 것과 올바른 상태 코드를 사용하는 것의 차이입니다. 이 기능은 Nova AI 크레딧을 소모하므로 사용자가 해제하기 전까지는 비활성화됩니다.
• 차트를 요청하세요. claude.ai는 Claude가 반환하는 행들을 기반으로 차트를 그립니다.

무언가가 작동하지 않을 때

사람들이 묻는 질문

관련 가이드

• MCP를 사용하여 Microsoft SQL Server를 Claude에 연결합니다.
• MCP를 사용하여 PostgreSQL을 Claude에 연결합니다.
• MCP를 사용하여 MySQL을 Claude에 연결합니다.
• MCP를 사용하여 Microsoft Access를 Claude에 연결합니다.
• MCP를 통해 쿼리 스트림을 Claude에 연결하는 방법: 설정, 권한 및 문제 해결
• 모든 MCP 가이드