MCP

Model Context Protocol(MCP)을 사용하여 Craft를 AI 어시스턴트 및 개발자 도구와 연결하세요.

Craft는 MCP(Model Context Protocol)을 지원하여 Craft 문서를 외부 도구에 안전하게 연결할 수 있습니다. 이를 통해 호환되는 앱(예: AI 어시스턴트 및 개발자 도구)이 사용자가 공유하기로 선택한 콘텐츠를 읽고 처리할 수 있습니다.

​

MCP란 무엇인가?

MCP(Model Context Protocol)는 외부 애플리케이션이 특정 정보 출처에 연결할 수 있게 해주는 표준입니다. Craft에서는 MCP를 통해 이러한 도구들이 선택한 콘텐츠에 대해 제어된 접근 권한을 얻어 안전하게 읽고 처리하며 작업할 수 있도록 합니다.

MCP를 활성화하면 외부 도구는 다음을 할 수 있습니다:

• Craft 문서의 내용을 읽을 수 있습니다
• 요약, 인사이트 또는 변환을 생성할 수 있습니다
• 작성 또는 구조 재구성 작업을 지원할 수 있습니다
• 문서를 실시간 지식 소스로 사용할 수 있습니다
• 선택한 문서 내에서 검색할 수 있습니다

이로써 수동으로 내보내거나 복사해 붙여넣을 필요가 없어집니다.

​

Craft에서의 MCP 작동 방식

sidebar의 Imagine 탭에서 MCP 연결을 생성하여 작업 공간의 적절한 부분을 외부 도구와 공유하세요.

다음 중 하나를 선택할 수 있습니다:

• 모든 데일리 노트를 포함하는 MCP 연결을 생성하거나
• 특정 문서(하나 이상)를 선택해 포함하는 맞춤 연결을 설정합니다

각 연결에서 접근 권한 및 표시 설정을 정의할 수 있으므로 공유되는 항목을 항상 제어할 수 있습니다. 연결을 생성하면 Craft가 해당 연결에 대해 고유한 MCP 엔드포인트를 자동으로 생성합니다. 그런 다음 이 엔드포인트를 MCP 호환 도구에 추가하면 선택한 문서에만 안전하게 연결할 수 있으며 작업 공간의 다른 항목은 비공개로 유지됩니다.

Craft MCP 서버는 이제 고급 기능을 포함한 전체 스페이스 수준 액세스를 지원합니다:

• 폴더, 태그, 날짜 필터를 사용해 모든 문서에서 검색할 수 있습니다
• 데일리 노트와 할 일에 MCP로 완전하게 접근할 수 있습니다
• 문서를 프로그래밍 방식으로 생성, 업데이트 및 삭제할 수 있습니다
• 스키마 생성 및 편집을 포함한 컬렉션 관리가 가능합니다
• 정규식 지원 및 시간대 인식 날짜 필터를 갖춘 고급 검색을 제공합니다
• 재귀적 하위 폴더를 지원하는 폴더 기반 구성을 제공합니다

자세한 내용은 공식 MCP 문서를 참조하세요.

Craft에서 MCP 연결을 생성한 후 Imagine 탭에서 생성된 MCP 링크 또는 자격 증명을 복사하세요. 다음 단계는 Craft 외부에서 진행됩니다.

사용하려는 MCP 호환 도구(예: AI 어시스턴트 또는 개발 환경)를 열고, MCP 서버 또는 커넥터를 추가하는 옵션을 찾아 복사한 정보를 붙여넣으세요. 그 시점부터 해당 도구는 설정한 권한에 따라 해당 연결에 포함된 노트나 문서만 접근할 수 있습니다.

​

지원되는 MCP 연결

현재 Craft는 다음과 같은 MCP 통합을 지원합니다:

• Claude (Desktop 및 Claude Code)
• ChatGPT
• Windsurf
• Cursor
• Visual Studio Code
• Raycast
• 기타 표준 MCP 클라이언트

이들 도구는 Craft 문서에 직접 연결하여 문서의 내용을 읽고 지원할 수 있습니다.

​

MCP로 할 수 있는 작업

MCP를 활성화하면 다음을 수행할 수 있습니다:

• AI 어시스턴트에게 문서를 분석하거나 요약하도록 요청할 수 있습니다
• Craft 문서를 기반으로 콘텐츠를 생성하거나 재작성할 수 있습니다
• 개발자 도구를 사용해 Craft 콘텐츠로 맞춤 워크플로우나 스크립트를 만들 수 있습니다
• VS Code, Cursor, Windsurf 같은 코딩 환경에서 문서와 상호작용할 수 있습니다
• 문서를 프로그래밍 방식으로 검색하고 필터링할 수 있습니다
• 자체 MCP 호환 도구나 자동화를 통해 Craft를 확장할 수 있습니다

MCP를 통해 좋아하는 AI 및 개발자 도구와 Craft를 원활하게 결합할 수 있습니다.

​

전체 가이드 및 문서

모든 설정 지침과 통합 가이드는 다음에서 확인할 수 있습니다:

👉 https://www.craft.do/imagine/

여기에서 Claude, ChatGPT 및 기타 지원되는 MCP 도구에 대한 전용 가이드를 확인할 수 있습니다.

​

문제 해결

Craft와 MCP 클라이언트 간의 연결 문제가 발생하는 경우(특히 자주 업데이트되는 Claude 같은 도구를 사용할 때), 다음 단계를 통해 대부분 해결할 수 있습니다:

1. 재연결

   클라이언트 앱에서 MCP 서버를 연결 해제한 후 다시 연결해 보세요.

2. 커넥터 재생성

   재연결이 도움이 되지 않는다면, 클라이언트 앱에서 MCP 커넥터를 제거하고 동일한 링크를 사용하여 다시 설정하세요.

3. Craft에서 링크 재생성

   문제가 계속되면, Craft의 Imagine 탭에서 MCP 연결을 삭제하고 새로 만드세요. 그런 다음 새 링크를 클라이언트 앱에 추가하세요.

일부 MCP 클라이언트는 매우 자주 업데이트를 배포하며, 이로 인해 기존 연결이 끊어질 수 있습니다. 위 단계로 대부분의 문제를 해결할 수 있지만, 드문 경우에는 클라이언트 앱의 수정을 기다려야 할 수도 있습니다.

MCP 보안

MCP 보안 기능 및 접근 제어에 대해 알아보세요

ChatGPT 제한 사항

ChatGPT와 MCP를 사용할 때의 현재 제한 사항을 이해하세요