Notion의 MCP 도구 「notion-get-async-task」가 Changelog에서 삭제된 건

2026년 6월 29일, Notion 공식 Changelog에서 비동기 태스크 (asynchronous task) 상태 모니터링에 사용하는 MCP 도구 「notion-get-async-task」의 설명 엔트리(26행)가 삭제된 것이 확인되었습니다.

이 도구는 notion-duplicate-page나 notion-create-pages를 allow_async: true로 호출했을 때 생성되는 비동기 태스크의 진행 상황을 가져오기 위한 것입니다. 추가나 수정이 아닌 삭제만이 검출되었으며, 기능의 철회, 사양 변경, 또는 재편 중 하나가 일어나고 있을 가능성이 있습니다.

비동기 처리를 동반하는 Notion 자동화 워크플로우를 구축하고 있는 경우, 이 도구에 대한 의존 부분을 조속히 확인해야 합니다.

📌 영향을 받는 사람

• notion-get-async-task를 사용하여 비동기 태스크의 폴링 (polling) 처리를 구현하고 있는 개발자
• notion-duplicate-page 또는 notion-create-pages를 allow_async: true로 호출하고 있는 워크플로우 관리자
• Notion MCP 연동을 포함한 AI 에이전트를 구축·운용하고 있는 엔지니어

이번 변경과 영향을 받는 API/도구의 관계를 정리합니다.

⚠️ Breaking Change

notion-get-async-task의 Changelog 엔트리가 삭제됨으로써, 이 도구의 향후 제공 지속이 보장되지 않는 상태가 되었습니다. 현재도 동작할 가능성은 있지만, 공식 문서에서 설명이 사라진 시점에서 의존 구현의 리스크는 높아지고 있습니다.

항목	내용
도구 이름	notion-get-async-task
...

삭제 전의 Changelog에는 다음과 같은 사양이 기재되어 있었습니다.

취득 가능한 상태(status) 목록:

상태	의미
queued	태스크가 큐(queue) 대기 중
running	태스크 실행 중
retrying	재시도(retry) 중
succeeded	태스크 완료, 결과 있음
failed	태스크 실패, 에러 있음

폴링 (polling) 메커니즘:

• 기존 도구 (notion-duplicate-page 등)의 async_task 응답 내의 task_id를 인수로 전달 - 응답에 포함된 **권장 백오프 간격 (recommended backoff interval)**에 따라 폴링을 반복 - 성공 시에는 처리 결과, 실패 시에는 에러 정보가 반환됨

• 공식 문서를 확인하세요
  Notion 공식 최신 문서 및 MCP 서버의 릴리스 노트를 통해 notion-get-async-task의 현재 상태를 확인하십시오. Changelog의 엔트리는 없어졌지만 API 엔드포인트 자체가 즉시 폐지된 것은 아닐 수 있습니다. -
  의존 부분을 리스트업하세요
  코드베이스 내에서 notion-get-async-task를 호출하고 있는 곳을 모두 찾아내십시오. -
  폴백 (fallback)을 구현하세요
  도구를 사용할 수 없게 된 경우에 대비하여, 에러 핸들링과 폴백 처리를 추가해 두는 것을 강력히 권장합니다. -
  동기 모드로의 전환을 검토하세요
  allow_async: true를 사용하지 않고 동기 실행으로 완결하는 것이 가능하다면, 일시적으로 그쪽으로 전환함으로써 리스크를 회피할 수 있습니다.

💡 Tips

Notion MCP 서버는 오픈 소스 (@notionhq/notion-mcp-server)로 제공되는 경우도 있습니다. GitHub 리포지토리의 Issue나 PR을 확인하면 삭제 배경이나 향후 방침에 관한 정보를 얻을 수 있는 경우가 있습니다.

삭제된 Changelog에 기반한 기존의 비동기 태스크 모니터링 구현 예시입니다.

// 비동기로 페이지를 복제하고, 완료까지 대기함 (구 패턴)
async function duplicatePageAndWait(pageId: string): Promise<any> {
// 1. 비동기로 페이지 복제 시작
...

notion-get-async-task를 사용할 수 없는 경우를 고려한 패턴입니다.

async function duplicatePageSafely(pageId: string): Promise<any> {
// 우선 동기 모드로 시도 (allow_async를 사용하지 않음)
try {
...

💡 Tips

장기적으로는 폴링 로직 (Polling logic)을 래퍼 함수 (Wrapper function)에 캡슐화해 두면, 도구 사양이 변경되었을 때 수정해야 할 부분을 최소한으로 줄일 수 있습니다.

항목	내용
변경 종류	문서 엔트리 삭제 (비권장(Deprecation) 암시)
...	notion-get-async-task, notion-duplicate-page, notion-create-pages
대응 기한	조속한 확인 권장 (지속 제공 보장 없음)
권장 액션	공식 확인 → 의존 부분 특정 → 폴백 (Fallback) 구현

notion-get-async-task는 Notion의 비동기 페이지 조작을 다루는 데 있어 중요한 역할을 담당하던 도구입니다. Changelog에서 엔트리가 삭제된 지금, 이 도구에 대한 의존을 그대로 유지하는 것은 리스크를 수반합니다.

공식 문서나 @notionhq/notion-mcp-server 리포지토리를 정기적으로 체크하며, 대체 수단이나 공식 발표를 기다리는 동시에, 폴백 (Fallback)을 갖춘 구현으로 전환할 것을 강력히 권장합니다.