Notit MCP 연결 가이드
시작하기 전
MCP는 AI 앱이 외부 데이터와 도구에 연결할 수 있게 하는 개방형 표준입니다. Notit을 연결하면 AI 어시스턴트가 허용된 학습 자료를 읽고 질문에 활용할 수 있습니다. 더 알아보려면 MCP 공식 소개를 참고하세요.
- Notit 계정과 학습 자료: 사용할 계정으로 로그인하고, 조회할 과목·강의·노트가 Notit에 있는지 확인하세요.
- 지원 클라이언트: 원격 HTTP MCP 서버를 지원하는 AI 앱이 필요합니다. OAuth 로그인 또는 사용자 지정 인증 헤더 중 사용할 방식을 지원해야 합니다. 설정 메뉴 이름과 이용 조건은 클라이언트에 따라 다릅니다.
- Notit 플랜: 모든 플랜에서 연결할 수 있지만, MCP로 학습 데이터를 읽으려면 Plus 또는 Pro가 필요합니다. Notit 플랜 보기
어떤 방법을 선택하면 되나요? 클라이언트가 Notit 로그인 화면을 열어주면 OAuth를 사용하세요. 토큰이나 HTTP 인증 헤더를 직접 입력해야 한다면 수동 토큰 절차를 따라 하세요.
OAuth로 연결하기 · 권장
Notit에 로그인하고 읽기 권한을 승인하는 방식입니다. 수동 MCP 토큰을 발급하거나 Notit의 MCP 스위치를 켤 필요가 없습니다.
- AI 앱에서 원격 MCP 서버를 추가하는 설정을 엽니다. 이름이 필요하면 Notit을 입력하세요.
- 서버 주소에 아래 URL을 입력하고 연결을 시작합니다.
https://mcp.notit.ai/mcp
- Notit 로그인 화면이 열리면 학습 자료가 있는 계정으로 로그인합니다.
- 요청한 클라이언트와 콜백 호스트를 확인하고, 허용할 읽기 권한을 하나 이상 선택합니다. 권한별로 읽을 수 있는 정보는 권한 표에서 확인할 수 있습니다.
- 연결을 누른 뒤 AI 앱으로 돌아갑니다. 대화에서 Notit 도구를 사용할 수 있도록 선택하거나 활성화합니다.
연결 후 첫 질문으로 데이터 조회까지 확인하세요. OAuth 연결은 Notit의 내 정보 → 연동 → MCP → 세부 설정 → 연결된 앱에서 확인할 수 있습니다.
수동 토큰으로 연결하기
사용자 지정 HTTP 인증 헤더나 Bearer 토큰을 지원하는 클라이언트에서 사용하세요.
- Notit에서 내 정보 → 연동 → MCP로 이동해 MCP 스위치를 켭니다. 토큰 발급이 끝날 때까지 기다리세요.
- 세부 설정을 열고 토큰 권한에서 필요한 읽기 권한을 하나 이상 선택합니다. MCP가 켜진 상태에서 권한을 바꾸면 새 토큰이 자동으로 발급됩니다.
- AI 앱에 원격 MCP 서버를 추가하고, endpoint 복사로 복사한 아래 주소를 입력합니다.
https://mcp.notit.ai/mcp
- Notit의 인증 헤더 복사로 복사한 값을 클라이언트의 HTTP 인증 설정에 입력합니다. 직접 입력한다면 아래 자리표시자를 발급된 토큰으로 바꾸세요.
Authorization: Bearer <발급된 토큰>
- 헤더 이름과 값을 나눠 입력하는 경우: 이름은
Authorization, 값은Bearer <발급된 토큰>입니다. - 별도의 Bearer token 입력란인 경우:
Bearer접두사 없이 토큰만 입력합니다.
- 설정을 저장하고 연결한 뒤 첫 질문을 보내세요.
토큰은 AI 대화창이 아닌 클라이언트의 인증 설정에 입력하세요. Notit에 표시된 만료일을 확인하고, 권한 변경 등으로 새 토큰을 발급받으면 클라이언트에 저장된 인증 정보도 바꿔주세요.
연결 확인과 첫 질문
먼저 “Notit에서 내 과목 목록을 불러와줘.”라고 요청하세요. 실제 과목이 조회되면 원하는 과목과 강의를 지정해 이어서 질문할 수 있습니다.
- 과목 목록에서 원하는 과목을 고릅니다.
- “열역학 과목의 강의 목록을 보여줘.”처럼 조회할 강의를 찾습니다.
- 강의 이름이나 날짜를 지정해 노트를 읽거나 녹취록을 요약하도록 요청합니다.
위 예시의 과목명과 날짜를 본인의 자료에 맞게 바꿔주세요. 과목·강의 목록 조회에는 각각 과목·강의 읽기 권한이, 노트·녹취록 활용에는 해당 읽기 권한이 필요합니다. 서버가 ‘연결됨’으로 표시되는 것과 학습 데이터 조회가 가능한 것은 별개입니다.
권한과 활용 범위
| 읽기 권한 | 활용할 수 있는 정보 |
|---|---|
과목 읽기course:read | 내 과목 목록, 개별 과목 정보, 현재 또는 다음 수업 일정 |
강의 읽기lecture:read | 과목에 속한 강의 목록과 개별 강의 정보 |
노트 읽기note:read | StudyPack과 생성된 노트, 전체 Markdown 노트, 특정 StudyPack 내 검색 |
전사 읽기transcript:read | 특정 강의의 녹취록과 녹취록 검색, 생성된 요약과 키워드 |
시험 포인트 읽기exam_point:read | 시험 포인트와 원본 노트 정보, StudyPack Quick Review |
Notit은 승인한 권한에 해당하는 도구만 제공하며 로그인한 계정의 자료만 조회합니다. MCP 연결로 Notit 자료를 생성·수정·삭제할 수 없습니다. 검색 도구는 특정 강의 또는 StudyPack 안에서 동작하며, 모든 과목을 한 번에 검색하지 않습니다.
AI가 읽은 자료는 연결한 AI 서비스에 전달되며, 해당 서비스의 데이터 처리 정책이 적용됩니다. 원하지 않는 항목은 연결 시 읽기 권한에서 제외하세요.
문제 해결
로그인이나 인증에 실패했어요
서버 주소가 https://mcp.notit.ai/mcp인지 확인하세요. OAuth 승인 요청이 만료됐다면 AI 앱에서 연결을 다시 시작합니다. 수동 토큰은 인증 헤더 이름과 Bearer 뒤의 공백, 토큰이 빠짐없이 입력됐는지 확인하세요.
수동 토큰이 만료됐어요
Notit의 MCP 세부 설정에서 만료일을 확인하세요. MCP를 껐다 다시 켜면 새 토큰을 발급받을 수 있습니다. 사용할 권한을 확인한 뒤 새 인증 정보를 클라이언트에 저장하고 다시 연결하세요.
필요한 도구가 없거나 권한이 부족해요
권한 표에서 필요한 항목을 확인하세요. OAuth는 연결을 해제한 뒤 필요한 권한을 선택해 다시 연결합니다. 수동 토큰은 토큰 권한을 변경하고 새 인증 정보를 클라이언트에 반영합니다. 이후 클라이언트에서 연결이나 도구 목록을 새로고침하세요.
연결됐는데 유료 플랜이 필요하다고 나와요
연결과 도구 목록 확인은 모든 플랜에서 가능하지만, 학습 데이터 조회에는 Plus 또는 Pro가 필요합니다. 연결한 Notit 계정의 플랜을 확인하세요. 업그레이드했다면 요청을 다시 보내세요.
과목이나 학습 자료를 찾지 못해요
연결한 계정이 맞는지, 자료가 Notit 앱에서 보이는지 확인하세요. 과목과 강의 이름·날짜를 구체적으로 알려주세요. 노트나 녹취록이 아직 생성되지 않았다면 처리가 끝난 뒤 다시 요청합니다. 다음 수업이 없다면 Notit에 등록된 수업 일정도 확인하세요.
연결 종료
OAuth 연결
Notit에서 내 정보 → 연동 → MCP → 세부 설정 → 연결된 앱을 열고 해당 앱의 연결 해제를 선택합니다. 해당 OAuth 연결을 통한 새로운 데이터 접근이 중단됩니다. AI 앱에 남아 있는 서버 설정도 제거할 수 있습니다.
수동 토큰 연결
연결한 AI 앱에서 Notit MCP 서버와 저장된 토큰·인증 헤더를 제거하세요. 같은 토큰을 여러 클라이언트에 입력했다면 각각 제거해야 합니다. Notit의 MCP 스위치를 끄거나 새 토큰을 발급받는 것을 기존 토큰의 즉시 폐기로 간주하지 마세요.
OAuth 연결과 수동 토큰은 별도로 관리됩니다. 한 방식의 연결을 종료해도 다른 방식의 연결까지 함께 종료되지는 않습니다.
도움이 필요할 때
Notit 고객지원 또는 help@metaplad.com으로 문의하세요. 사용한 클라이언트, 연결 방식, 오류 메시지를 알려주시면 도움이 됩니다. 토큰은 보내지 마세요.
