[클로드 시리즈_42] API/Agent/Sub-agent 개념 — [01] API가 무엇인가요?

1. API란 무엇인가요?

API는 쉽게 말하면 프로그램끼리 서로 대화할 수 있게 해주는 연결 창구입니다.

API는 영어로 Application Programming Interface의 줄임말입니다.

어렵게 들리지만, 초보자 입장에서는 이렇게 이해하면 충분합니다.

API = 프로그램끼리 서로 대화하는 연결 창구

 

예를 들어 날씨 앱을 생각해 보겠습니다.

휴대폰의 날씨 앱이 직접 하늘을 보고 온도와 습도를 측정하는 것은 아닙니다.
대신 날씨 정보를 가진 서비스에 요청합니다.

“서울의 오늘 날씨를 알려줘.”

 

그러면 날씨 서비스가 응답합니다.

“서울 현재 기온은 22도이고, 오후에는 비가 올 가능성이 있습니다.”

 

이 요청과 응답이 오가는 통로가 API입니다.

날씨 앱을 예로 들며, 날씨 앱이 직접 날씨를 측정하는 것이 아니라 날씨 서비스에 “서울의 오늘 날씨를 알려줘”라고 요청하고 결과를 받아 화면에 보여 준다고 설명합니다. 이때 날씨 정보를 요청하고 받아오는 통로가 API입니다.

---

2. 왜 API가 필요한가요?

우리가 어떤 서비스를 만들 때 모든 기능을 직접 만들 필요는 없습니다.

예를 들어 쇼핑몰을 만든다고 해 보겠습니다.

쇼핑몰에는 여러 기능이 필요합니다.

결제
지도
로그인
배송 조회
번역
문자 발송
알림톡
상품 추천

 

이 기능을 모두 직접 개발하려면 시간이 오래 걸립니다.
돈도 많이 들고, 보안 문제도 커집니다.

그래서 이미 잘 만들어진 외부 서비스를 빌려 씁니다.

필요한 기능	직접 만들면	API를 쓰면
결제	카드사·보안·정산 시스템 개발 필요	결제 API 연결
지도	지도 데이터와 위치 시스템 필요	지도 API 연결
로그인	회원 인증과 보안 관리 필요	소셜 로그인 API 연결
배송 조회	택배사별 조회 시스템 필요	배송 조회 API 연결
번역	번역 엔진 개발 필요	번역 API 연결

쇼핑몰을 만들 때 결제 시스템, 지도, 로그인, 배송 조회, 번역 기능을 전부 직접 개발할 필요가 없고, 이미 만들어진 외부 서비스의 기능을 API를 통해 빌려 쓸 수 있다고 설명합니다.

핵심은 이것입니다.

API는 남이 잘 만들어 둔 기능을 내 서비스 안에서 사용할 수 있게 해 주는 연결 방식입니다.

---

3. API는 어떻게 이해하면 쉬울까요? — 식당 비유

API는 식당을 떠올리면 쉽습니다.

식당에 가면 손님이 주방에 직접 들어가서 요리하지 않습니다.
손님은 직원에게 주문합니다.

“김치찌개 하나 주세요.”

 

그러면 직원이 주방에 주문을 전달합니다.
주방은 음식을 만들고, 직원은 다시 손님에게 음식을 가져다줍니다.

API를 식당 직원에 비유합니다. 손님은 주방에 직접 들어가서 요리하지 않고, 직원에게 메뉴를 주문합니다. 직원은 주방에 주문을 전달하고, 주방은 음식을 만들어 다시 손님에게 전달합니다. 여기서 API는 직원 역할을 합니다.

이 비유를 표로 정리하면 다음과 같습니다.

식당 비유	실제 API 구조
손님	내 서비스 또는 앱
직원	API
주방	외부 서비스
메뉴판	API 문서
주문	요청 Request
음식	응답 Response

즉, API는 중간에서 요청을 전달하고 결과를 가져오는 역할을 합니다.

내 서비스가 요청
→ API가 외부 서비스에 전달
→ 외부 서비스가 결과 생성
→ API가 결과를 다시 가져옴

 

---

4. API 요청과 응답은 어떻게 생겼나요?

API는 기본적으로 요청과 응답의 구조로 움직입니다.

요청 Request
→ 처리
→ 응답 Response

 

예를 들어 날씨 API에 이렇게 요청한다고 가정해 보겠습니다.

서울의 오늘 날씨를 알려줘.

 

프로그램은 실제로는 이런 식의 주소로 요청할 수 있습니다.

/weather?city=Seoul&date=today

 

그러면 API는 이런 정보를 돌려줄 수 있습니다.

{
  "city": "Seoul",
  "temperature": 22,
  "weather": "rain",
  "humidity": 70
}

 

사람이 보기에는 낯설지만, 프로그램은 이런 구조화된 데이터를 잘 이해합니다.

그 결과를 앱 화면에서는 이렇게 보여 줍니다.

서울 현재 기온 22도
오후 비 가능성 있음
습도 70%

 

---

5. 실제로 API는 어디에 쓰이나요?

API는 이미 우리 생활 곳곳에 쓰이고 있습니다.

1) 날씨 앱

날씨 앱은 직접 날씨를 측정하지 않습니다.
날씨 제공 서비스의 API를 통해 데이터를 받아옵니다.

서울 날씨 요청
→ 날씨 API 응답
→ 앱 화면에 표시

 

날씨 앱은 직접 날씨를 측정하지 않고, 날씨 서비스에 요청해 결과를 받아 화면에 보여 준다고 설명합니다.

---

2) 지도 앱

배달 앱에서 식당 위치를 보여 줄 때 지도 API를 사용합니다.

식당 주소 입력
→ 지도 API가 좌표 반환
→ 지도에 위치 표시

 

---

3) 결제 시스템

쇼핑몰에서 카드 결제를 할 때 쇼핑몰이 직접 카드사 시스템을 만들지 않습니다.

결제 요청
→ 결제 API
→ 카드사 승인
→ 결제 완료 결과 반환

 

---

4) 소셜 로그인

“Google로 로그인”, “카카오로 로그인”, “네이버로 로그인”도 API를 사용합니다.

사용자가 Google 로그인 클릭
→ Google 인증 API 호출
→ 사용자 확인
→ 로그인 완료

 

---

5) 배송 조회

쇼핑몰에서 “배송 조회” 버튼을 누르면 택배사 API를 통해 현재 위치를 받아옵니다.

운송장 번호 입력
→ 택배사 API 요청
→ 현재 배송 상태 응답

 

---

6) 번역 기능

앱 안에서 번역 기능을 제공할 때 번역 엔진을 직접 만들지 않고 번역 API를 사용합니다.

한국어 문장 입력
→ 번역 API 요청
→ 영어 번역 결과 반환

 

---

6. API는 ‘기능을 빌려 쓰는 방법’입니다

API의 핵심은 직접 만들지 않고 연결해서 쓰는 것입니다.

예를 들어 작은 회사가 쇼핑몰을 만든다고 해도 모든 기능을 직접 만들 수는 없습니다.

결제는 결제 전문 회사 API
지도는 지도 서비스 API
로그인은 Google·Kakao API
배송 조회는 택배사 API
문자 발송은 문자 API

 

이렇게 연결하면 훨씬 빠르게 서비스를 만들 수 있습니다.

비유하면 이렇습니다.

직접 개발	직접 개발
집을 처음부터 직접 짓기	이미 있는 시설을 연결해서 쓰기
직접 요리 재료 생산	식당에서 메뉴 주문
모든 직원을 직접 채용	전문 업체에 일부 업무 맡기기
모든 기능 자체 개발	외부 기능을 연결해 사용

API는 현대 서비스 개발의 기본입니다.

---

7. API와 Claude는 어떤 관계가 있나요?

Claude 같은 AI가 외부 데이터를 활용하려면 연결 통로가 필요합니다.

예를 들어 Claude에게 이렇게 시킨다고 해 보겠습니다.

공공데이터에서 제주 관광지 정보를 가져와서 표로 정리해 줘.

 

Claude가 실제 공공데이터를 가져오려면 데이터가 있는 곳에 접근해야 합니다.

그때 사용할 수 있는 방법 중 하나가 API입니다.

Claude
→ API 요청
→ 공공데이터 응답
→ Claude가 정리
→ 보고서 생성

 

즉, API는 AI가 외부 데이터를 가져오는 길입니다.

---

8. API와 커넥터, MCP는 어떻게 연결되나요?

앞선 글에서 우리는 커넥터와 MCP를 배웠습니다.

정리하면 다음과 같습니다.

개념	쉬운 설명
API	프로그램끼리 대화하는 연결 창구
커넥터	Claude에서 바로 쓸 수 있게 만든 완성형 연결 기능
MCP	AI와 외부 시스템을 연결하는 표준 규격
Agent	목표를 받아 일을 끝까지 처리하는 AI 실무자
Sub-agent	Agent가 부르는 전문 담당자

조금 더 쉽게 비유하면 이렇습니다.

API = 식당 직원이 주문을 전달하는 통로
커넥터 = Claude에 이미 설치된 외부 서비스 연결 버튼
MCP = 여러 도구를 같은 방식으로 연결하기 위한 표준 규격
Agent = 일을 맡아서 처리하는 AI 직원
Sub-agent = 특정 업무만 맡는 전문 담당자

 

API는 가장 기본적인 연결 개념입니다.
MCP와 커넥터는 AI 시대에 API 연결을 더 쉽게 쓰기 위한 방식으로 이해할 수 있습니다.

---

9. API와 Agent는 어떻게 다를까요?

API와 Agent는 다릅니다.

API는 통로입니다.
Agent는 일을 수행하는 주체입니다.

구분	API	Agent
역할	연결 통로	업무 수행자
비유	식당 직원	일을 맡은 AI 직원
하는 일	요청 전달, 결과 반환	목표 이해, 계획, 실행, 결과 정리
예시	날씨 데이터 요청	날씨 데이터를 분석해 보고서 작성

예를 들어 이렇게 요청할 수 있습니다.

제주 관광 데이터를 가져와서 여행 코스를 만들어 줘.

 

이때 내부 흐름은 이렇게 나눌 수 있습니다.

Agent: 전체 목표를 이해하고 계획함
API: 관광 데이터와 날씨 데이터를 가져오는 통로
Agent: 가져온 데이터를 분석하고 코스를 작성함

 

즉, API는 Agent가 일할 때 사용하는 도구 중 하나입니다.

---

10. API와 Sub-agent는 어떻게 연결되나요?

Sub-agent는 Agent가 일을 나눠 맡기는 전문 담당자입니다.

예를 들어 부동산 데이터 분석을 한다고 해 보겠습니다.

마포구 상업용 부동산 실거래 데이터를 가져오고,
거래금액, 평당가, 건물 연식, 거래량을 계산한 뒤,
가격이 오를지 내릴지 판단해서 보고서로 정리해 줘.

 

이 일은 하나의 작업처럼 보이지만 실제로는 여러 단계입니다.

데이터 가져오기
숫자 정리하기
평당가 계산하기
지역 비교하기
보고서 작성하기

 

첨부 글의 Agent/Subagent 부분에서도 Agent를 “일을 맡아서 처리하는 AI 직원”, Subagent를 “Agent가 부르는 전문 담당자”로 설명합니다. 메인 Agent가 부동산 리서치 팀장이라면, Subagent는 데이터 수집 담당, 데이터 정리 담당, 가격 계산 담당, 지역 비교 담당, 전망 보고서 작성 담당처럼 나뉩니다.

여기서 API는 주로 데이터 수집 담당 Sub-agent가 사용합니다.

데이터 수집 Sub-agent
→ 공공데이터 API 호출
→ 실거래 데이터 가져오기
→ 메인 Agent에게 전달

 

---

11. API를 이해하면 AI 자동화가 쉬워집니다

AI 자동화를 제대로 이해하려면 API 개념이 중요합니다.

왜냐하면 AI가 실제 업무를 하려면 대화창 안에만 머물러서는 안 되기 때문입니다.

실제 업무 데이터는 외부에 있습니다.

메일은 Gmail에 있음
파일은 Google Drive에 있음
고객 정보는 CRM에 있음
일정은 Calendar에 있음
데이터는 공공데이터포털에 있음
결제 정보는 결제 시스템에 있음

 

AI가 이런 데이터를 활용하려면 연결이 필요합니다.
그 연결의 기본 개념이 API입니다.

즉, API를 이해하면 다음 개념도 쉬워집니다.

커넥터
MCP
Agent
Sub-agent
자동화 워크플로우
공공데이터 활용
Claude Code 실습

 

---

12. 실무 예시 — 공공데이터 API

첨부 글 다음 장은 공공데이터포털 API 사용하기로 이어집니다.

공공데이터포털은 정부와 공공기관이 가진 데이터를 모아 둔 인터넷 자료 창고입니다. 교통 정보, 날씨 정보, 병원 정보, 약국 정보, 관광지 정보, 버스 도착 정보, 미세먼지 정보, 부동산 정보, 인구 통계 같은 데이터를 국민이나 기업, 개발자가 활용할 수 있도록 공개한 곳입니다.

이 설명은 API를 이해하는 데 매우 좋습니다.

예를 들어 이런 업무를 할 수 있습니다.

공공데이터포털에서 제주 관광지 데이터를 가져와
관광지명, 주소, 운영시간, 주차 여부를 표로 정리해 줘.

 

또는 이렇게 요청할 수 있습니다.

공공데이터포털의 미세먼지 API를 사용해
제주 지역의 최근 7일 미세먼지 추이를 정리하고
블로그 글 초안으로 작성해 줘.

 

이때 API는 데이터를 가져오는 통로입니다.
Claude나 Agent는 가져온 데이터를 해석하고 보고서로 정리하는 역할을 합니다.

---

13. API를 처음 배울 때 헷갈리는 용어

API를 배우다 보면 낯선 용어가 나옵니다.

초보자 입장에서는 아래 정도만 이해해도 충분합니다.

용어	쉬운 설명
요청 Request	“이 정보 주세요”라고 보내는 것
응답 Response	요청에 대한 결과
엔드포인트 Endpoint	요청을 보내는 주소
파라미터 Parameter	요청할 때 붙이는 조건
API Key	API를 사용할 수 있는 열쇠
JSON	프로그램이 읽기 쉬운 데이터 형식
인증 Authentication	누가 요청하는지 확인하는 절차

예를 들어 날씨 API를 요청할 때는 이렇게 생각하면 됩니다.

엔드포인트: 날씨 정보를 받는 주소
파라미터: 도시=서울, 날짜=오늘
API Key: 내가 허가받은 사용자라는 증명
응답: 온도, 습도, 날씨 상태

 

---

14. API Key는 비밀번호처럼 다뤄야 합니다

API를 사용하려면 API Key가 필요한 경우가 많습니다.

API Key는 쉽게 말해 서비스 이용 열쇠입니다.

API Key = 이 사람이 API를 사용할 권한이 있는지 확인하는 열쇠

 

따라서 API Key는 절대 공개하면 안 됩니다.

주의해야 할 곳은 다음과 같습니다.

블로그 글에 API Key 노출 금지
강의자료 화면에 API Key 노출 금지
GitHub 공개 저장소에 API Key 업로드 금지
카카오톡 단체방에 API Key 공유 금지
스크린샷에 API Key 노출 금지

 

좋은 원칙은 이것입니다.

API Key는 비밀번호처럼 다루고, 공개 자료에서는 반드시 가립니다.

---

15. 강의용 설명 스크립트

아래는 강의에서 그대로 읽어도 되는 설명문입니다.

여러분, API는 어렵게 생각하지 않으셔도 됩니다.

API는 프로그램끼리 대화하는 연결 창구입니다.

사람은 말로 요청하죠.
“오늘 날씨 알려줘.”
“택배 어디쯤 왔어?”
“이 주소 지도에서 찾아줘.”

그런데 프로그램은 사람 말이 아니라 정해진 규칙으로 요청합니다.
그 규칙이 API입니다.

식당으로 비유하면 더 쉽습니다.

손님이 주방에 직접 들어가서 요리하지 않죠.
직원에게 주문합니다.

“김치찌개 하나 주세요.”

그러면 직원이 주방에 전달하고,
주방은 음식을 만들고,
직원은 다시 손님에게 가져다줍니다.

여기서 직원 역할이 API입니다.

내 서비스가 원하는 것을 요청하면,
API가 다른 서비스에 전달하고,
결과를 다시 가져와 줍니다.

그래서 우리가 쇼핑몰을 만들 때
결제, 지도, 로그인, 배송 조회를 전부 직접 만들 필요가 없습니다.

이미 잘 만들어진 외부 기능을 API로 빌려 쓰면 됩니다.

앞으로 Agent와 Sub-agent를 배울 때도 이 개념이 중요합니다.
Agent가 일을 처리하려면 외부 데이터가 필요하고,
그 데이터를 가져오는 통로 중 하나가 바로 API입니다.

 

---

16. 실습 프롬프트 — API 개념 설명 자료 만들기

1) 초보자용 API 설명 요청

API를 초등학생도 이해할 수 있게 설명해 주세요.

조건:
1. 식당 주문 비유를 사용해 주세요.
2. 손님, 직원, 주방을 API 구조와 연결해 주세요.
3. 날씨 앱 예시를 포함해 주세요.
4. 마지막에 한 줄 요약을 넣어 주세요.

 

---

2) API와 커넥터 차이 설명 요청

API와 Claude 커넥터의 차이를 표로 설명해 주세요.

대상은 비개발자 실무자입니다.

비유:
- API는 프로그램끼리 대화하는 통로
- 커넥터는 Claude에서 바로 쓸 수 있게 만들어진 완성형 연결 기능

예시는 Gmail, Google Drive, 공공데이터포털을 사용해 주세요.

 

---

3) 쇼핑몰 API 예시 만들기

쇼핑몰을 예로 들어 API가 어디에 쓰이는지 설명해 주세요.

포함할 기능:
1. 결제
2. 지도
3. 로그인
4. 배송 조회
5. 번역

각 기능마다 “직접 만들면 어려운 점”과 “API를 쓰면 좋은 점”을 표로 정리해 주세요.

 

---

4) Agent와 API 관계 설명 요청

Agent와 API의 차이를 초보자도 이해할 수 있게 설명해 주세요.

조건:
1. Agent는 일을 맡아 처리하는 AI 직원으로 설명
2. API는 외부 기능과 데이터를 가져오는 연결 창구로 설명
3. 부동산 데이터 분석 예시를 사용
4. Agent, Sub-agent, API의 역할을 표로 정리

 

---

5) 강의용 5분 스크립트 작성 요청

“API가 무엇인가요?”라는 주제로 5분 강의 스크립트를 작성해 주세요.

대상:
비개발자 실무자

구성:
1. API 한 줄 정의
2. 왜 API가 필요한가
3. 식당 비유
4. 날씨 앱 예시
5. Claude Agent 자동화와의 연결
6. 핵심 정리

 

---

17. Q&A — 자주 묻는 질문 5가지

Q1. API는 개발자만 알아야 하나요?

아닙니다. 직접 코딩하지 않더라도 API의 개념은 알아두는 것이 좋습니다. AI 자동화, 커넥터, MCP, Agent를 이해하려면 “외부 시스템과 연결한다”는 개념이 필요하기 때문입니다.

---

Q2. API와 웹사이트는 무엇이 다른가요?

웹사이트는 사람이 보기 위한 화면입니다. API는 프로그램이 데이터를 주고받기 위한 통로입니다. 사람은 웹사이트에서 버튼을 누르고 내용을 읽지만, 프로그램은 API를 통해 정해진 형식으로 요청하고 응답을 받습니다.

---

Q3. API를 쓰면 모든 데이터를 마음대로 가져올 수 있나요?

아닙니다. API를 제공하는 기관이나 회사가 허용한 범위 안에서만 사용할 수 있습니다. API Key, 인증, 사용량 제한, 요금 정책이 있을 수 있습니다. 공개 데이터라고 해도 이용 조건을 확인해야 합니다.

---

Q4. API와 MCP는 같은 것인가요?

같지 않습니다. API는 프로그램끼리 데이터를 주고받는 일반적인 연결 방식입니다. MCP는 AI 애플리케이션이 외부 도구와 데이터를 더 표준화된 방식으로 연결하기 위한 규격입니다. 쉽게 말하면 API는 연결 창구이고, MCP는 AI 시대의 연결 표준에 가깝습니다.

---

Q5. API를 이해하면 Claude Code를 더 잘 쓸 수 있나요?

네. Claude Code나 AI Agent가 외부 데이터를 가져와 분석하거나 보고서를 만들 때 API 개념이 자주 등장합니다. 예를 들어 공공데이터 API를 연결해 부동산 데이터, 날씨 데이터, 관광지 데이터를 가져오고, Claude가 이를 분석해 보고서로 정리할 수 있습니다.

---

18. 핵심 정리

API는 프로그램끼리 서로 대화할 수 있게 해 주는 연결 창구입니다.

우리가 쇼핑몰을 만들 때 결제, 지도, 로그인, 배송 조회, 번역 기능을 모두 직접 만들 필요가 없는 이유는 API로 이미 만들어진 외부 기능을 빌려 쓸 수 있기 때문입니다.

API는 식당 직원과 같습니다.

손님 = 내 서비스
직원 = API
주방 = 외부 서비스
주문 = 요청
음식 = 응답

 

날씨 앱은 직접 날씨를 측정하지 않습니다.
날씨 서비스 API에 요청하고, 결과를 받아 화면에 보여 줍니다.

AI 시대에는 API가 더 중요해집니다.

Claude, Agent, Sub-agent가 외부 데이터를 가져오고 실제 업무를 처리하려면 API 같은 연결 통로가 필요하기 때문입니다.

마지막으로 이 문장을 기억하면 됩니다.

API는 프로그램끼리 일하게 만드는 연결 창구이고, AI Agent가 외부 세상과 일하기 위한 기본 통로입니다.

---

작성자 프로필

강호종 AI 길라잡이 강사

생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사 & AI 전문강사, 젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서: 『생성형 AI 활용 업무혁신』(2026.1) · 『이것이 GEO마케팅이다』(2026) 외
📞 010-9912-9934 | 📧 art386@naver.com | Ⓑ blog.naver.com/art386 | Ⓣ aiart386.tistory.com

​생성형 AI, AI 리터러시, ChatGPT·Claude·Gemini 실무 활용, AI 업무 자동화, GEO마케팅을 중심으로 공공기관·기업·단체 대상 강의와 콘텐츠를 제작합니다.

---

메타 설명

API 개념을 비개발자도 이해할 수 있게 설명한 글입니다. API를 프로그램끼리 대화하는 연결 창구로 정의하고, 쇼핑몰·날씨 앱·식당 주문 비유를 통해 API와 Claude Agent, MCP, 커넥터의 관계를 쉽게 정리했습니다.

---

해시태그

#클로드시리즈 #ClaudeCode #API #API개념 #Agent #Subagent #MCP #ClaudeCowork #AI업무자동화 #공공데이터API #AI리터러시 #생성형AI강의 #AI강사 #강호종강사 #AI길라잡이 #ChatGPT활용 #Claude활용 #GEO마케팅 #AX전환 #노코드자동화