HubSpot을 MCP를 사용하여 Claude에 연결합니다.

HubSpot무료 플랜쿼리 스트림클로드

자연스러운 영어로 HubSpot 계정에 관해 Claude에게 물어보세요. 네트워크 내부에서 실행되는 Agent가 SQL을 읽기 전용으로 실행하므로 AI 클라이언트에 로그인 정보가 저장되지 않습니다. 약 10분이면 설정할 수 있으며 Free 플랜으로 이용할 수 있습니다.

무료로 시작하세요

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

클로드 에이전트는 실시간 읽기 전용 쿼리를 통해 HubSpot 계정에 대한 질문에 답변하고, 각 열의 의미를 설명하며, 추가 요청 시 후속 조치를 취할 수 있습니다. 데이터베이스 로그인이나 방화벽 변경 없이, 네트워크 내부에 이미 설치된 에이전트가 SQL 쿼리를 실행하고 결과 행만 전송합니다. 에이전트 설치 후 설정 화면을 사용하는 데 익숙하다면 클로드 연결은 약 90초 정도 소요됩니다. 설정 화면은 다음과 같습니다.

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

무엇이 들어있나요? 허브스팟딜 HubSpot 계정에서 몇 개의 행을 보여주고 각 열이 무엇을 의미하는지 알려주세요.

qs_get_table_schema qs_run_query 스키마 인텔리전스

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

거래명	거래 단계	양
1042	노스윈드 트레이더스	시애틀
1057	알파인 아웃피터스	덴버
1063	하버 푸드	핼리팩스

거래명 행을 식별합니다. 거래 단계 그리고 양 해당 항목들은 시맨틱 인텔리전스 모델에 설명되어 있으므로 이름으로 필터링할 수 있습니다.

그 세 가지는 무엇입니까? 양 이번 분기에 가장 많은 수익을 창출한 항목은 가치 평가였는데, 지난 분기와 비교하면 어떤가요? 제가 살펴봐야 할 부분이 있을까요?

qs_get_relationships qs_run_query qs_run_query

저는 합류했습니다 허브스팟딜 에게 주문 시맨틱 인텔리전스가 발견한 관계를 기반으로 각 분기별로 집계 쿼리를 실행했습니다. 두 쿼리 모두 읽기 전용이었으며 각각 3개의 행을 반환했습니다.

양	이번 분기	지난 분기	변화
덴버	184,200	133,900	+38%
시애틀	171,650	168,400	+2%
핼리팩스	96,300	129,700	-26%

덴버 요점은 고객 수는 거의 동일한데 매출이 38% 증가하여 평균 주문 금액이 상승했다는 것입니다. 핼리팩스 매출이 26% 감소했는데, 이는 지난 분기에 매달 주문하던 고객 두 명이 이번 분기에는 전혀 주문하지 않았기 때문입니다. 이달 말 전에 연락해 보는 것이 좋겠습니다. 시애틀 지역은 변동이 없습니다. 핼리팩스 지역 고객 두 곳의 이름을 알고 싶으신가요?

선택만 가능하며, 담당자가 확인합니다. MCP 활동 탭에 로그인됨 3개의 쿼리에서 총 9개의 행이 반환되었습니다. 14개의 MCP 클라이언트에서 동일한 연결

차라리 AI 클라이언트를 아예 설치하지 않는 게 나을까요? 사업 계획서에 관하여, Nova MCP는 Query Streams 자체에 내장된 어시스턴트입니다. AI 클라이언트가 사용하는 것과 동일한 에이전트 툴셋을 활용할 뿐만 아니라, 외부 클라이언트에는 없는 추가 기능도 제공합니다. 즉, 시맨틱 인텔리전스 모델에 대한 SQL 쿼리를 작성하고 유효성을 검사하고, 결과를 차트로 변환하고, 팀에서 Excel, Google Sheets 또는 REST API를 통해 실행할 수 있는 쿼리 형식으로 저장합니다. 키나 커넥터, 설치해야 할 것이 전혀 없습니다. 팀원들이 이미 Claude, Cursor 또는 ChatGPT를 사용하고 있다면 MCP를 사용하고, 포털 내에서 바로 결과를 확인하고 싶다면 Nova를 사용하세요.

HubSpot은 API를 통해 사용자 데이터를 관리합니다. 반면 Claude는 브라우저나 터미널에서 실행되며 데이터에 대한 정보는 전혀 알지 못합니다. 기존 방식은 스키마를 채팅창에 붙여넣거나 오픈소스 MCP 서버에 HubSpot 비밀번호를 전달하는 것이었습니다. 하지만 Query Streams는 다릅니다. HubSpot 계정에 이미 설치된 에이전트가 Claude가 작성하는 SQL 쿼리를 읽기 전용으로 실행하고, MCP 서버는 그 사이에 누가 어떤 작업을 얼마나 자주 요청하는지 확인합니다. Claude는 응답만 받을 뿐, 계정 정보는 절대 접근하지 않습니다.

필요한 것

Query Streams 계정

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

HubSpot은 에이전트를 통해 연결되었습니다.

HubSpot 연결이 데이터 에이전트에 추가된 항상 켜져 있는 모든 컴퓨터에 에이전트를 설치하세요. 아직 완료되지 않았나요? 먼저 HubSpot에 연결하세요.약 10분 정도 걸립니다.

MCP가 활성화되었습니다.

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

AI 클라이언트

claude.ai, Claude Desktop, ChatGPT와 같은 채팅 앱은 키 없이 연결됩니다. Claude Code, Cursor, VS Code 및 약 10개의 다른 도구는 키를 사용합니다. 포털의 AI 클라이언트를 연결하세요 가이드가 각각을 설정합니다.

네 단계로 설정하세요

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

   로그인하세요 my.querystreams.com 그리고 열기 스트림 → 라이브 → MCP이 페이지에는 네 개의 탭이 있습니다. 연결, 문맥, 도구 그리고 관리자의 경우, 활동의미 지능 패널을 확인하세요. 연결 여기 계신 김에 알려드릴 게 있습니다. HubSpot 커넥터 목록과 Semantic Intelligence가 해당 커넥터에서 실행되었는지 여부를 보여줍니다. 완벽한 적용 범위 덕분에 Claude는 HubSpot SQL 쿼리를 처음부터 정확하게 작성할 수 있습니다.

   MCP 열기

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

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

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

   채팅 앱 · 키 없음

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

   claude.ai 및 Claude Desktop에서 다음을 엽니다. 쿼리 스트림 목록 Anthropic의 커넥터 디렉토리에서 클릭하세요. 연결하다 그리고 승인합니다. URL로 추가하려면, https://mcp.querystreams.com/mcp이것이 대체 방법입니다. ChatGPT에서는 앱(현재는 개발자 모드)에서 쿼리 스트림을 추가하고 쿼리 스트림으로 로그인합니다. 어느 방법을 사용하든 쿼리 스트림 페이지가 열립니다. 조직과 권한을 선택하고 클릭하세요. 연결 승인복사할 내용이 없습니다. 연결은 다음과 같습니다. 연결 탭에서 취소할 수 있습니다.

   개발자 도구 · 핵심

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

   MCP 페이지에서 클릭하세요 AI 클라이언트를 연결하세요가이드가 묻습니다. 귀사의 AI 클라이언트는 어떻게 연결될까요?: 선택하다 설정 파일에서 키를 사용하세요자, 도구를 고르세요. 키를 생성하세요 그것: 하나 키 이름, 읽다 그리고 쿼리를 실행합니다 체크 표시됨, 그리고 만료 (절대, 30일, 90일 또는 1년). 설정하세요 키가 채워진 코드 조각을 보여줍니다. 연결 상태를 확인하세요 첫 번째 전화를 기다립니다.

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

   읽다

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

   쿼리를 실행합니다

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

   분석하다

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

   열쇠를 잃어버리셨나요? 목록에 등재되어 있습니다. 연결 꼬리표: 전체 키 공개 그것을 다시 보여주고 전체 키를 복사하세요 복사합니다. 노트북을 분실하면 해당 권한을 취소하세요. 그렇지 않으면 해당 권한을 사용하는 모든 클라이언트가 약 5분 이내에 다음 통화에서 오류가 발생합니다.

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

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

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

   1. 열기 쿼리 스트림 목록 Anthropic의 커넥터 디렉토리에서 클릭하세요. 연결하다데스크톱에서는 그 아래에 위치합니다. + → 커넥터.
   2. 조직에서 디렉터리 커넥터를 숨기는 경우 대체 방법: 설정 → 커넥터 → 사용자 지정 커넥터 추가, 이름 쿼리 스트림URL https://mcp.querystreams.com/mcpOAuth 필드가 비어 있습니다. 추가하다그런 다음 채팅에서 + → 쿼리 스트림 → 연결하다.
   3. '쿼리 스트림' 탭이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택한 후 검토하세요. 읽다 그리고 쿼리를 실행합니다선택적으로 특정 커넥터로 제한그리고 클릭하세요 연결 승인.
   4. 클로드 화면으로 돌아가면 "쿼리 스트림에 연결됨"이라는 메시지가 표시됩니다. 클로드가 도구를 처음 사용할 때 선택하라는 메시지가 나타납니다. 항상 허용하세요.

   Claude Desktop에서 수동으로 추가하는 경우 다음을 사용하십시오. 설정 → 커넥터 → 추가채팅창이 아니라 마켓플레이스 추가 이 옵션은 Git 저장소를 필요로 합니다. 커넥터는 Claude 계정과 동기화되므로 모바일 앱과 데스크톱에서 자동으로 인식합니다. 메뉴 이름은 Anthropic에서 지정한 이름이며, 필요에 따라 변경할 수 있습니다.

   클로드 코드 열쇠

   연결 탭에서 키를 사용하여 한 번의 명령으로 모든 작업을 수행할 수 있습니다.

   단말기

   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 상태 표시줄에 나타납니다.

   다른 걸 사용하시나요? 포털의 AI 클라이언트를 연결하세요 가이드 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. 첫 번째 질문을 해보세요

   클로드가 적절한 도구를 찾는 모습을 볼 수 있도록, 이미 답을 알고 있는 질문부터 시작해 보세요. HubSpot 계정과 잘 어울리는 세 가지 도구는 다음과 같습니다.

   "내 HubSpot 계정에는 어떤 데이터가 있나요?"

   클로드는 볼 수 있는 테이블 목록을 보여주고, 의미 지능 기능을 갖춘 테이블을 알려주며, 어떤 내용을 보고 싶은지 묻습니다.

   "hubsp.deals에서 10개 행을 보여주고 각 열에 대해 설명해 주세요."

   클로드는 먼저 테이블 구조를 읽고(읽기), 에이전트를 통해 하나의 SELECT 쿼리를 실행한 다음(쿼리 실행), 거래 단계와 금액이 무엇을 의미하는지 설명합니다.

   "hubspot.deals에는 금액별로 몇 개의 행이 있나요? 어떤 금액에 행이 가장 많나요?"

   클로드는 HubSpot에서 사용하는 구문으로 GROUP BY 절을 작성하고 실행한 다음, 간단한 표와 함께 한 문장으로 답변을 보냅니다. 같은 채팅창에서 후속 조치를 취하면 맥락을 유지할 수 있습니다.

   배선이 제대로 되었는지 확인하려면 문의하십시오. “내가 보유한 Query Streams 커넥터는 무엇인가요?”클로드가 전화합니다. qs_list_connectors포털 가이드의 연결 상태를 확인하세요 스텝은 다음과 같이 말합니다. 연결됨그리고 키 또는 앱은 연결 탭에는 해당 내용이 표시됩니다. 마지막 사용 몇 초 안에 시간이 걸립니다.

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

AI 클라이언트는 쿼리 스트림 도구를 보고 질문에 가장 적합한 도구를 선택합니다. 포털의 도구 꼬리표 각 도구와 모드, 그리고 사용 중인 요금제에 포함된 항목을 모두 나열합니다. Query Streams는 쿼리를 실행하기 전에 AI 클라이언트가 각 테이블의 열을 읽도록 요청하므로, 추측하는 대신 실제 이름을 사용해 쿼리를 작성합니다. 무료 요금제를 포함한 모든 요금제에서 이용할 수 있습니다:

분석 도구 모음. 유료 플랜에서는 에이전트가 HubSpot 계정이 있는 곳에서 기본 작업을 수행하므로 AI 클라이언트는 사고에 집중할 수 있습니다. 무료 플랜은 기존 방식대로 작동합니다.

기본 설정은 다음과 같습니다. 문맥 꼬리표텍스트 셀 제한, 스키마 보기, 결과 크기, 분석 기본값 및 보류된 결과.

여기서 시맨틱 인텔리전스가 중요한 이유

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

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

계획이 허용하는 것

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

연결된 앱은 하나의 키로 간주됩니다. 분당 사용량 제한 외에도, 하나의 키는 분당 최대 10개의 쿼리를 실행할 수 있습니다. 쿼리는 AI 클라이언트가 추가 시간을 요청하지 않는 한 최대 60초 동안 실행되며, 추가 시간이 필요한 경우 최대 5분까지 실행될 수 있습니다. 또한, 플랜에 따라 쿼리가 반환하는 행 수와 분석 도구 세트를 사용하는 경우 결과 보관 기간 및 크기가 설정됩니다. MCP 전체 가이드 모든 계획을 나열합니다. AI 클라이언트가 받는 데이터는 Excel 및 Sheets 쿼리와 동일한 풀인 Data Realm 허용량에서 차감됩니다. AI 에이전트(MCP) 사용량은 결과, 스키마 읽기, 보류된 결과 페이지를 비롯해 AI 클라이언트에 전달되는 모든 바이트를 계산하며, 클라이언트가 협상하는 전송 압축을 적용하기 전 기준으로 집계됩니다. 반면 스프레드시트 쿼리는 Network Agent가 전달하는 압축된 결과를 기준으로 계산합니다. AI 클라이언트에서 시작한 Semantic Intelligence 실행은 Portal에서 시작한 경우와 마찬가지로 Nova AI 크레딧을 사용합니다. 가격 페이지를 참조하세요. 수당에 대해서요.

안전하게 보관하기

좋은 다음 행보입니다

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

무언가가 작동하지 않을 때

사람들이 묻는 질문

관련 가이드

• MCP를 사용하여 Stripe를 Claude에 연결합니다.
• MCP를 사용하여 Shopify를 Claude에 연결합니다.
• MCP를 사용하여 Google Analytics 4를 Claude에 연결합니다.
• MCP를 사용하여 Google Search Console을 Claude에 연결합니다.
• MCP를 통해 쿼리 스트림을 Claude에 연결하는 방법: 설정, 권한 및 문제 해결
• HubSpot을 Google Sheets에 연결하는 방법
• 모든 MCP 가이드