[데이터 연동] 플러그 데이터, 매번 확인하고 옮기고 있다면

이번 달 보고서에 넣을 데이터를 플러그에서 내려받아 다시 정리하고 계신가요?
견적서 상태가 바뀌었는지 확인하려고 수시로 로그인하는 일도 있으실텐데요.

매달 같은 작업을 반복하면 시간이 꽤 듭니다.
담당자가 바뀌면 데이터를 어디서 찾고 어떻게 옮기는지까지 인수인계해야 하고요.

플러그 데이터를 이미 쓰고 있는 업무 도구에 연결하면 이런 작업을 줄일 수 있어요.
연결 방법은 웹훅, 오픈 API, MCP 세 가지입니다.

이름을 외우기보다, 지금 반복하는 업무에 어떤 방식이 맞는지부터 골라보세요.

1. “견적서가 바뀌면 알려주세요” 👉 웹훅

견적서가 수정됐을 때 담당자에게 알림을 보내거나, 의뢰 변경 내용을 사내 시스템에 전달하고 싶다면 웹훅을 사용할 수 있어요.

플러그에서 설정한 이벤트가 발생하면, 미리 등록한 수신 주소로 데이터를 보내주는 방식이에요.
예를 들어 견적서를 수정했을 때 사내 시스템이 변경 데이터를 받아 담당자에게 확인 알림을 보내도록 구성할 수 있어요.

다만 수신 주소만 등록한다고 알림까지 만들어지는 건 아닙니다.
받은 데이터를 처리하고 알림을 보내는 작업은 연결할 시스템에서도 설정해야 해요.

플러그에서는 의뢰와 견적서 수정에 대한 트리거를 설정할 수 있어요.
계약·정산 변경 알림이 필요하다면 웹훅 대신 오픈 API로 주기적으로 조회하는 방식을 검토해주세요.

✅ 웹훅 연결 시작하기

비즈니스 설정 → 웹훅 & API → 웹훅 탭

1. 데이터를 받을 시스템에서 수신 URL을 준비해주세요.
2. [생성하기]를 누르고 웹훅 이름과 수신 URL을 저장하세요.
3. 토큰 아래에서 필요한 트리거를 선택하세요.

🔗 웹훅 설정 가이드 보기

2. “의뢰 목록을 시트로 가져오고 싶어요” 👉 오픈 API

플러그의 의뢰 목록을 구글시트에서 분석하거나, 사내 대시보드에 플러그 데이터를 함께 보여주고 싶을 때는 오픈 API를 활용할 수 있어요.

연결한 프로그램이 플러그에 데이터를 요청하고, 받은 내용을 필요한 형태로 정리하는 방식이에요.
버튼을 눌렀을 때 가져오도록 만들 수도 있고, 정해진 주기로 갱신하도록 구성할 수도 있어요.

웹훅과의 차이는 누가 먼저 요청하느냐입니다.

필요한 일	활용 방식
설정한 이벤트가 발생했을 때 데이터를 받고 싶다	웹훅: 플러그가 먼저 보내줘요
원하는 시점에 필요한 데이터를 조회하고 싶다	오픈 API: 연결한 프로그램이 요청해요

✅ 오픈 API 연결 시작하기

비즈니스 설정 → 웹훅 & API → 오픈 API 탭

키를 발급받고 API Key와 Secret Key를 안전한 곳에 보관해주세요.
Secret Key는 발급 직후 한 번만 표시돼요.

구글시트 연결을 처음 시도한다면 아래 실습 글을 참고해보세요.
실행 버튼을 눌러 지정한 기간의 의뢰 목록을 가져오는 예제예요.

🔗 개발 1도 모르는데, API 한번 써봤어요

반복해서 사용할 때는 세 가지를 확인해주세요.

1. 중복 방지: 이미 가져온 의뢰는 다시 추가되지 않게 처리해요.
2. 전체 목록 조회: 결과가 여러 페이지로 나뉘면 다음 페이지까지 가져와요.
3. 예약 실행: 매일 자동으로 가져오려면 실행 주기를 별도로 설정해요.

다른 연동을 만들고 싶다면 플러그 개발자 문서를 AI 도구에 전달하고, 어떤 데이터를 어디로 가져와 무엇을 하고 싶은지 구체적으로 설명해보세요.
외부 서비스의 API 문서도 함께 제공하면 도움이 됩니다.

3. “AI에게 최근 의뢰를 물어보고 싶어요” 👉 MCP

Claude Desktop이나 Cursor 같은 AI 도구에서 플러그 데이터를 조회하는 방법도 있어요.
MCP(Model Context Protocol)를 통해 연결하면 됩니다.

연결을 마치면 AI 도구 안에서 이렇게 요청할 수 있어요.

💬 연결 후 이렇게 물어보세요

“내 비즈니스의 최근 의뢰 5건 보여줘.”

“ABC 회사의 계약 상세 알려줘.”

AI가 요청에 필요한 플러그 도구를 호출하고, 조회한 결과를 대화 안에서 보여줘요.
플러그 화면을 오가며 찾던 정보를 AI와 대화하면서 확인할 수 있는 거죠.

MCP는 AI가 플러그 API를 사용할 수 있도록 연결해주는 방식이에요.
조회뿐 아니라 Todo 생성처럼 데이터를 바꾸는 도구도 있으니, 사용할 도구와 권한을 먼저 확인해주세요.

✅ MCP 연결 시작하기

공식 자동 설치 환경: macOS의 Claude Desktop

1. API Key와 Secret Key를 발급받으세요.
2. 설치 가이드에 따라 키를 설정하고 설치를 완료하세요.
3. Claude Desktop을 완전히 종료한 뒤 다시 실행하세요.

첫 요청은 “최근 의뢰 5건 보여줘”처럼 조회부터 시작하면 됩니다.

🔗 MCP 설치 가이드 보기
Cursor 등 다른 MCP 클라이언트는 공식 저장소의 등록 안내를 참고해주세요.
Windows·Linux에서의 이용은 공식 지원 안내를 확인한 뒤 진행해주세요.

✅ 연결 전에 확인해주세요

오픈 API는 비즈니스 설정에서 키를 발급받아 시작할 수 있어요.
필요한 데이터나 작업이 제공되는지는 개발자 문서에서 확인해주세요.
설정 메뉴를 찾기 어렵거나 필요한 도구를 사용할 수 없다면, 상담 채널에 연결하려는 업무를 알려주세요.
연결할 AI 도구나 외부 서비스의 이용료는 해당 서비스 정책에 따라 달라질 수 있어요.

🔑 키는 실행 환경에 직접 설정해주세요

플러그 API 요청은 API Key와 시크릿 키 기반 서명으로 인증해요.
실제 키는 AI 대화에 붙여넣지 마세요.
키가 담긴 설정 파일과 스크린샷도 공유하지 않도록 주의해주세요.

반복하는 작업 하나부터 줄여보세요

세 가지를 한꺼번에 연결할 필요는 없어요.
견적서 변경 여부를 계속 확인하고 있다면 웹훅부터, 의뢰 목록을 시트로 옮겨 적고 있다면 오픈 API부터 시작해보세요.
AI를 쓰면서 플러그 데이터도 확인하고 싶을 때는 MCP를 연결하면 되고요.

다음 편에서도 플러그에서 반복하는 수작업 하나를 줄이는 방법을 소개해드릴게요.

어떤 방식이 맞는지 모르겠거나 설정 중 막히셨다면, 플러그 홈페이지 우측 하단 상담 채널에 말씀해주세요.
어떤 데이터를 어떤 도구에 연결하고 싶은지 알려주시면, 가능한 연동 방식과 설정 방법을 안내해드릴게요.

👀 플러그 웹훅·오픈 API가 더 궁금하다면?