MCP API 통합을 사용하여 커스텀 에이전트를 툴 스택에 연결하세요.

FigJam의 브레인스토밍, Linear의 버그, GitHub의 수정, Stripe의 수익, Notion의 계획과 같이 업무는 한곳에 있지 않습니다. 연결된 도구가 없으면, 업무가 계속 진행될 수 있도록 사람들이 맥락을 복사하는 연결 고리가 되어야 합니다.

커스텀 에이전트는 전체 스택에서 작동할 수 있을 때 훨씬 더 강력해집니다.

MCP(모델 컨텍스트 프로토콜)를 사용하면 에이전트가 외부 도구에 안전하게 연결하여 단일 워크플로의 일부로 사용할 수 있습니다. 적절한 권한이 있으면, 에이전트가 어디에 있든 일정에 따라, 이벤트를 통해 또는 필요에 따라 실시간 데이터를 가져오고, 조치를 취하고, 업무를 조율할 수 있습니다.

이 가이드에서 다루는 내용:

• MCP가 워크플로에 적합한지 여부 결정하기

• 사전 구성된 MCP 서버 연결(예: FigJam 사용)

• 내부 도구 및 API용 사용자 지정 MCP 서버 추가 및 구성

• 범위 지정된 사용 권한, 쓰기 작업에 대한 승인 및 명확한 소유권으로 안전하게 롤아웃

• 일반적인 MCP 연결 및 실행 문제 해결 방법

커스텀 에이전트는 Notion 내에서 팀원처럼 행동할 수 있습니다. 사용자가 워크플로를 정의하면 사용자가 설정한 맥락과 권한을 사용하여 일정에 따라, 이벤트에 대응하여 또는 필요할 때마다 워크플로가 실행됩니다.

MCP가 없어도 에이전트는 Notion 내에서 작업을 자동화할 수 있지만, 다른 도구에 의존하는 워크플로는 여전히 수동 확인 및 맥락 전환이 필요할 수 있습니다.

MCP를 사용하면 이러한 워크플로를 다른 도구 스택과 연결할 수 있습니다. 에이전트는 다른 시스템에서 데이터와 맥락을 자동으로 가져올 수 있습니다.

워크플로가 Notion과 다른 시스템에 걸쳐 있을 때 MCP를 사용하세요. 예를 들어, 다음과 같은 작업을 수행할 수 있습니다.

• Linear나 Jira에서 티켓 업데이트

• GitHub에서 업무를 생성하거나 트래킹

• Stripe에서 결제나 구독 업데이트 로그

• Amplitude에서 제품 지표 가져오기

팀이 FigJam에서 계획 수립 세션과 브레인스토밍, 워크숍을 진행하지만, 결과물(액션 아이템, 결정 사항, 다이어그램)이 보드에 그대로 남아 있다고 가정해 보겠습니다. 한편 Notion 워크스페이스는 사양, 프로젝트 페이지, 작업이 실제로 존재하는 곳입니다. 업무를 원활하게 진행하려면 아이디어 구상과 실행 단계를 연결할 방법이 필요하며, 그 과정에서 놓치는 부분이 없어야 합니다.

이 예시에서는 Figma(FigJam)를 사용하여 엔드 투 엔드 워크플로가 어떻게 구성되는지 보여드리겠습니다.

워크스페이스 사이드바에서 새 에이전트를 생성하세요. 그런 다음 에이전트와 채팅하여 실행하려는 워크플로를 설명합니다. 시간을 할애하여 에이전트가 처리해야 하는 작업을 명확히 설명하는 것이 중요합니다.

다음의 예시를 참고하여 상황에 따라 적용할 수 있습니다.

'내가 Notion 문서나 개요를 공유하면 해당 정보를 FigJam 보드로 변환하고 흐름도나 사용자 여정, 시스템 지도처럼 적절한 다이어그램 유형을 적용해 줘. 그리고 FigJam 보드 링크를 공유하면 스티커, 주석, 주요 테마를 추출하여 명확한 다음 단계와 함께 체계적으로 정리된 Notion 문서를 만들어 줘.'

이 작업을 설정할 때 에이전트 지침에 몇 가지 상세정보를 명시하는 것이 좋습니다.

• 예상하는 결과물 유형을 명시합니다. 예를 들어 프로세스 문서에는 흐름도, 리서치 조사 결과에는 사용자 여정, 팀 계획에는 조직도를 사용할 수 있습니다.

• 에이전트가 스스로 업무를 진행해야 하는 경우와 일시정지하고 추가 설명을 요청해야 하는 경우를 명시합니다.

• 정보 출처 위치 페이지를 명시합니다. 예를 들어 FigJam 보드를 만들 때 항상 출처가 되는 Notion 페이지 링크를 제공하고, Notion에서 결과를 요약할 때는 항상 FigJam 보드로 다시 연결합니다.

다음으로 MCP를 사용하여 커스텀 에이전트에 Figma를 연결합니다. 이렇게 연결하면 에이전트가 단일 워크플로 내에서 Notion과 FigJam 간에 업무를 이동할 수 있습니다. 방법은 다음과 같습니다.

• 에이전트의 설정을 여세요.

• 도구 및 사용 권한으로 이동하세요.

• 연결 추가를 클릭하세요.

• 사전 구성된 서버(예: Figma)를 선택한 다음 추가를 클릭하세요.

• 인증 안내 메시지에 따라 Figma 계정을 연결하세요.

• 에이전트가 사용할 도구를 선택하세요(서버에 따라 다름).

• 저장을 클릭하세요.

Figma가 연결되면 Notion 도구와 마찬가지로 에이전트가 사용할 수 있는 도구 모음이 표시됩니다. 이 시점부터 에이전트는 FigJam 보드를 읽고, 새 다이어그램을 생성하며, 모든 것을 Notion에 다시 연결할 수 있습니다.

이렇게 설정할 때는 작은 것부터 시작하세요. 이 워크플로에는 에이전트에 필요한 도구 기능만 활성화하고, 테스트하는 동안 쓰기 도구를 항상 묻기로 설정하여 무엇이든 생성되거나 업데이트되기 전에 변경 사항을 직접 검토할 수 있도록 합니다.

체계적으로 정리된 문서와 시각적 사고를 먼저 분리하는 것부터 시작하는 것이 좋습니다.

Notion을 사양과 계획, 회의록, 결정 사항이 모이는 장소라고 생각하세요. 예를 들어 PM이 PRD를 작성하거나, 팀 리드가 OKR 초안을 만들거나, 리서치 담당자가 조사 결과를 수집하면 명확한 섹션과 맥락을 갖춘 Notion의 체계적으로 정리된 페이지로 시작합니다.

반면 FigJam은 시각적 사고가 이루어지는 곳입니다. 팀이 스티커 메모로 브레인스토밍하고, 사용자 여정을 도식화하며, 시스템 다이어그램을 스케치하고, 워크숍을 진행하는 곳입니다.

이 구분이 명확해지면 에이전트가 둘을 연결합니다. Notion 문서를 사용하여 FigJam 보드(예: 흐름도나 여정 지도, 시스템 다이어그램)의 첫 번째 초안을 생성할 수 있으므로 팀은 빈 캔버스에서 시작할 필요 없이 바로 시각적 공동 작업으로 직행할 수 있습니다.

브레인스토밍이나 워크숍이 끝나면 에이전트는 반대 방향으로도 작업합니다. FigJam 보드를 읽고, 스티커와 주석에서 주요 테마, 결정 사항, 열린 질문을 추출하여 체계적인 다음 단계가 포함된 깔끔한 Notion 문서로 변환해 줍니다. 더 이상 스티커 메모를 수동으로 복사하여 붙여넣을 필요가 없습니다.

다음은 인기 있는 사전 구성된 MCP 도구가 커스텀 에이전트와 어떻게 작동할 수 있는지 보여주는 몇 가지 사용 사례입니다. 이러한 아이디어가 전부는 아니며, 가능한 사항을 탐색하기 위한 출발점일 뿐입니다.

• Linear: 프로젝트 진행 상황 요약, Notion 문서에서 이슈 생성, PRD를 체계적인 Linear 프로젝트로 변환

• GitHub: 새 PR 트래킹, 코드 변경 사항 요약, 보안 알림에서 이슈 생성, 주간 엔지니어링 상태 업데이트 생성

• Stripe: 청구서/결제 링크 생성, 고객과 구독, 청구서 조회, 환불과 분쟁 처리, 제품과 가격 관리

• Ramp: 부서/공급 업체별 지출 분석, 거래와 환급 트래킹, 한도 모니터링, 법인 카드 사용량 검토

• Amplitude: 정기 애널리틱스 리포트 생성, 실험 트래킹, 제품 인사이트를 가져와서 기획, 포지셔닝, 광고 문구에 반영

사전 구성된 MCP 연결은 팀이 이미 인기 있는 도구를 사용하는 경우에 유용합니다. 그러나 가장 중요한 워크플로의 대부분은 표준 SaaS 앱 외부에서 실행될 수 있습니다.

사용자 지정 MCP 서버를 사용하면 내부 API와 시스템을 비롯해 조직에서 실제로 실행하는 도구에 에이전트를 연결하고, 이를 Notion 워크플로 내에서 사용 가능한 작업으로 변환할 수 있습니다.

이 방법은 특히 업무가 다음과 같은 요소에 의존할 때 유용합니다.

• 내부 관리자 패널이나 운영 도구

• 데이터 플랫폼과 지표 계층

• 청구나 자격, 구독 시스템

• 인시던트 관리나 당직 엔지니어 호출 도구

• 재고나 운영, 독점 CRM

사용자 지정 MCP 서버를 추가하기 전에 워크스페이스 소유자나 관리자가 설정 → Notion AI → AI 커넥터 → 사용자 지정 MCP 서버 활성화하기에서 사용자 지정 연결을 활성화해야 합니다.

활성화되면 다음 절차를 따르세요.

• 에이전트의 설정을 열고 도구 및 사용 권한으로 이동하세요.

• 연결 추가를 클릭한 다음 사용자 지정 MCP 서버를 선택하세요.

• MCP 서버 URL과 표시 이름을 입력합니다.

• 필수 인증 상세정보를 추가하세요.

• 저장을 클릭하세요.

그 후에는 MCP 서버에서 노출하는 도구를 사전 구성된 연결과 마찬가지로 에이전트가 워크플로에서 사용할 수 있습니다.

사용자 지정 MCP 서버는 팀에 더 강력한 제어 기능과 안전성도 제공합니다. 에이전트가 수행할 수 있는 작업을 정확하게 제한하고, 서버 수준에서 권한을 적용하며, 테스트하는 동안 쓰기 작업이 승인 후에 진행되게 하고, 언제 어떤 작업이 실행되는지에 대해 명확한 감사 트래킹을 유지할 수 있습니다.

에이전트를 외부 도구와 MCP 서버에 연결할 때 기능만큼이나 안전성과 제어가 중요합니다. 이러한 모범 사례는 사용 권한을 제한하고, 변경 사항이 적용되기 전에 검토하며, 테스트에서 신뢰할 수 있는 자동화로 점진적으로 전환하는 데 도움이 됩니다.

• 검색, 리스트, 가져오기, 보기 등의 읽기 도구로 시작하여 명령어와 워크플로를 처음부터 끝까지 검증합니다.

• 쓰기 작업 활성화는 시작점이 아니라 이후의 마일스톤이라고 생각하세요.

도입하는 과정에서 다음 사항을 적용하세요.

• 각 변경 사항을 직접 검토할 수 있도록 쓰기 도구를 항상 묻기로 설정하세요.

• 자동화할 준비가 되면 도구를 한 번에 하나씩 자동으로 실행으로 전환하고 결과를 모니터링하세요.

워크플로에 실제로 필요한 도구만 활성화하세요.

• '만일의 경우를 대비해' 서버 전체의 도구 리스트를 노출하지 마세요.

• 가능하다면 특정 프로젝트나 팀에서 이슈를 생성하는 것과 같이 더 좁은 범위의 작업을 선택하세요.

• 사용자 지정 MCP 서버의 경우 필요한 작업과 필드 모음을 최소한으로 노출하세요.

에이전트 지침에 다음 내용을 명시하세요.

• 필수 필드, 수락 기준, 출처로 Notion에 연결되는 링크를 포함하여 '완료'의 기준을 설명합니다.

• 에이전트가 스스로 조치를 취해야 하는 경우와 추가 설명을 요청해야 하는 경우를 명시합니다.

• 승인 없이 이슈를 종결하거나 우선순위를 변경하지 않는 등 명확한 한도를 설정합니다.

효과적인 간단한 안전 수칙은 다음과 같습니다.

• 에이전트가 티켓 텍스트나 업데이트, 공지와 같은 콘텐츠를 초안으로 작성합니다.

• 인적 검토를 거쳐 승인합니다.

• 에이전트가 최종 작성 작업을 실행합니다.