Stripe · HubSpot · Gmail 을 MCP 로 따로따로 붙이면 클로드가 쪽마다 넘기다 한도에 걸립니다. Airbyte Agents 는 서버 하나 뒤에 커넥터와 Context Store 를 둡니다. 클로드 코드에 붙이는 공식 명령과, 붙인 뒤 막아 둘 것을 한 자리에 모았습니다.
Airbyte Agents 는 Airbyte, Inc. 의 서비스입니다 — 우리가 만든 것이 아니고 제휴 관계도 없습니다. 우리가 만든 것은 한국어 안내와 이 PC 에 붙었는지 보는 점검뿐이고, Airbyte 를 대신 연결하지 않습니다. 값은 2026-10-02 에 공식 문서에서 확인한 것입니다.
도구마다 MCP 서버를 따로 붙이지 않고, https://mcp.airbyte.ai/mcp 하나 뒤에 커넥터 50개 이상를 둡니다.
고른 데이터를 검색용 복제본으로 미리 올려 둬서, 클로드가 「어디 있는지」부터 압니다. 보관용이 아니라 검색용입니다.
엔티티별·멤버별로 읽기/쓰기를 따로 정합니다. 처음엔 읽기만 켜는 쪽을 권합니다.
에이전트가 부른 도구 호출이 Airbyte 웹앱 Tool Calls 에 남습니다(Direct · Search 구분).
공식 문서(Agent MCP) 원문 그대로입니다. 보고 직접 치세요.
claude mcp add --transport http airbyte-agent https://mcp.airbyte.ai/mcpStripe·HubSpot 같은 서비스는 하나씩 따로 연결한다 — API 키 또는 OAuth. 문서 원문: "Each service requires its own authentication"
공식 문서 · 요금 문서 · 공식 벤치 저장소에 적힌 것만 옮겼습니다.
클로드 코드에 한국어 안내 스킬을 깔고, 이 PC 에 airbyte-agent 가 붙어 있는지 파일만 읽어 보여 줍니다(--check).
Airbyte 는 연결하지 않고, 어떤 설정도 고치지 않습니다.
터미널을 따로 열지 않아도 됩니다. 클로드 코드 안에서 둘 중 하나면 됩니다.
! 붙이기 — 제일 확실합니다
!npx --yes reborn-airbyte! 까지 함께 붙여넣으세요. 클로드를 거치지 않고 곧장 설치가 돕니다.--yes 도 빼지 마세요 — 이게 없으면 «받아도 되나요?» 하고 묻는 자리에서
아무 말 없이 멈춥니다.reborn-airbyte 설치해줘npx --yes reborn-airbytecmd 라고 친 뒤 엔터.
맥 — command+스페이스 누르고 터미널 엔터.~/.claude/skills)에 깔립니다.
여기서는 ! 를 빼세요.먼저 컴퓨터에 Node.js 가 있어야 합니다. 없으면 위 명령이 아예 안 뜁니다 —
nodejs.org 에서 큰 초록 버튼을 누르고
계속 «다음»만 누르시면 됩니다(3분). 클로드 코드를 쓰고 계시면 이미 있습니다.
클로드가 “실행하지 않겠습니다”라고 하면 1번을 쓰세요.
이제 막 나온 설치기라 클로드가 낯선 것으로 보고 막는 것이고, 그 판단 자체는 옳습니다.
! 를 붙이면 클로드에게 부탁하지 않고 바로 돌아갑니다.
폰이나 브라우저의 클로드 화면에서는 안 됩니다 — 그 창은 인터넷 저쪽의 임시 서버라
깔아도 내 컴퓨터에 남지 않습니다. 내 컴퓨터의 클로드 코드나 터미널에서 해 주세요.
깐 뒤 클로드 코드를 다시 열어야 스킬이 잡힙니다. 그다음 「에어바이트 붙이는 법 알려줘」처럼 말로 물으면 됩니다.