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 ← 우리 업무 기준

여기서 시작하세요

지금 어떤 상황이세요?

AI가 내 자료를 몰라요

매번 자료를 찾아서 복사·붙여넣기 하고 있다면

MCP 부터 살펴보기 →

AI가 매번 다른 방식으로 일해요

같은 수정 요청을 계속 반복하고 있다면

Skill 부터 살펴보기 →

서비스끼리 연결하고 싶어요

데이터를 손으로 옮기고 있다면

API 부터 살펴보기 →

셋 다 헷갈린다면? 3분 핵심 요약부터 보기 →
AI에게 어디까지 맡겨도 될지 불안하다면? 권한을 여는 순서 보기 →

아이린

아이린의 한마디이 자료집을 만든 이유

AI 도구를 쓰다 보면 어느 순간 이런 말을 자주 듣게 돼요.

“API로 연결하면 돼요.”
“그건 MCP 붙이면 되지 않아요?”
“그 업무는 Skill로 만들면 편해요.”

그런데 막상 내 일을 떠올리면, 셋 중 무엇부터 봐야 할지 애매할 때가 있어요.

저는 DocuRise를 만들면서, 그리고 직접 MCP와 API로 연결해 쓰면서, 어떤 기능을 붙일지보다 지금 해결하려는 문제가 무엇인지부터 구분하는 게 중요하다고 느꼈어요.

이 자료집은 세 기술을 전부 외우기 위한 문서가 아니에요. 지금 내게 필요한 게 서비스 연결인지, AI의 자료 접근인지, 반복 업무의 기준인지 판단할 수 있게 정리했어요. 개념 설명은 공식 문서를 바탕으로 했어요.

아이린 | 사업하는 개발자

01 · 한눈에 보기

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

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

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

이해를 돕기 위한 비유예요. MCP는 출입증 자체가 아니라, AI 앱이 외부 정보와 도구에 연결하는 표준 방식이에요. 실제로 무엇을 볼 수 있는지는 연결과 권한에 따라 달라져요.

API

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

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

MCP

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

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

Skill

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

비유하면 AI용 업무 매뉴얼

질문으로 바꿔보면

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

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

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

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

각각의 역할

MCP

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

Skill

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

API

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

중요

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

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

02 · MCP

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

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

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

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

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

이런 요청을 한다면

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

기존

사람이 전달해요

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

MCP 연결 후

AI가 직접 참고해요

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

아이린

아이린의 실무 메모언제 연결할까

저는 새로운 연결 기능을 볼 때 “이걸 쓸 수 있나?”보다 “이걸 붙이면 어떤 반복이 없어지나?”를 먼저 생각해요.

AI에게 가끔 문서 하나를 붙여넣는 정도라면 지금 방식으로도 충분해요. 그런데 필요한 자료를 매번 찾고, 복사하고, 다시 설명하는 일이 반복된다면 그때 MCP를 살펴볼 이유가 생겨요.

저는 DocuRise를 MCP로 연결해두고 쓰는데, 가장 편한 건 AI와 이야기하듯 작업이 이어진다는 점이에요.

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

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

기억하세요

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

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

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

DocuRise를 AI 앱에 MCP로 연결하면, 자료를 보고 정리하는 일을 대화로 맡길 수 있어요. 아래는 이해를 돕기 위한 예시 대화예요. 숫자와 이름은 가상이고, 실제로 조회할 수 있는 범위는 연결과 권한에 따라 달라요.

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

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

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

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

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

→ MCP 읽기만 하는 작업이라 가장 안전하게 시작할 수 있어요. 포스트 만들기, 신청 폼, Instagram DM 같은 예시는 07장에 더 있어요.

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 →

03 · Skill

AI용
업무 매뉴얼이에요.

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

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

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

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

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

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

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

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

아이린

아이린의 실무 메모왜 기준을 남길까

AI 결과물이 마음에 들지 않을 때 매번 “이렇게 말고 다시”라고만 하면, 비슷한 수정이 계속 반복돼요.

제가 중요하게 보는 건 잘 나온 결과 하나보다 왜 그 결과가 괜찮았는지 기준을 남기는 것이에요. 어떤 순서로 확인했는지, 무엇을 추측하면 안 되는지, 어디서 사람이 판단해야 하는지. 이런 기준이 쌓이면 AI에게 일을 맡기는 방식도 조금씩 선명해져요.

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

① 목적

어떤 일을 위한 것인지

언제 사용해야 하는지

② 절차

어떤 순서로 진행할지

어떤 자료를 참고해야 하는지

③ 결과물

어떤 형식으로 만들지

무엇을 확인하고, 언제 사람에게 물어볼지

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

일회성 요청

빠르게 시작하기 좋아요

지금 이 작업 처리
매번 직접 입력
현재 상황 중심

재사용 가능한 Skill

일관된 작업 방식을 만들기 좋아요

반복되는 유형의 작업 처리
미리 정리해 재사용
절차·기준·예시·참고 자료

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

모호한 지침

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

명확한 지침

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

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

업무 지침 템플릿 보기 →Claude·GPT 등 도구별 차이 보기 →

Skill부터 정리하면 좋은 사람

✓AI에게 같은 수정 지시를 반복하는 사람
✓여러 사람이 비슷한 업무를 처리하는 팀
✓답변·코드·콘텐츠의 검토 기준이 중요한 사람
✓AI가 결과만 만드는 게 아니라 작업 과정도 지키길 원하는 사람
상황 다시 고르기 ↑전체 목차 ↓다음: API →

04 · API

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

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

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

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

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

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

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

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

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

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

API로 할 수 있는 일

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

자동화와 API

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

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

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

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

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

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

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

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

DocuRise에서는

DocuRise는 API와 MCP를 모두 지원해요

API
내가 만드는 서비스나 운영 흐름에서 DocuRise를 연결하고 싶을 때
MCP
AI 앱에서 대화로 쓰고 싶을 때 → 02장 MCP

API로 구체적으로 어떤 기능을 쓸 수 있는지는 DocuRise의 최신 안내를 확인하세요.

주의 · API 키

일부 API는 API 키라는 비밀 정보로 사용자를 확인해요.

공개 저장소, 캡처 화면, 채팅에 그대로 넣지 마세요. 서비스마다 방식이 다르니 공식 문서를 확인하세요.

API가 있으면 모든 걸 할 수 있나요? →API와 웹훅의 차이 →

API를 먼저 보면 좋은 사람

✓직접 서비스나 웹사이트를 만들고 있는 사람
✓결제·회원·고객 관리 같은 기능을 연결하고 싶은 사람
✓여러 도구에 흩어진 데이터를 정리하고 싶은 운영 담당자
✓AI 없이도 정확하게 반복되어야 하는 흐름을 만들고 싶은 사람
상황 다시 고르기 ↑전체 목차 ↓다음: 하나의 업무로 보기 →

05 · 하나의 업무로 다시 보기

그래서 실제 업무에서는
어떻게 함께 쓸까요?

고객 문의 답변 준비를 예로 들어볼게요. 단계를 눌러 어디가 막히는지 확인해보세요.

고객 문의가 접수되어 사람이 발송하기까지 API, MCP, Skill이 쓰일 수 있는 예시 흐름

선택 가능한 예시 흐름이에요. 모든 업무에 세 가지가 다 필요한 것은 아니고, 각 도구가 어디에 쓰일 수 있는지 보여주는 하나의 그림이에요.

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

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

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

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

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

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

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

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

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

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

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

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

Skill만 만들면 충분할까요?

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

API
MCP
Skill

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

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

API 만

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

MCP 만

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

Skill 만

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

MCP + Skill

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

API + MCP + Skill

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

중요한 결론

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

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

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

상황 다시 고르기 ↑전체 목차 ↓다음: 내 업무에 적용 →

06 · 내 업무에 적용하기

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

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

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

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

세 가지만 물어보세요

1
내가 반복해서 옮기거나, 찾거나, 다시 설명하는 일은 무엇인가요?
2
그 문제는 서비스 연결, AI의 자료 접근, 업무 기준 중 어디에 가깝나요?
서비스 연결 → API · 자료 접근 → MCP · 업무 기준 → Skill
3
AI가 해도 되는 일과 사람이 확인할 일은 어디까지인가요?

복사해서 채워보세요

내가 반복하는 업무: 가장 번거로운 단계: AI가 참고해야 할 정보: AI에게 맡기지 않을 일: 사람이 확인할 지점:

더 자세한 업무 설계 템플릿과, 어떤 방식이 필요한지 AI에게 물어보는 요청문은 참고 영역에 있어요.

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

AI가 정보를 읽는 것을 넘어 생성·수정·삭제·발송까지 할 수 있다면, 권한은 단계적으로 여세요.

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

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

DocuRise에 적용하면

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

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

연결 전에 확인할 항목 전체는 안전 체크리스트에 있어요.

상황 다시 고르기 ↑전체 목차 ↓다음: DocuRise를 만들면서 →

07 · DocuRise를 만들면서 생각한 것

만드는 사람의 눈으로 본
API와 MCP예요.

아이린

아이린의 실무 메모DocuRise를 만들면서

자료를 만드는 사람마다 일하는 방식이 달라요. 어떤 분은 화면에서 직접 자료를 관리하고, 어떤 분은 본인이 만든 서비스나 운영 도구와 연결하고 싶어 하고, 또 어떤 분은 AI와 대화하면서 자료를 활용하고 싶어 해요.

그래서 DocuRise는 API와 MCP를 모두 지원해요. 저도 두 가지로 세팅해두고 많이 쓰고, 제가 쓰기 쉽게 계속 만들어가고 있어요.

MCP로 연결해서 써보니 가장 크게 느낀 건 세 가지예요. AI와 이야기하면서 작업이 자연스럽게 이어진다는 점, 제가 직접 세팅했다면 놓쳤을 부분을 AI가 잡아준다는 점, 그리고 더 빠르고 퀄리티 있는 결과물이 나온다는 점이에요.

그래서 이 가이드에서도 “어느 쪽이 더 좋은가”보다 내가 어디에서 작업하고, 무엇을 연결하고 싶은가를 먼저 보셨으면 해요.

API를 먼저 볼 때

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

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

MCP를 먼저 볼 때

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

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

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

대화로 이렇게 이어져요

앞에서 본 읽기 예시 외에, 만들고 공개하는 일도 대화로 할 수 있어요. 아래도 예시 대화이고, 실제 지원 범위와 승인 방식은 연결과 권한에 따라 달라요.

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

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

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

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

DocuRise 연결 · 포스트 만들기

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

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

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

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

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

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

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

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

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

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

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

DocuRise에서는 이렇게 이어져요

세 개념을 DocuRise 신청 폼에 대입해볼게요. 선택 가능한 예시 흐름이에요.

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

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

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

마지막으로 기억할 것

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

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

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

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

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

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

오늘 바로 해볼 일

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

적용 템플릿으로 → · 상황 다시 고르기 ↑ · 참고 영역 →

참고 영역

필요할 때
찾아보는 자료예요.

여기부터는 본문을 읽은 뒤, 필요한 순간에 꺼내 쓰는 자료예요. 처음부터 다 읽을 필요는 없어요.

전체 목차

본문

01
API·MCP·Skill 한눈에 보기
02
MCP: AI가 외부 정보와 도구를 활용할 때
03
Skill: AI가 정해진 방식으로 일하게 할 때
04
API: 프로그램이 서비스의 기능을 사용할 때
05
하나의 업무로 다시 보기 · 함께 쓰는 방법
06
내 업무에 적용하기 · 권한을 여는 순서
07
DocuRise를 만들면서 생각한 것

참고

A
연결하기 전 안전 체크리스트
B
내 상황에 맞는 시작점 고르기
C
업무 지침·설계 템플릿 모음
D
Claude·GPT 등 도구별 지침 방식
E
API 자세히 · 제공 범위와 웹훅
F
자주 묻는 질문
G
더 읽어보기 · 참고한 자료

참고 A · 안전 체크리스트

연결하기 전에
이것만 확인하세요.

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

접근 권한

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

개인정보와 비밀 정보

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

실행과 검토

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

문서 속에 숨은 지시

AI가 읽는 문서, 웹페이지, 메일 안에 AI에게 하는 말처럼 쓴 문장이 들어 있을 수 있어요. 이를 프롬프트 인젝션이라고 불러요.

연결된 자료의 내용은 참고 자료로만 다루고, 발송·삭제 같은 실행은 사람이 승인하게 해두세요.

참고 영역 목록 ↑상황 다시 고르기 ↑본문: 권한을 여는 순서 →

참고 B · 내 상황에 맞는 시작점

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

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(일정·문서, 읽기 전용) + 확인 단계
작게 시작 “다음 미팅 전 확인할 질문 정리”

참고 영역 목록 ↑상황 다시 고르기 ↑

참고 C · 템플릿 모음

복사해서 바로
써보세요.

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

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

템플릿

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

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

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

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

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

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

업무 설계 템플릿

1. 업무 적기

복사해서 채워보세요

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

2. 병목 구분하기 · 가장 가까운 하나를 고르세요. 누르면 해당 섹션으로 이동해요.

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

3. 작은 실험 정하기

복사해서 채워보세요

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

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

그대로 요청해 보세요

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

참고 D · 도구별 지침 방식

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

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

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

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

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

참고 영역 목록 ↑상황 다시 고르기 ↑본문: Skill →

참고 E · API 자세히

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

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

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

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

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

API 요청

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

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

웹훅

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

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

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

참고 영역 목록 ↑상황 다시 고르기 ↑본문: API →

참고 F · 자주 묻는 질문

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

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

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

참고 영역 목록 ↑상황 다시 고르기 ↑

참고 G · 더 읽어보기

더 읽어보기

아이린의 다른 자료집 보기
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 팔로우하기 →

상황 다시 고르기 ↑ · 참고 영역 목록 ↑