MCP 연동

에이전트 앱을 ESTnote Space에 연결해 페이지와 데이터베이스를 읽고 쓰는 방법입니다.

MCP(Model Context Protocol) 연동으로 에이전트 앱이 ESTnote의 페이지를 찾고 읽거나, 데이터베이스를 조회하고 문서를 작성할 수 있습니다. 연결한 사람의 ESTnote 권한 안에서만 동작합니다.

연결하기

ESTnote에서 연결할 Space의 Space 설정 → 에이전트를 엽니다.
Space 소유자 또는 관리자가 에이전트 연결(MCP) 허용을 켭니다. 읽기만 필요하면 에이전트의 쓰기 허용은 꺼 두세요. 생성·편집·댓글 추가가 필요할 때만 켭니다.
같은 화면의 연결 주소를 복사해 에이전트 앱의 커넥터 또는 MCP 서버 추가 화면에 입력합니다. 연결 방식을 묻는 앱에서는 Streamable HTTP를 선택합니다.
로그인 연결을 지원하는 앱은 ESTnote 로그인과 동의 화면을 엽니다. 사용할 계정으로 로그인하고 연결할 Space와 권한을 확인해 승인합니다. 동의 화면의 쓰기 권한은 처음에 꺼져 있습니다.
ESTnote의 연결된 앱에 표시되는지 확인하고, 먼저 페이지 검색이나 조회를 요청해 연결을 확인합니다.

앱별 설정 순서는 Space 설정 → 에이전트의 연결 안내를 펼쳐 확인하세요. 로그인 연결에서는 API 토큰을 직접 붙여 넣을 필요가 없습니다.

할 수 있는 일과 권한

작업	예시
읽기	페이지 검색·목록·본문 읽기, 데이터베이스 구조와 항목 조회
쓰기	페이지·데이터베이스 항목 생성, 본문·제목·속성 수정, 댓글 추가
휴지통 이동	잘못 만든 페이지나 임시 문서를 하위 페이지와 함께 휴지통으로 이동. 영구 삭제는 하지 않습니다

쓰기는 Space의 쓰기 허용, 연결에 승인한 쓰기 범위, 연결한 사용자의 해당 페이지 편집 권한이 모두 필요합니다. 연결했다고 다른 사람의 개인 문서나 접근할 수 없는 페이지가 공개되지는 않습니다. 페이지 본문을 수정하기 전에는 되돌릴 버전이 자동으로 남습니다. 휴지통 이동은 연결한 사용자가 그 페이지를 휴지통으로 옮길 수 있을 때만 되고, 옮긴 페이지는 ESTnote의 휴지통에서 복원합니다. 에이전트가 페이지를 영구 삭제하는 방법은 없습니다.

기존 팀 문서를 데이터베이스 항목으로 옮길 때는 에이전트가 항목을 만들면서 원래의 작성자와 작성일자를 정할 수 있습니다. 이 값은 항목의 만든 사람·만든 시각이 됩니다. 작성자는 이 Space의 구성원(손님 제외)을 이메일이나 이름으로 고르고, 작성일자는 지금보다 나중일 수 없으며, 시간대가 없으면 한국 시간으로 봅니다. 만든 사람은 자기 항목을 휴지통으로 보내거나 옮길 수 있게 되므로, 이 값은 Space 소유자·관리자가 연결한 에이전트만 정할 수 있습니다.

예를 들어 “이 Space에서 출시 계획 페이지를 찾아 요약해 줘”로 읽기를 확인하고, 쓰기가 허용된 경우 “이 프로젝트 아래에 회의록 페이지를 만들어 줘”처럼 요청할 수 있습니다.

API 토큰으로 연결하는 앱

로그인 연결을 지원하지 않는 앱은 계정 설정 → API 토큰과 웹훅에서 토큰을 만들어 사용합니다. 토큰을 만들 때 대상 Space와 필요한 범위를 선택하고, 앱이 제공하는 인증 설정에 넣으세요. Space의 MCP 허용 설정도 켜져 있어야 합니다.

토큰은 만든 사람의 권한으로 동작합니다. 조직 전체가 공유하는 인증 헤더에 넣지 마세요. 토큰 연결은 연결된 앱 목록이 아니라 계정 설정 → API 토큰과 웹훅에서 철회합니다. 공개 API 사용법은 API 레퍼런스를 참고하세요.

활동 확인과 연결 해제

Space 설정 → 에이전트 → 에이전트 활동에서 요청 도구와 결과를 확인합니다. 기록은 90일 동안 보관되며, 읽거나 쓴 내용 자체는 기록하지 않습니다.
본문 변경에 되돌릴 버전이 있으면 버전 기록에서 되돌리기로 확인합니다.
연결된 앱에서 해당 연결을 철회할 수 있습니다. 소유자와 관리자는 Space 전체 보기로 조직 내 해당 Space의 연결을 관리할 수 있습니다.
에이전트 연결(MCP) 허용을 끄면 기존 연결도 즉시 멈춥니다. 에이전트의 쓰기 허용만 끄면 읽기는 유지하고 생성·편집·댓글·휴지통 이동 도구를 비활성화합니다.

문제가 생기면

연결되지 않음: Space의 MCP 허용 여부와 복사한 연결 주소를 확인하세요. 앱이 서버의 연결·인증 방식을 지원하는지도 확인합니다.
페이지가 검색되지 않음: 올바른 계정과 Space로 연결했는지, ESTnote에서 직접 그 페이지를 열 수 있는지 확인하세요.
읽기는 되지만 쓰기가 안 됨: Space의 쓰기 설정, 연결에 승인한 권한과 해당 페이지의 편집 권한을 각각 확인하세요. 읽기 전용으로 승인했다면 필요한 쓰기 권한을 포함해 다시 연결합니다.
요청 실패: 에이전트 활동의 결과를 확인하세요. 속도 제한이면 잠시 뒤 다시 시도하고, 철회된 연결이면 다시 로그인해 연결합니다.