설계 리뷰에서 정한 내용을 Confluence ADR로 남기는 법: SuperIntern MCP×Confluence 연동 실전 가이드

설계 리뷰는 결정으로 끝나지만, 그 안을 고른 이유와 다른 안을 버린 이유까지 Confluence에 남기는 팀은 드뭅니다. 반년쯤 지나 이유를 아는 사람이 팀을 떠나면 같은 논쟁을 처음부터 다시 하게 됩니다.

SuperIntern MCP와 Confluence를 AI 에이전트(Claude, ChatGPT)에 연결하면, 에이전트가 미팅 전사 기록을 읽고 검토한 선택지와 결정 이유를 정리한 아키텍처 결정 기록(ADR) 초안을 근거 발언과 함께 만듭니다. 내용을 확인해 승인하면 Confluence 페이지로 저장됩니다.

ChatGPT에도 Atlassian 공식 앱이 있지만, Confluence 페이지 생성과 업데이트를 지원하는지는 Atlassian 문서에서 확인되지 않습니다. ChatGPT로 지금 할 수 있는 범위는 설정 방법에서 설명합니다.

⚠️ 이 글은 2026년 10월 기준으로 공개된 정보와 사용자 피드백을 바탕으로 독자적으로 정리한 내용입니다.

설계 리뷰에서 ADR까지의 흐름

Before: 설계 리뷰에서 결론이 나도 회의록에는 "큐를 도입한다" 한 줄만 남습니다. ADR을 맡은 사람은 개발 일정에 쫓기고, 선택지를 비교한 내용과 다른 안을 버린 이유는 참석자들 기억에만 남습니다. 나중에 합류한 엔지니어가 왜 이런 구조냐고 물어도 답해 줄 사람이 없습니다.

After: 미팅이 끝나면 에이전트에게 오늘 설계 리뷰로 ADR을 써 달라고 합니다. 에이전트는 SuperIntern 전사 기록을 읽고 배경, 검토한 선택지, 결정, 이유, 후속 작업을 근거 발언과 함께 초안으로 정리합니다. 승인하면 ADR 상위 페이지 아래에 새 페이지가 생깁니다. 일주일에 한 번은 그 주의 미팅을 다시 읽혀 ADR로 남지 않은 결정을 찾습니다.

에이전트가 참조할 미팅은 SuperIntern으로 기록되어 있어야 합니다. SuperIntern은 회의에 봇을 초대하지 않는 데스크톱 회의 어시스턴트로, 전사 기록과 AI 회의록을 자동으로 남깁니다. 사내 설계 리뷰라도 미팅 쪽에서 따로 준비할 것은 없습니다.

SuperIntern

예시로 삼을 팀은 다음과 같습니다.

항목	내용
미팅	"알림 발송 설계 리뷰"(11/4)
참석자	김민지(테크 리드), 박준호(백엔드), 이도현(SRE), 최수아(PM)
안건	알림 지연 개선(현재 최대 15분)
저장 위치	Confluence 스페이스 "개발"의 상위 페이지 "아키텍처 결정 기록(ADR)" 아래

연동 구조

역할은 이렇게 나뉩니다.

역할	담당	하는 일
회의 데이터 제공	SuperIntern MCP	전사 기록, 실시간 전사, AI 회의록, 회의 노트를 읽기 전용으로 전달
판단과 초안 작성	AI 에이전트(Claude, ChatGPT)	논의에서 선택지와 결정 이유를 찾아 ADR 초안을 작성
저장	Confluence(Atlassian 공식 MCP 서버)	페이지 검색, 생성, 업데이트와 댓글 추가

MCP(Model Context Protocol) 는 AI 어시스턴트와 외부 도구를 안전하게 연결하는 표준 사양입니다. SuperIntern MCP는 회의 데이터를 읽기 전용으로 에이전트에 넘깁니다. 자세한 내용은 MCP 설정 가이드를 참고하세요.

Confluence 쪽은 Atlassian이 제공하는 공식 MCP 서버(Atlassian Rovo MCP Server)가 맡습니다. Confluence 페이지 검색, 조회, 생성, 업데이트와 댓글 작성을 지원하고, 같은 연결로 Jira도 다룹니다.

Confluence에 쓰는 주체는 SuperIntern이 아니라 에이전트입니다. 에이전트는 SuperIntern 데이터를 바꿀 수 없고 내가 볼 수 있는 회의만 읽으며, Confluence에서도 내가 편집할 수 있는 스페이스에만 씁니다.

설정 방법

연결할 대상은 SuperIntern과 Confluence 두 가지이고, 에이전트는 평소 쓰는 것을 고르면 됩니다. Claude는 두 서비스 모두 커넥터 목록에서 연결할 수 있고, 이 글의 프롬프트도 그대로 쓸 수 있습니다. ChatGPT는 페이지 검색과 조회(활용 3)는 바로 되지만, 페이지 생성과 업데이트(활용 1, 2)는 사용하는 환경에서 되는지 먼저 확인해야 합니다.

1. SuperIntern 연결하기

Claude: Settings > 왼쪽 아래 Customize > Connectors로 들어가 SuperIntern을 검색해 고릅니다. Claude 커넥터 목록의 SuperIntern에서 바로 열어도 됩니다. 커넥터 추가는 Claude 유료 플랜에서 할 수 있습니다.
ChatGPT: 사이드바의 플러그인에서 superintern을 검색하고, SuperIntern을 열어 플러그인 설치를 누릅니다. SuperIntern 플러그인 페이지에서 바로 열어도 됩니다. Codex 앱에서도 방법은 같습니다.

어느 쪽이든 SuperIntern 로그인 화면이 나오면 로그인한 뒤 접근을 허용합니다. 개인 워크스페이스는 Plus 플랜 이상이 필요하고, Enterprise는 관리자가 먼저 MCP 접근을 켜 두어야 합니다. 이용 조건과 Claude Code, Cursor 등 다른 클라이언트의 설정은 MCP 설정 가이드에 정리해 두었습니다.

2. Confluence 연결하기

Claude: 같은 Connectors 검색창에 Atlassian을 입력해 Atlassian 공식 "Atlassian MCP" 커넥터를 추가하고, Atlassian 계정으로 로그인합니다. Jira 이슈와 Confluence 페이지의 검색, 조회, 생성, 업데이트를 지원합니다.
ChatGPT: 플러그인에서 Atlassian을 검색해 Atlassian 공식 앱 "Atlassian Rovo"를 연결하고, Atlassian 계정으로 로그인합니다. Atlassian 발표에서는 Confluence 페이지 요약과 조회, Jira 이슈 생성과 업데이트를 소개하고 있습니다. 에이전트가 Confluence 페이지를 만들지 못하면 초안만 받아 Confluence에 직접 붙여 넣으세요.
Claude Code: claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp 를 실행하고, Claude Code 안에서 /mcp 로 Atlassian에 로그인합니다.

로그인 도중에 연결할 Atlassian 사이트를 고르는 화면이 나옵니다. Atlassian 권한이 그대로 적용되므로, 페이지를 만들려면 해당 스페이스의 생성 권한이 있어야 합니다. Claude와 ChatGPT 연결은 기본적으로 허용되어 있지만, Atlassian 조직 관리자가 MCP 서버 사용을 제한했다면 연결되지 않습니다. Claude Team과 Enterprise 플랜에서는 조직 소유자가 먼저 커넥터를 추가해야 구성원이 쓸 수 있습니다.

연결이 끝나면 양쪽 데이터를 제대로 가져오는지 확인합니다.

이번 주 SuperIntern 회의 중 "개발" 프로젝트에 들어 있는 회의와,
Confluence 스페이스 "개발"의 "아키텍처 결정 기록(ADR)" 아래 하위 페이지 목록을 알려 줘

두 목록이 모두 나오면 준비가 끝났습니다.

활용 1: 설계 리뷰가 끝나는 즉시 ADR 초안 만들기

설계 리뷰가 끝난 직후에 쓰는 게 가장 좋습니다. 프롬프트에서는 ADR 섹션을 지정하고, 채택하지 않은 안의 탈락 이유도 함께 적도록 요청합니다.

오늘 "알림 발송 설계 리뷰"의 전사 기록과 AI 회의록을 읽고,
Confluence 스페이스 "개발"의 상위 페이지 "아키텍처 결정 기록(ADR)" 아래에 넣을 ADR 초안을 만들어 줘.
- 번호는 기존 ADR의 다음 번호로 하기
- 섹션: 배경 / 검토한 선택지(표: 장점, 우려, 제안한 사람) / 결정 /
  결정 이유 / 후속 작업 / 미결 사항
- 채택하지 않은 안은 탈락 이유를 근거 발언과 함께 쓰기
- 미팅에서 정해지지 않은 내용은 "미정"으로 표시하기
먼저 초안을 보여 주고, 내가 승인하면 페이지를 만들어 줘.

에이전트는 기존 ADR 번호를 확인한 뒤 초안을 돌려줍니다.

"ADR-014 알림 발송에 큐 도입" 초안입니다.

배경: 알림은 5분마다 도는 배치 작업으로 발송하며, 발송까지 최대 15분이 걸립니다. 최수아: "예약 확정 알림이 느리다는 문의가 주 20건쯤 들어옵니다."

검토한 선택지

선택지 장점 우려 제안한 사람
A. 배치를 1분마다 실행 변경 범위가 작음 발송량이 늘면 실행이 겹치기 시작함 박준호
B. 큐(Amazon SQS)와 워커로 발송 1분 안에 발송, 실패 건만 재시도 모니터링 대상이 늘어남 김민지
C. 외부 알림 서비스 사용 코드를 거의 쓰지 않음 개인정보를 외부 업체에 보내게 되어 보안 심사가 필요함 최수아

결정: B안을 채택합니다.

결정 이유: A안은 내년 예상 발송량에서 실행이 겹칩니다(박준호: "1월이면 한 번 도는 데 1분이 넘습니다."). C안은 보안 심사에 약 2개월이 걸려 올해 안에 개선하기 어렵습니다(최수아: "심사만 2개월은 잡아야 합니다.").

후속 작업: 워커 구현(박준호, 11/18) / 큐와 실패 알림 설정(이도현, 11/20) / 배치 작업 종료 계획 수립(김민지, 12월)

미결 사항: 알림 종류별 우선순위를 둘지 여부(다음 정기 회의에서 결정)

이 내용으로 페이지를 만들까요?

선택지	장점	우려	제안한 사람
A. 배치를 1분마다 실행	변경 범위가 작음	발송량이 늘면 실행이 겹치기 시작함	박준호
B. 큐(Amazon SQS)와 워커로 발송	1분 안에 발송, 실패 건만 재시도	모니터링 대상이 늘어남	김민지
C. 외부 알림 서비스 사용	코드를 거의 쓰지 않음	개인정보를 외부 업체에 보내게 되어 보안 심사가 필요함	최수아

OK라고 답하면 "아키텍처 결정 기록(ADR)" 아래에 새 페이지가 생깁니다. 페이지 맨 위에 출처 미팅과 날짜를 넣어 달라고 해 두면, 누구든 결정에서 전사 기록까지 거슬러 올라갈 수 있습니다.

선택지와 결정 이유가 정리된 Confluence ADR 페이지

탈락 이유가 페이지에 남아 있으니, 나중에 누가 "외부 서비스를 쓰면 더 쉽지 않나요?"라고 물어도 보안 심사 기간이라는 답이 이미 적혀 있습니다.

활용 2: ADR로 남지 않은 결정을 매주 찾기

아키텍처에 영향을 주는 결정은 설계 리뷰가 아닌 정기 회의에서도 나옵니다. 일주일에 한 번 그 주의 미팅을 한꺼번에 읽혀 ADR 목록과 대조합니다.

이번 주(11/2~11/6) SuperIntern 회의 중 "개발" 프로젝트에 들어 있는 회의를 모두 읽고,
Confluence "아키텍처 결정 기록(ADR)" 아래 하위 페이지와 맞춰 봐 줘.
- 미팅에서 정해졌는데 ADR이 없는 결정
- 기존 ADR의 내용을 바꾸거나 대체하는 결정
을 결정 / 미팅 / 관련 ADR / 제안 조치 / 근거 발언 표로 정리해 줘.
내가 승인한 행만 ADR 초안을 만들고 기존 페이지를 업데이트해 줘.

에이전트는 미팅에서 나온 결정과 기존 ADR을 대조한 표를 보여 줍니다.

이번 주 ADR과 관련된 결정이 3건 있었습니다.

결정 미팅 관련 ADR 제안 조치 근거 발언
관리 화면 API를 REST로 통일 11/5 API 정기 회의 없음 ADR-015 신규 작성 김민지: "새로 만드는 화면은 전부 REST로 갑시다."
알림 재시도는 최대 3회, 간격은 매번 2배로 11/6 개발 정기 회의 ADR-014 "결정"에 추가 박준호: "3번 실패하면 데드레터 큐로 보냅니다."
로그를 파일 대신 표준 출력으로 11/6 개발 정기 회의 ADR-009 ADR-016 신규 작성, ADR-009는 "대체됨"으로 변경 이도현: "이제 컨테이너니까 파일 로그는 없앱니다."

3건 모두 반영할까요?

결정	미팅	관련 ADR	제안 조치	근거 발언
관리 화면 API를 REST로 통일	11/5 API 정기 회의	없음	ADR-015 신규 작성	김민지: "새로 만드는 화면은 전부 REST로 갑시다."
알림 재시도는 최대 3회, 간격은 매번 2배로	11/6 개발 정기 회의	ADR-014	"결정"에 추가	박준호: "3번 실패하면 데드레터 큐로 보냅니다."
로그를 파일 대신 표준 출력으로	11/6 개발 정기 회의	ADR-009	ADR-016 신규 작성, ADR-009는 "대체됨"으로 변경	이도현: "이제 컨테이너니까 파일 로그는 없앱니다."

새 ADR이 추가되고 이전 ADR이 대체됨으로 바뀐 Confluence ADR 목록

승인하면 "ADR-015 관리 화면 API를 REST로 통일"과 "ADR-016 로그를 파일 대신 표준 출력으로" 초안이 만들어지고, ADR-014에는 재시도 정책이 추가됩니다. "ADR-009 로그를 파일로 출력"은 상태가 "대체됨"으로 바뀌고 ADR-016 링크가 붙습니다. 확정으로 바꾸기 전에 담당자가 초안을 한 번 읽어 보세요.

활용 3: 미팅 도중에 관련된 과거 결정 찾기

SuperIntern MCP는 진행 중인 회의의 실시간 전사도 읽을 수 있습니다. 직전 요청 이후에 추가된 부분만 가져오므로 미팅 중에 여러 번 요청해도 오래 걸리지 않습니다.

논의가 예전 결정과 부딪히는 것 같을 때 이렇게 요청합니다.

지금 진행 중인 "알림 관련 논의"의 실시간 전사(지난번 이후 차이분)를 읽고,
Confluence "아키텍처 결정 기록(ADR)"에서 지금 논의와 관련된 과거 ADR을 검색해 줘.
오늘 논의와 충돌하는 결정이 있으면 그 이유와 함께 알려 줘.
Confluence에는 아무것도 쓰지 마.

에이전트는 최신 대화와 Confluence 검색 결과를 합쳐 답합니다.

지금은 워커에서 메일 알림을 직접 보내는 방안을 논의하고 있습니다. 관련 ADR은 2건입니다.

ADR-006 메일은 외부 발송 서비스로만 보냄(2025년 6월): 발신 도메인의 평판을 지키기 위해 메일은 발송 서비스로만 보냅니다. 오늘 제안은 이 결정과 충돌합니다.

ADR-014 알림 발송에 큐 도입(11/4): 워커가 큐에서 알림을 가져오지만, 메일을 보내는 방법은 이 ADR에서 정하지 않았습니다.

논의를 정리하려면 이 점을 확인해야 합니다. "ADR-006을 다시 검토하는 건가요, 아니면 워커가 발송 서비스를 호출하는 형태로 가나요?"

이 활용은 Confluence 페이지를 검색하고 조회하기만 하므로 ChatGPT에서도 쓸 수 있습니다.

운영 팁

Confluence에 ADR 템플릿을 만들어 둡니다. 섹션이 정해진 템플릿 페이지가 있으면 에이전트가 그 페이지를 읽고 같은 구성으로 초안을 씁니다. 프롬프트에 "'ADR 템플릿' 페이지와 같은 구성으로"처럼 페이지 이름만 적으면 됩니다.

마지막에 결론을 소리 내어 말합니다. "그럼 리뷰 일정을 고려해서 B안으로 가겠습니다"처럼 한 번 말해 두면 결정과 이유가 전사 기록에 분명히 남습니다. 고개만 끄덕이고 넘어간 합의는 에이전트가 결정으로 읽어 내지 못합니다.

개발 미팅을 SuperIntern 프로젝트로 묶어 둡니다. 개발 관련 미팅을 한 프로젝트에 모아 두면 활용 2처럼 기간과 프로젝트로 회의를 좁힐 수 있습니다.

저장하기 전에 초안을 확인합니다. 이 글의 프롬프트는 모두 초안을 먼저 보여 주고, 승인을 받은 뒤에 씁니다. ADR은 몇 년씩 읽히는 문서이니 승인 전에 담당자가 결정과 이유의 표현을 살펴보세요.

권한 범위는 나와 같습니다. 에이전트는 SuperIntern에서 내가 볼 수 있는 회의만 읽고, Confluence에서도 내가 편집할 수 있는 스페이스에만 씁니다. SuperIntern에 무언가를 쓰는 일은 없습니다.

서비스 이름을 사용자 사전에 등록합니다. 서비스 이름과 사내 약어가 전사 기록에 정확히 남아야 ADR도 정확해집니다. 자주 나오는 용어는 SuperIntern 사용자 사전에 넣어 두세요.

다른 도구와 조합하기

SuperIntern MCP가 회의 데이터를 넘기면 에이전트가 판단해 다른 도구에서 실행하는 구조는 어떤 도구와 조합해도 같습니다.

Linear: ADR의 후속 작업을 개발 작업으로 등록하려면 Linear 편
Claude Code: 결정한 내용을 바로 구현으로 이어 가려면 Claude Code 편
Notion: 미팅 기록을 데이터베이스로 모아 두려면 Notion 편
Miro: 미팅에서 설명한 아키텍처를 다이어그램으로 만들려면 Miro 편

자주 묻는 질문

무료 플랜에서도 SuperIntern MCP를 쓸 수 있나요?

쓸 수 없습니다. 개인 워크스페이스는 Plus 플랜 이상이 필요합니다. Team 플랜은 별도 설정 없이 쓸 수 있고, Enterprise 플랜은 관리자가 워크스페이스 설정에서 "MCP 접근"을 켜 두어야 합니다.

SuperIntern이 Confluence에 쓰는 건가요?

아닙니다. 페이지 생성과 업데이트는 에이전트가 Atlassian 공식 MCP 서버를 통해 처리합니다. SuperIntern MCP는 회의 데이터를 읽기 전용으로 넘기기만 합니다.

ChatGPT에서도 똑같이 할 수 있나요?

일부만 됩니다. ChatGPT 플러그인에 Atlassian 공식 앱 "Atlassian Rovo"가 있어 활용 3처럼 과거 페이지를 검색하고 조회할 수 있습니다. Confluence 페이지 생성과 업데이트는 Atlassian 문서에서 확인되지 않으므로, 활용 1과 2는 에이전트가 만든 초안을 Confluence에 직접 붙여 넣어야 할 수도 있습니다.

ADR 형식이 정해져 있어야 하나요?

아닙니다. 형식을 지정하지 않으면 에이전트는 활용 1 프롬프트에 적은 섹션대로 작성합니다. 팀에서 쓰는 형식이 있다면 프롬프트에 템플릿 페이지 이름을 적어 주세요.

Jira 이슈도 만들 수 있나요?

만들 수 있습니다. Atlassian 공식 MCP 서버는 Jira도 지원하므로, 같은 연결에서 ADR 후속 작업을 Jira 이슈로 등록해 달라고 요청하면 됩니다. 프롬프트에 프로젝트와 이슈 유형을 함께 적어 주세요.

Notion 편과는 무엇이 다른가요?

Notion 편은 모든 미팅 기록을 데이터베이스로 모으는 방법을 다룹니다. 이 글은 개발 의사결정에 초점을 두고, 검토한 선택지와 탈락 이유를 ADR로 남기는 방법을 설명합니다.

다음 설계 리뷰에서는 SuperIntern 녹음을 끝내기 전에 결정과 그 이유를 소리 내어 말해 보세요. 미팅이 끝나고 몇 분 뒤면 다른 안의 탈락 이유까지 담긴 ADR 초안이 Confluence에 저장할 수 있는 상태로 준비됩니다.

SuperIntern 무료 체험하기

목차