Terms of Service·Privacy Policy

© 2026 DocuRise by Risecraft, LLC. All rights reserved.

Powered by DocuRise
Click anywhere on the document to leave a comment. Only you and 아이린 can see your comments.

자료집 by 아이린 | 사업하는 개발자

API · MCP · Skill,
대체 뭘 언제 써야 하죠?

API프로그램 ↔ 프로그램
MCPAI 앱 ↔ 외부 도구
SkillAI ← 우리 업무 기준

여기서 시작하세요

지금 어떤 상황이세요?

상황 1

AI에게 줄 자료를 매번 찾아서 복사·붙여넣기 하고 있어요

답은 MCP · AI가 내 문서와 도구를 직접 보게 하는 방법 →

상황 2

AI 답변이 매번 달라서, 같은 수정 요청을 계속 반복해요

답은 Skill · 우리 업무 기준을 한 번만 정리해두는 방법 →

상황 3

서비스끼리 데이터를 손으로 옮기고 있어요

답은 API · 프로그램끼리 알아서 주고받게 하는 방법 →

상황 4

AI에게 어디까지 맡겨도 될지 불안해요

답은 안전 체크리스트 · 권한을 단계적으로 여는 방법 →

상황 5

뭐부터 시작해야 할지 모르겠어요

답은 시작점 고르기 · 질문 네 개로 내 출발점 찾기 →

상황 6

셋이 뭐가 다른지부터 헷갈려요

답은 한눈에 보기 · 비유로 3분 만에 정리 →

DocuRise 실제 예시 대화 바로 보기 →내 업무에 적용하는 템플릿 →자주 묻는 질문 →

안녕하세요, 아이린입니다.

AI 도구를 쓰다 보면 새로운 기능을 익히는 것보다 “지금 내 문제에 무엇이 필요한지” 판단하는 게 더 어려울 때가 있어요. 이 자료집은 공식 문서를 바탕으로 세 개념을 정리하고, 제가 만들고 있는 DocuRise에서는 실제로 어떻게 쓰이는지 예시로 보여드려요.

아이린 | 사업하는 개발자

전체 목차

01
API·MCP·Skill 한눈에 보기
02
왜 세 개념을 구분해야 할까?
03
API: 프로그램이 서비스의 기능을 사용할 때
04
MCP: AI가 외부 정보와 도구를 활용할 때
05
Skill: AI가 정해진 방식으로 일하게 할 때
06
같은 문제를 세 가지 방식으로 풀어보기
07
API·MCP·Skill을 함께 쓰는 방법
08
내 상황에 맞는 시작점 고르기
09
연결하기 전 안전 체크리스트
10
DocuRise에 대입해보면
11
나의 첫 AI 업무 흐름 설계하기
12
자주 묻는 질문

01 · 한눈에 보기

셋은 서로 다른
종류의 도구예요.

먼저 짧게 정리하면 이렇습니다. 각각 해결하는 문제가 달라요.

AI 팀원을 중심으로 MCP는 출입증, Skill은 업무 매뉴얼, API는 시스템 배선 역할을 하는 모습

AI 팀원이 일하려면, 자료를 볼 출입증과 일하는 기준, 뒤에서 이어주는 배선이 필요해요.

API

다른 프로그램이 서비스의 데이터나 기능을 사용할 수 있게 하는 인터페이스

비유하면 시스템과 시스템 사이의 배선

MCP

AI 앱이 외부 정보와 도구에 연결할 수 있도록 돕는 표준 방식

비유하면 AI에게 주는 사내 시스템 출입증

Skill

AI가 특정 작업을 수행할 때 참고하는 재사용 가능한 업무 지침과 관련 자료

비유하면 AI용 업무 매뉴얼

비유는 이해를 돕기 위한 것이고, 실제 동작은 도구마다 달라요.

질문으로 바꿔보면

내 앱이 다른 서비스의 기능을 쓰게 하려면?
API →
AI가 외부 자료와 도구에 접근하게 하려면?
MCP →
AI가 정해진 순서와 기준에 따라 일하게 하려면?
Skill →

AI를 새로 합류한 팀원이라고 생각해보세요

새 팀원이 일을 시작하려면 세 가지가 필요해요. DocuRise에 대입하면 이렇게 돼요.

MCP
출입증. 사내 문서와 도구를 볼 수 있어요.
예: AI가 내 DocuRise 문서 목록과 조회 현황을 읽을 수 있게 연결
Skill
업무 매뉴얼. 우리 팀이 일하는 순서와 기준이에요.
예: “대화에서 먼저 보여주고, 내가 확인하면 공개한다”
API
배선. 시스템끼리 데이터를 주고받아요. 팀원이 있든 없든 뒤에서 돌아가요.
예: 내 서비스의 업무 흐름에 외부 서비스를 붙일 때

각각의 역할

API

해결하는 문제 프로그램 간 기능·데이터 사용
사용자 서비스 개발자, 자동화 담당자
예시 내 앱에서 결제 서비스 사용
AI가 꼭 필요한가? 아니요

MCP

해결하는 문제 AI 앱의 외부 도구·정보 접근
사용자 AI 앱을 활용하는 개인·팀
예시 AI가 연결된 문서에서 정보 찾기
AI가 꼭 필요한가? AI 앱을 위한 연결 방식

Skill

해결하는 문제 AI 작업 방식의 재사용
사용자 반복 업무를 AI에 맡기는 개인·팀
예시 답변 작성 절차와 검토 기준 적용
AI가 꼭 필요한가? 보통 AI 작업을 위해 사용

중요

“API보다 MCP가 최신이니까 더 좋다”거나 “Skill이 있으면 MCP가 필요 없다”고 단순 비교할 수 없어요. 셋 중 하나만으로 충분한지는 업무에 따라 달라요.

상황 다시 고르기 ↑전체 목차 ↑다음: 왜 구분해야 할까 →

02 · 왜 구분해야 할까

막히는 곳이
하나가 아니에요.

고객 문의 대응을 AI로 개선하고 싶다고 해볼게요. 아래 흐름에서, 단계를 눌러 어디가 막히는지 확인해보세요.

고객 문의가 접수되어 사람이 발송하기까지 API, MCP, Skill이 순서대로 쓰이는 흐름

문의 하나가 지나가는 길. 점이 움직이는 순서대로 쓰이는 도구가 달라져요.

단계 1문의 접수·확인API 단계 2도움말 찾기MCP 단계 3답변 작성Skill 단계 4검토·발송사람

문제 A. 문의가 여러 곳에 흩어져 있다

웹사이트, 이메일, 고객 관리 도구의 정보가 서로 연결되지 않아 같은 내용을 여러 번 옮겨 적습니다. 서비스 간 연결을 살펴봐야 해요. 이때 API가 쓰일 수 있습니다.

문제 B. AI가 필요한 정보를 모른다

AI에게 답변을 부탁했는데, 최신 도움말이나 제품 정보를 알지 못합니다. AI가 필요한 정보에 접근하는 방식을 살펴봐야 해요. 이때 MCP가 쓰일 수 있습니다.

문제 C. AI 답변이 매번 다르다

필요한 정보는 줬지만, 어떤 때는 장황하고 어떤 때는 없는 내용을 만들어냅니다. 답변을 만드는 기준과 확인 절차를 정리해야 해요. 이때 Skill이 도움이 될 수 있습니다.

어떤 도구를 써도 사람이 남는 단계

답변이 적절한지 확인하고 보내는 일은 사람의 판단이 필요한 경우가 많아요. 지침에 “초안으로만 작성”이라는 기준을 넣고, 발송은 담당자가 하도록 남겨둘 수 있어요.

지금 내 업무에서 가장 자주 막히는 부분은 어디인가?

좋은 시작은 새로운 도구를 추가하는 것이 아니라, 이 질문에 답하는 것입니다.

상황 다시 고르기 ↑전체 목차 ↑다음: API →

03 · API

프로그램끼리
대화하는 약속이에요.

이런 문제가 있다면, 이 섹션이 답이에요

▸ 신청 폼 내용을 매번 다른 도구에 복사해 넣어요
▸ 결제·회원 같은 기능을 내 서비스에 붙이고 싶어요
▸ 여러 도구에 흩어진 데이터를 한곳에 모으고 싶어요

해당되지 않나요? 상황 다시 고르기 ↑

API는 한 프로그램이 다른 프로그램의 데이터나 기능을 정해진 방식으로 사용할 수 있게 만든 인터페이스예요. 사람은 화면에서 버튼을 누르고, 프로그램은 API에 요청을 보냅니다.

내 프로그램이 서비스 API에 요청을 보내고 응답을 받는 모습

내가 먼저 요청하고, 서비스가 결과를 돌려줘요.

예를 들어 내 웹사이트에서 결제 기능을 제공하고 싶다면, 결제 기능 전체를 직접 만들지 않고 결제 서비스의 API를 이용할 수 있어요. API는 단순한 데이터 통로가 아니라, 다른 서비스의 기능을 내 제품이나 업무 흐름에서 쓰게 하는 접점이에요.

요청과 응답 예시 (형식은 서비스마다 달라요)

요청 GET /orders/1042 응답 { "order_id": 1042, "status": "배송 준비 중" }

API로 할 수 있는 일

조회
정보나 상태를 가져와요
상품 정보 조회, 주문 상태 확인
생성
새로운 데이터를 만들어요
고객 기록 생성, 일정 등록
수정
기존 정보를 바꿔요
고객 상태 변경, 상품 정보 수정
실행
특정 기능을 호출해요
결제 요청, 메시지 발송
연결
여러 요청을 이어 업무 흐름을 만들어요
신청 → 고객 기록 → 후속 안내

자동화와 API

자동화는 API의 한 가지 활용 방식이에요. API 자체가 곧 자동화는 아닙니다. 사용자가 버튼을 눌렀을 때 호출할 수도 있고, 정해진 업무 흐름 안에서 자동으로 호출할 수도 있어요.

이런 상황이라면 API를 살펴보세요

내 웹사이트에 결제 기능 넣기

“내 웹사이트가 결제 서비스의 기능을 어떻게 사용할까?”

신청 정보를 고객 관리 도구에 기록하기

상담 신청 폼의 내용을 복사해 옮기는 대신, 연결된 프로그램이 기록해요. 중요한 건 AI의 창의적인 판단이 아니라 어떤 정보를 어디에 어떤 형식으로 전달할지예요.

내 서비스 안에 다른 서비스의 정보 보여주기

고객 대시보드에 외부 서비스의 주문 상태를 보여줄 수 있어요. 단, 조회할 수 있는 범위는 해당 서비스가 제공하는 API에 달려 있어요.

DocuRise에서는

내 서비스와 DocuRise를 이어 붙이고 싶을 때

내가 만드는 서비스에서 DocuRise를 직접 연결하고 싶다면, 먼저 필요한 기능이 API로 열려 있는지 확인하는 게 출발점이에요. 코딩 없이 AI 앱으로 DocuRise를 쓰고 싶다면 아래 04장의 MCP가 더 가까워요. 지금 바로 해볼 수 있는 건 MCP 연결이에요.

주의 · API 키

일부 API는 요청하는 사람이 누구인지 확인하려고 API 키 같은 비밀 정보를 사용해요. 공개 저장소, 웹페이지의 공개 코드, 캡처 화면, 채팅에 그대로 넣지 마세요. 서비스마다 인증 방식이 다르니 공식 문서를 확인하세요.

API가 있으면 모든 걸 할 수 있나요?

아니요. 서비스마다 아래 여섯 가지가 달라요.

제공하는 기능접근 가능한 데이터허용된 권한사용량 제한요금요청 형식

“API가 있나?”뿐 아니라 “내가 필요한 기능을 제공하나?”까지 확인해야 해요.

API와 웹훅은 무엇이 다른가요?

API 요청

내 프로그램이 상대 서비스에 정보나 작업을 요청해요.

“이 주문의 현재 상태를 알려줘.”

웹훅

특정 이벤트가 발생했을 때 서비스가 미리 정해둔 주소로 알림을 보내요.

“방금 주문이 완료됐어요.”

내가 먼저 물어보면 API 요청, 상대가 먼저 알려주면 웹훅이에요. 모든 서비스가 원하는 API나 웹훅을 제공하는 것은 아닙니다.

API를 먼저 보면 좋은 사람

직접 서비스나 웹사이트를 만들고 있는 사람 · 결제·회원·고객 관리 같은 기능을 연결하고 싶은 사람 · 여러 도구에 흩어진 데이터를 정리하고 싶은 운영 담당자 · AI 없이도 정확하게 반복되어야 하는 흐름을 만들고 싶은 사람

상황 다시 고르기 ↑전체 목차 ↑다음: MCP →

04 · MCP

AI에게 주는
사내 시스템 출입증이에요.

이런 문제가 있다면, 이 섹션이 답이에요

▸ AI에게 줄 자료를 매번 찾아서 붙여넣어요
▸ AI가 내 문서·일정을 직접 보고 일했으면 해요
▸ 대화만 하는 AI에서 한 단계 더 나아가고 싶어요

해당되지 않나요? 상황 다시 고르기 ↑ · 바로 예시부터 보려면 DocuRise 예시 대화 ↓

MCP는 Model Context Protocol의 줄임말이에요. AI 앱이 외부 정보나 도구에 연결할 수 있도록 돕는 표준 방식입니다.

이런 요청을 한다면

“이번 주 회의 자료를 읽고, 다음 회의 전에 확인해야 할 질문을 정리해줘.”

기존

사람이 전달해요

문서를 찾고, 내용을 복사하고, AI 대화창에 붙여넣고, 다시 설명해요.

MCP 연결 후

AI가 직접 참고해요

MCP를 지원하는 AI 앱과 적절한 MCP 서버를 연결하면, 제공된 정보와 도구를 활용해 작업해요.

내 AI 앱이 MCP를 거쳐 문서, 일정, DocuRise 같은 외부 도구에 닿는 모습

AI 앱이 MCP를 통해 필요한 도구에 닿았다가 결과를 가져와요.

기억하세요

MCP를 연결했다고 AI가 모든 자료에 자동으로 접근하는 것은 아니에요. 실제로 가능한 작업은 이 네 가지에 따라 달라요.

사용하는 AI 앱의 지원 범위 · 연결한 MCP 서버가 제공하는 기능 · 해당 계정에 부여된 권한 · 사용자의 승인 및 서비스 설정

언제 유용할까요?

상황 A

참고 자료를 매번 직접 전달하고 있다

자료가 적을 때는 괜찮지만 문서가 많아지면 그 과정 자체가 일이 돼요. 필요한 자료에 접근할 수 있다면 자료를 기반으로 정리하거나 질문에 답하게 할 수 있어요.

상황 B

AI가 정보를 바탕으로 작업도 해야 한다

연결된 일정으로 회의 준비하기, 프로젝트 문서를 참고해 질문 정리하기처럼요. 단, 실행 가능한 작업은 MCP 서버가 제공하는 기능과 권한에 한정돼요.

상황 C

참고할 맥락이 여러 서비스에 나뉘어 있다

문서, 캘린더, 업무 현황이 따로 있어도 AI 앱이 여러 시스템의 정보를 활용할 수 있어요. 다만 연결된 정보가 항상 정확하거나 최신이라고 가정하면 안 돼요.

DocuRise에 연결하면 이렇게 말할 수 있어요

DocuRise를 AI 앱에 MCP로 연결하면, 자료를 보고 정리하고 공개하는 일을 대화로 맡길 수 있어요. 연결 방법은 DocuRise MCP 가이드에 정리되어 있어요. 아래는 이해를 돕기 위한 예시 대화예요. 숫자와 이름은 가상이에요.

예시 1 · 흩어진 성과를 한눈에 (읽기)

지난주에 어떤 문서가 많이 읽혔는지, 리드는 얼마나 모였는지 정리해줘.

DocuRise 연결 · 문서와 조회 현황 읽기

지난 7일 기준으로 정리했어요.

가장 많이 열린 문서: ① 세미나 안내서 ② 가격 안내 ③ 신청 가이드
새로 모인 신청: 12건 (예시 숫자)

→ MCP 읽기만 하는 작업이라 가장 안전하게 시작할 수 있어요.

예시 2 · 아이디어를 공유할 콘텐츠로 (초안 → 확인 → 공개)

아래 내용을 읽기 쉬운 가이드로 만들어줘. 먼저 대화에서 보여줘.

초안이에요. 마음에 들면 “공개해줘”라고 말해주세요. 고치고 싶은 부분이 있으면 먼저 알려주세요.

좋아, DocuRise 포스트로 공개해줘.

DocuRise 연결 · 포스트 만들기

공개했어요. 독자용 링크와 편집 링크를 알려드릴게요.

→ MCP + 사람의 확인. 공개는 내가 “좋아”라고 한 뒤에만 일어나게 해요.

예시 3 · 신청 폼과 후속 안내까지 이어서

무료 세미나 신청 폼을 만들어줘. 이름과 이메일을 받고 싶어. 제출한 사람에게 보낼 안내 이메일 초안도 만들어줘.

DocuRise 연결 · 폼 만들기 · 후속 안내 초안

신청 폼을 만들고, 안내 이메일은 초안으로 준비했어요. 문구를 확인하신 뒤에 켜주세요.

→ MCP + 사람. 이메일은 초안으로 두고, 켜는 건 사람이 해요.

Instagram 댓글을 받으면 자료를 DM으로

DocuRise에서는 게시물에 키워드 댓글이 달리면 자료 링크를 DM으로 보내는 설정도 대화로 만들 수 있어요. 설정이 한 번 만들어지면 그 뒤로는 사람이 일일이 보내지 않아도 돼요.

Instagram 게시물에 키워드 댓글이 달리면 DocuRise 규칙이 확인하고 DM으로 자료 링크를 보내는 흐름

댓글 하나가 DM으로 이어지는 흐름이에요.

MCP와 API는 무엇이 다른가요?

“무엇이 더 좋으냐”보다 어떤 방식으로 연결하고 누가 그 연결을 사용하느냐에 가까워요.

API 관점

“내 프로그램이 이 서비스에 어떤 요청을 보낼 수 있을까?”

개발자가 정해진 API로 기능을 호출하거나 데이터를 가져와요.

MCP 관점

“내 AI 앱이 이 서비스의 정보와 도구를 어떤 방식으로 쓸 수 있을까?”

AI 앱이 MCP로 제공된 도구와 정보를 사용자 요청에 활용해요.

둘이 함께 쓰이기도 해요

사용자: “이번 주 일정 정리해줘”
↓
AI 앱이 연결된 MCP 도구를 사용
↓
MCP 서버가 필요한 방식으로 서비스에 접근 API
↓
결과를 AI 앱에 전달

서비스 접근에 API가 쓰일 수도 있지만, 모든 MCP 서버가 반드시 API를 쓰는 것은 아니에요. 로컬 파일 등 다른 방식으로 접근하기도 해요.

기억하기

MCP는 API의 상위 버전이나 대체품이 아니에요. API는 프로그램이 기능과 데이터를 쓰는 인터페이스이고, MCP는 AI 앱이 외부 시스템과 연결할 때 쓰는 표준 방식입니다.

연결할 때의 기본 순서

제품마다 메뉴와 인증 방법은 다르지만 판단 순서는 비슷해요.

1
AI 앱이 MCP 연결을 지원하는지 확인해요.
2
연결하려는 서비스가 MCP 서버나 연결 방법을 제공하는지 확인해요.
3
어떤 정보와 기능에 접근하는지 살펴봐요. 읽기만 하는 도구와 쓰기·발송까지 하는 도구를 구분해두면 좋아요.
4
공식 안내에 따라 연결하고, 필요한 권한만 허용해요.
5
민감하지 않은 자료로 읽기 작업부터 시험해요.
6
생성·수정·발송 같은 작업은 실행 전 확인 단계를 둬요.

연결 후에도 결과를 확인하세요. AI가 잘못된 자료를 고르거나 요청을 다르게 해석할 수 있고, 자료 자체가 오래됐을 수도 있어요. DocuRise를 처음 연결한다면 MCP 가이드를 따라가면 돼요.

MCP를 먼저 보면 좋은 사람

AI에게 매번 같은 자료를 복사해서 전달하는 사람 · AI가 문서나 외부 서비스 정보를 참고해 일했으면 하는 사람 · 대화만 하는 AI에서 한 단계 나아가 도구를 활용하게 하고 싶은 사람

상황 다시 고르기 ↑전체 목차 ↑다음: Skill →

05 · Skill

AI용
업무 매뉴얼이에요.

이런 문제가 있다면, 이 섹션이 답이에요

▸ 같은 수정 요청을 AI에게 계속 반복해요
▸ 사람마다, 때마다 AI 결과 품질이 달라요
▸ 우리 팀의 기준과 말투를 AI가 지켰으면 해요

해당되지 않나요? 상황 다시 고르기 ↑ · 바로 써보려면 업무 지침 템플릿 ↓

AI에게 이런 피드백을 반복한 적 있나요?

“없는 내용을 추측해서 쓰지 마.”“먼저 핵심 문제부터 정리해줘.”“고객에게 바로 보내지 말고 초안만 만들어줘.”“변경한 다음에는 테스트 결과도 알려줘.”

같은 업무를 자주 한다면, 매번 처음부터 설명하는 대신 업무에 필요한 지침과 기준을 재사용 가능한 형태로 정리할 수 있어요. 이 자료집에서는 이런 생각을 넓은 의미의 Skill로 설명합니다. 도구에 따라 참고 파일이나 스크립트를 함께 쓸 수도 있어요.

업무 매뉴얼의 항목을 AI가 하나씩 확인하며 따라가는 모습

매뉴얼이 있으면 AI가 항목을 하나씩 확인하며 일해요.

Skill에는 이런 내용이 들어가요

어떤 일을 위한 것인지
언제 사용해야 하는지

작업을 어떤 순서로 진행할지
어떤 자료를 참고해야 하는지

결과물을 어떤 형식으로 만들지
무엇을 확인하고 언제 사람에게 물어볼지

단순 프롬프트와는 어떻게 다른가요?

일회성 요청

지금 이 작업 처리
매번 직접 입력
현재 상황 중심
빠르게 시작하기 좋아요

재사용 가능한 Skill

반복되는 유형의 작업 처리
미리 정리해 재사용
절차·기준·예시·참고 자료
일관된 작업 방식을 만들기 좋아요

Skill을 만들었다고 결과가 항상 정확해지는 것은 아니에요. 지침이 모호하거나 참고 자료가 잘못되면 결과도 흔들려요.

모호한 지침

“고객 문의에 친절하게 잘 답변해줘.”

명확한 지침

“문의를 한 문장으로 요약한 뒤, 제공된 자료에 있는 내용만 근거로 초안을 써줘. 확인되지 않은 내용은 따로 표시하고, 발송은 하지 말고 초안으로만 보고해줘.”

순서, 근거, 금지 사항, 결과물 형식이 들어 있어서 누가 시켜도 비슷한 결과가 나와요.

Claude와 GPT 계열 도구에서는 어떻게 다를까요?

“반복 가능한 지침을 만든다”는 개념과, 특정 제품이 제공하는 공식 기능으로서의 Skill은 완전히 같은 말이 아니에요.

Claude Code
작업 지침을 Skill로 구성할 수 있어요. 공식 문서는 SKILL.md로 지침을 정의하는 방식을 설명해요.
Claude의 다른 환경
프로젝트 지침이나 제품별 Skill 기능 등, 환경에 따라 적용 방법이 달라요.
OpenAI Codex
Agent Skills를 활용하는 방식을 제공해요.
ChatGPT
GPT·지침·프로젝트에 반복 지침을 담을 수 있지만, 파일 기반 Skill과 같은 기능은 아니에요.

내가 쓰는 도구에서, 반복되는 업무 기준을 어디에 저장하고 어떻게 다시 적용할 수 있는가?

기능 지원 범위와 설정 방법은 달라질 수 있으니, 적용할 때는 해당 도구의 최신 문서를 확인하세요.

처음 만들어보는 업무 지침 템플릿

처음부터 복잡한 Skill을 만들 필요는 없어요. 아래 내용을 적어보는 것부터 시작해보세요. 복사해서 쓰세요.

템플릿

[업무 이름] 예: 고객 문의 답변 초안 작성 [목표] 이 업무를 통해 어떤 결과를 만들고 싶은가? [입력] AI가 작업하기 위해 필요한 정보는 무엇인가? [작업 순서] 1. 2. 3. [판단 기준] 무엇을 확인하고 어떤 기준으로 답해야 하는가? [하지 말아야 할 것] 추측하지 말아야 하는 내용이나 금지 행동은 무엇인가? [결과물 형식] 어떤 형태로 결과를 보고받고 싶은가? [사람에게 확인할 상황] 정보가 부족하거나 중요한 판단이 필요한 경우 어떻게 멈출 것인가?

작성 예시 1 · 고객 문의 답변 초안

[업무 이름] 고객 문의 답변 초안 작성 [목표] 고객의 질문에 정확하고 이해하기 쉬운 답변 초안을 만든다. [입력] 고객 문의 내용, 확인된 제품 안내 자료, 필요한 경우 고객 상태 [작업 순서] 1. 고객이 실제로 해결하려는 문제를 한 문장으로 정리한다. 2. 제공된 자료에서 답변 근거를 찾는다. 3. 근거가 있는 내용만 사용해 답변 초안을 작성한다. 4. 확인되지 않은 정보가 있으면 별도로 표시한다. [판단 기준] 고객이 바로 다음 행동을 이해할 수 있도록 간결하게 설명한다. [하지 말아야 할 것] 확인되지 않은 정책이나 기능을 사실처럼 쓰지 않는다. 고객에게 메시지를 직접 발송하지 않는다. [결과물 형식] - 문의 요약 - 답변 초안 - 참고한 자료 - 담당자가 확인할 사항 [사람에게 확인할 상황] 환불, 개인정보, 약속한 일정 등 중요한 판단이 필요하면 멈추고 담당자에게 확인한다.

작성 예시 2 · DocuRise 콘텐츠 만들기

[업무 이름] DocuRise 포스트 초안 만들기 [목표] 내가 준 자료를 독자가 읽기 쉬운 가이드 포스트로 만든다. [입력] 내가 준 글과 자료, 대상 독자 [작업 순서] 1. 독자가 알고 싶은 것을 한 문장으로 정리한다. 2. 짧은 섹션으로 나누고 제목을 붙인다. 3. 초안을 대화에서 먼저 보여준다. [하지 말아야 할 것] 내가 주지 않은 기능, 수치, 경력을 추가하지 않는다. 내가 확인하기 전에는 공개하지 않는다. [결과물 형식] 섹션별 제목과 본문, 고쳐야 할 점 목록 [사람에게 확인할 상황] 내가 “공개해줘”라고 말하면 그때 DocuRise 포스트로 만든다.

이 내용을 쓰는 AI 도구의 지침, 프로젝트 설정 또는 Skill 기능에 맞게 적용하세요. 어디에 어떻게 저장하는지는 도구마다 달라요.

Skill부터 정리하면 좋은 사람

AI에게 같은 수정 지시를 반복하는 사람 · 여러 사람이 비슷한 업무를 처리하는 팀 · 답변·코드·콘텐츠의 검토 기준이 중요한 사람 · AI가 결과만 만드는 것이 아니라 작업 과정도 지키길 원하는 사람

상황 다시 고르기 ↑전체 목차 ↑다음: 같은 문제 세 가지 방식 →

06 · 같은 문제, 세 가지 방식

정답은 “무조건 MCP”도
“무조건 API”도 아니에요.

상황은 같아요. 고객 문의 대응 시간을 줄이고 싶다. 막히는 지점에 따라 쓰는 방법이 달라져요.

API가 필요한 경우

“웹사이트에 들어온 문의를 고객 관리 도구에도 기록하고 싶어요.”

서비스 간에 문의 정보를 전달하고 기록하는 일이에요. 웹사이트가 문의를 받고, 정해진 방식으로 고객 관리 도구에 전달하고, 담당자가 한곳에서 확인해요.
핵심: 프로그램과 프로그램 사이의 연결

MCP가 필요한 경우

“AI가 문의에 답하기 전에 최신 도움말을 참고했으면 좋겠어요.”

AI가 필요한 자료에 접근하는 일이에요. AI 앱에 문서 도구를 연결하고, 허용된 자료를 참고해 답변 초안을 만들어요.
핵심: AI가 외부 정보와 도구를 활용하는 연결

Skill이 필요한 경우

“AI 답변이 매번 다르지 않고, 우리 기준을 지켰으면 좋겠어요.”

AI의 작업 방식 문제예요. 고객의 문제를 먼저 요약하고, 확인된 자료만 근거로 쓰고, 확실하지 않으면 담당자에게 확인하고, 초안으로 보고해요.
핵심: 작업 절차와 판단 기준의 재사용

함께 사용한다면?

고객 문의 접수
↓ API 등을 통해 문의 정보가 운영 도구에 기록
운영 도구에 문의가 기록됨
↓ AI가 MCP로 연결된 도움말을 참고
AI가 최신 도움말을 읽음
↓ Skill의 기준에 따라 답변 초안 작성
답변 초안
↓ 사람
담당자가 검토하고 발송

세 개념을 이해하기 위한 예시예요. 실제로 구현할 수 있는 범위는 각 서비스의 API·MCP·AI 도구 지원 여부에 따라 달라져요.

DocuRise에서는 이렇게 이어져요

같은 구조를 DocuRise 신청 폼에 대입해볼게요.

누군가 신청 폼을 제출 · 또는 Instagram에 키워드 댓글
↓ DocuRise가 신청을 받아 기록
신청 정보가 한곳에 모임
↓ AI가 MCP로 신청 현황과 문서를 읽음
AI가 누가 무엇을 신청했는지 파악
↓ Skill의 기준(말투, 금지 사항)에 따라 안내 문구 초안
안내 이메일 초안
↓ 사람
내가 문구를 확인하고 켜기

중요한 결론

기술 세 개를 모두 쓰는 것이 목표가 아니에요. 내 업무에서 필요한 부분에만 적절한 방법을 쓰는 것이 목표입니다.

상황 다시 고르기 ↑전체 목차 ↑다음: 함께 쓰는 방법 →

07 · 함께 쓰는 방법

하나만으로는
부족할 때가 있어요.

MCP만 연결하면 충분할까요?

AI가 자료를 볼 수 있어도, 그 자료를 어떤 기준으로 해석하고 결과를 만들지는 별개예요. 오래된 정보를 먼저 쓰거나, 필요 없는 내용을 길게 넣거나, 확인 안 된 내용을 추측하거나, 사람이 검토하기 전에 작업을 실행할 수 있어요. 자료 접근 외에 작업 기준과 승인 절차도 필요해요.

Skill만 만들면 충분할까요?

“최신 제품 안내를 확인한 뒤 답변해.”라고 지시해도, 최신 제품 안내가 제공되지 않았다면 수행하기 어려워요. 필요한 자료를 사람이 제공하거나, AI 앱에서 쓸 수 있는 연결 방식을 검토해야 해요.

API
MCP
Skill

필요한 것이 겹치는 만큼 조합해서 쓰면 돼요.

셋은 어떻게 조합할 수 있나요?

API 만

잘 맞는 상황 정해진 데이터 조회·기록·기능 실행
확인할 점 권한, 오류 처리, 사용량

MCP 만

잘 맞는 상황 AI가 외부 자료나 도구를 참고하는 작업
확인할 점 연결 범위, 정보 정확성
DocuRise 예 지난주 성과를 읽어서 정리해달라고 할 때

Skill 만

잘 맞는 상황 자료가 이미 주어졌고 작업 기준을 반복 적용
확인할 점 지침의 명확성, 결과 검토

MCP + Skill

잘 맞는 상황 AI가 자료를 참고하면서 정해진 방식으로 일해야 함
확인할 점 자료 접근과 업무 기준 모두 확인
DocuRise 예 내 자료를 읽어 포스트 초안을 쓰되, “내가 확인하기 전엔 공개하지 않기”를 지키게 할 때

API + MCP + Skill

잘 맞는 상황 서비스 연결, AI 작업, 업무 기준이 함께 필요한 경우
확인할 점 복잡도, 권한, 실패 시 대응

기억하기

복잡한 조합이 더 좋은 것은 아니에요. 한 번의 대화나 간단한 복사·붙여넣기로 충분한 일이라면, 거기서 시작해도 돼요.

상황 다시 고르기 ↑전체 목차 ↑다음: 시작점 고르기 →

08 · 내 상황에 맞는 시작점

네 가지 질문으로
시작점을 골라보세요.

Q1

다른 서비스의 데이터나 기능을 내 앱·자동화에서 사용해야 하나요?

그렇다 → API 제공 범위 확인아니다 → 다음 질문

Q2

AI가 내 문서나 외부 도구에 접근해야 하나요?

그렇다 → MCP 지원 여부 확인아니다 → 자료를 직접 제공해도 충분해요

Q3

AI에게 같은 업무 순서와 수정 기준을 계속 설명하나요?

그렇다 → 반복 지침 정리아니다 → 일회성 프롬프트로 시작

Q4

자료 접근과 업무 기준이 모두 필요한가요?

그렇다 → MCP와 Skill을 함께 검토아니다 → 병목 하나만 먼저 해결

상황별 빠른 선택표

내 앱에 결제·회원 관리 같은 외부 기능을 붙이고 싶다
API
신청 폼의 내용을 고객 관리 도구로 보내고 싶다
API
AI가 내 업무 문서를 참고해 질문에 답하게 하고 싶다
MCP
AI가 같은 형식과 기준으로 결과물을 만들게 하고 싶다
Skill
AI가 문서를 참고하면서 팀 기준대로 일하게 하고 싶다
MCP Skill
가끔 자료 하나를 요약하기만 하면 된다
직접 제공

우리 팀에 적용하면

역할에 따라 먼저 쓰는 곳이 달라요. 이해를 돕기 위한 예시예요.

운영

문의 답변 초안, 정산 내역 대조, 공지 작성
먼저 볼 것 Skill → 자료가 많아지면 MCP
작게 시작 문의 답변 지침 한 장, 발송은 사람이

마케팅

콘텐츠 초안, 후기·성과 정리, 캡션 아이디어
먼저 볼 것 Skill(브랜드 말투) → 성과는 MCP로 읽기
작게 시작 브랜드 톤 가이드를 템플릿에 옮기기

개발

서비스 연결, 배포 전 점검, 코드 리뷰
먼저 볼 것 API(연결) + Skill(리뷰 기준)
작게 시작 반복 지시를 지침 파일로 옮기기

비즈니스

미팅 준비, 주간 현황, 파트너 메일 초안
먼저 볼 것 MCP(일정·문서, 읽기 전용) + 확인 단계
작게 시작 “다음 미팅 전 확인할 질문 정리”

상황 다시 고르기 ↑전체 목차 ↑다음: 안전 체크리스트 →

09 · 안전 체크리스트

연결할 수 있다는 것과
연결해도 된다는 것은 달라요.

AI가 정보를 읽는 것을 넘어 생성·수정·삭제·발송까지 할 수 있다면, 시작 전에 아래를 확인해보세요.

권한은 단계적으로 열어요

1단계읽기 전용
2단계초안·제안만 작성
3단계사람이 승인하면 실행
4단계자동 실행

처음에는 검은색 1~2단계, 즉 읽기 전용·작은 범위·사람의 검토부터 시작하는 편이 안전해요.

DocuRise에 적용하면

DocuRise를 AI 앱에 연결할 때 읽기만 / 읽기와 쓰기 중에서 권한을 고를 수 있어요. 처음에는 읽기만 열고, 성과 정리 같은 읽기 작업부터 시험해보세요. 연결 방법은 MCP 가이드에 있어요.

포스트나 폼은 만들면 바로 공개될 수 있어요. 그래서 초안은 대화에서 먼저 확인하고, “공개해줘”는 따로 말하는 방식이 안전해요.

접근 권한

☐ 이 연결이 정말 필요한가?
☐ AI나 자동화 도구가 어떤 데이터에 접근하는가?
☐ 모든 데이터가 필요한가, 일부만 있으면 되는가?
☐ 읽기만 필요한데 수정·삭제 권한까지 주고 있지는 않은가?
☐ 연결한 서버나 도구의 제공자를 신뢰할 수 있는가?

개인정보와 비밀 정보

☐ 고객 개인정보나 내부 문서가 외부 AI 서비스로 전달되는가?
☐ 사용 중인 서비스의 데이터 처리 정책을 확인했는가?
☐ API 키와 인증 정보를 공개 코드나 화면에 넣지 않았는가?
☐ 테스트에 실제 민감 데이터를 쓰지 않아도 되는가?

실행과 검토

☐ AI가 외부로 메시지를 보내거나 내용을 수정하기 전에 승인이 필요한가?
☐ 실패하거나 잘못 실행되면 어디에서 확인할 수 있는가?
☐ 원래 상태로 되돌릴 방법이 있는가?
☐ 잘못된 정보나 문서에 포함된 악의적인 지시를 AI가 따르지 않도록 주의하고 있는가?
☐ 실제 고객이나 운영 데이터에 적용하기 전에 작은 범위로 시험했는가?

문서 속에 숨은 지시

AI가 읽는 문서, 웹페이지, 메일 안에 AI에게 하는 말처럼 쓴 문장이 들어 있을 수 있어요. 이를 프롬프트 인젝션이라고 불러요. 연결된 자료의 내용은 참고 자료로만 다루고, 발송·삭제 같은 실행은 사람이 승인하게 해두세요.

상황 다시 고르기 ↑전체 목차 ↑다음: DocuRise에 대입 →

10 · DocuRise에 대입해보면

한 제품에
대입해보면 이렇게 보여요.

실제 제품은 사용자가 일하는 환경에 맞게 여러 연결 방법을 제공하기도 해요. 저희가 만들고 있는 DocuRise는 AI 앱에서 바로 쓸 수 있는 MCP 연결을 지원해요. 시스템끼리 연결하는 API는 필요한 범위가 열려 있는지 따로 확인해 보세요.

API를 먼저 볼 때

“내가 만드는 서비스나 운영 흐름에서 DocuRise를 활용하고 싶다.”

외부 시스템과 연결되는 업무를 설계 중이라면, 필요한 데이터나 기능이 API로 열려 있는지 확인하는 것이 출발점이에요.

MCP를 먼저 볼 때

“내가 쓰는 AI 앱에서 DocuRise를 활용하고 싶다.”

AI 작업 환경에서 DocuRise를 연결해 성과를 읽고, 포스트와 폼을 만들고, Instagram DM 규칙까지 대화로 다룰 수 있어요. 04장의 예시 대화를 다시 보세요.

AI 앱에서 DocuRise 사용하기 · MCP 가이드 →다른 크리에이터의 DocuRise 자료 보기 →

Skill은 어디에 들어갈까요?

DocuRise가 제공하는 연결과는 별개로, 쓰는 AI 도구에서 자료를 활용하는 기준과 절차를 정리할 수 있어요. 05장의 “DocuRise 콘텐츠 만들기” 예시처럼 “내가 주지 않은 내용은 추가하지 않는다”, “확인하기 전에는 공개하지 않는다” 같은 기준을 적용하는 식이에요.

시스템 연결이 필요한가, AI의 정보 접근이 필요한가, 반복 업무의 기준이 필요한가?

상황 다시 고르기 ↑전체 목차 ↑다음: 첫 업무 흐름 설계 →

11 · 나의 첫 AI 업무 흐름

매주 반복하는
작은 업무 하나만 골라보세요.

한 번에 모든 도구를 연결하려 하지 말고, 매주 반복하는 작은 업무 하나로 시작하세요.

업무 적기, 병목 찾기, 작게 시도, 결과 확인의 네 단계가 이어지는 모습

한 번에 하나씩, 작게 돌려보고 확인해요.

11.1 업무 적기

복사해서 채워보세요

내가 반복하는 업무: 이 업무를 얼마나 자주 하는가: 현재 사람이 직접 하는 일: 가장 번거로운 단계:

11.2 병목 구분하기

가장 가까운 하나를 고르세요. 누르면 해당 섹션으로 이동해요.

서비스 사이에서 데이터를 옮기는 일이 번거롭다.
→ API 또는 자동화 연결을 살펴본다.
API
AI에게 자료를 찾고 전달하는 일이 번거롭다.
→ MCP 또는 다른 자료 제공 방식을 살펴본다.
MCP
AI에게 같은 기준을 반복 설명하는 일이 번거롭다.
→ Skill 또는 재사용 가능한 지침을 정리한다.
Skill
아직 한 번만 해본 일이다.
→ 먼저 일반적인 방식으로 해보고 반복되는지 확인한다.
시작점

11.3 작은 실험 정하기

복사해서 채워보세요

이번에 개선할 업무 한 가지: AI나 자동화가 해야 할 일: 사람이 직접 확인할 일: 접근이 필요한 정보: 접근하면 안 되는 정보: 성공 기준: 예: 담당자가 자료를 찾는 시간을 줄이고, 답변 초안의 근거를 함께 확인할 수 있다. 멈춰야 하는 조건: 예: 근거 자료를 찾지 못했거나 고객 개인정보가 불필요하게 포함된 경우.

11.4 AI에게 도움 요청하기

어떤 방식이 필요한지 여전히 헷갈린다면, 아래 요청을 AI에게 그대로 붙여넣고 빈칸만 채워보세요.

그대로 요청해 보세요

나는 다음 업무를 반복하고 있어. [현재 업무] 여기에 현재 업무를 적어줘. [불편한 지점] 여기에 가장 번거로운 부분을 적어줘. [사용 중인 도구] 여기에 사용 중인 서비스와 AI 도구를 적어줘. 이 업무에서 API, MCP, 재사용 가능한 업무 지침 중 무엇을 먼저 검토하면 좋을지 설명해줘. 각 선택지에 대해: 1. 어떤 문제를 해결하는지 2. 실제로 어떤 연결이나 권한이 필요한지 3. 지금 당장 그 방법이 필요한지 4. 더 간단하게 시작할 수 있는 방법은 없는지 5. 사람이 반드시 확인해야 할 부분은 무엇인지 내가 사용하는 도구의 기능을 확인할 수 없다면 가능하다고 단정하지 말고, 확인할 항목으로 표시해줘.
상황 다시 고르기 ↑전체 목차 ↑다음: 자주 묻는 질문 →

12 · 자주 묻는 질문

많이 받는
다섯 가지 질문에 답해요.

다른 서비스에 있는 데이터를 내 앱에서 쓰려면 어떻게 해야 할까?

API 서비스가 제공하는 API로 필요한 데이터를 조회하거나 기능을 호출해요. “API가 있나?”뿐 아니라 내가 필요한 기능과 권한, 사용량 제한, 요금까지 제공 범위를 확인하세요. API 이해하기 →

AI가 내 문서나 고객 정보를 참고하게 하려면?

MCP 쓰는 AI 앱과 연결 대상이 MCP를 지원하는지 확인하고, 필요한 권한만 허용해 읽기부터 시험하세요. 자료가 적다면 직접 제공해도 충분해요. 고객 개인정보가 외부 AI 서비스로 전달되는지는 꼭 확인하세요. 안전 체크리스트 → · DocuRise MCP 가이드 →

AI에게 매번 같은 업무 기준을 설명하지 않으려면?

Skill 반복되는 지침을 재사용 가능한 형태로 정리하세요. 쓰는 도구가 어떤 재사용 기능을 제공하는지 먼저 확인하면 돼요. Skill 템플릿 →

MCP를 연결하면 API는 필요 없는 걸까?

아니요. MCP는 API의 대체품이 아니에요. 어떤 MCP 서버는 뒤에서 API를 호출하기도 하고, AI 없이 정해진 규칙대로 돌아야 하는 연결은 API가 직접 맡는 편이 자연스러워요. MCP와 API의 관계 →

Skill만 잘 만들어두면 모든 업무가 자동화될까?

아니요. 지침이 좋아도 AI가 필요한 정보에 접근하지 못하면 한계가 있고, 지침이 모호하거나 자료가 틀리면 결과도 흔들려요. 중요한 판단은 사람이 확인하는 단계를 남겨두세요. 함께 쓰는 방법 →

상황 다시 고르기 ↑전체 목차 ↑마지막으로 →

마지막으로 기억할 것

어디에서 일이 끊기는지
먼저 보세요.

AI 업무를 설계할 때는 새로운 기술 이름부터 외우기보다, 지금 어디에서 일이 끊기는지 먼저 보는 게 좋아요.

API
서비스의 기능이나 데이터를 다른 프로그램에서 쓰고 싶다면
MCP
AI가 외부 정보나 도구를 활용하게 하고 싶다면
Skill
AI가 반복 업무를 정해진 기준으로 처리하게 하고 싶다면

그리고 세 가지를 모두 쓸 필요는 없어요. 가장 중요한 질문은 이것입니다.

내가 반복해서 옮기고, 찾고, 다시 설명하고, 수정하는 일은 무엇인가?

그중 하나만 줄여도 충분히 좋은 시작이에요.

오늘 바로 해볼 일

지금 가장 번거로운 반복 업무 하나를 적어보세요. 그리고 그 문제가 서비스 연결, AI의 자료 접근, 업무 기준의 반복 중 어디에 가까운지 표시해보세요.

업무 설계 템플릿으로 → · 상황 다시 고르기 ↑

더 읽어보기

아이린의 다른 자료집 보기
docurise.io/irene
AI 앱에서 DocuRise 사용하기 · MCP 가이드
DocuRise 팀이 만든 연결 안내

참고한 자료

Model Context Protocol
MCP 공식 사이트
Claude Code · Skills
Extend Claude with skills
OpenAI Codex · Agent Skills
Codex 공식 문서

이 자료집은 DocuRise로 만들었어요

자료를 만들고, 공개하고, 신청이나 댓글을 받아 후속 안내까지 이어가는 일을 한곳에서 할 수 있어요.

MCP 가이드 보기 →DocuRise 알아보기 →
아 아이린 | 사업하는 개발자Instagram · @stayfit_ireneinstagram.com/stayfit_irene 팔로우하기 →

전체 목차 ↑