OneNote
OneNote
OneNote MCP 서버는 Microsoft Graph API를 사용하여 Microsoft OneNote에 연결하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 인공지능 어시스턴트가 OneNote 노트북, 섹션 및 페이지와 상호작용할 수 있습니다.
특징
- 노트북 관리: OneNote 노트북 읽기, 생성 및 관리
- 섹션 관리: 노트북 내 섹션 읽기, 생성 및 관리
- 페이지 관리: 섹션 내 페이지 읽기, 생성 및 관리
- 콘텐츠 검색: OneNote 콘텐츠 내 검색 기능
- Microsoft Graph API 통합: 공식 Microsoft Graph API를 통한 안정적인 연결
API
도구
list-notebooks
사용자의 모든 노트북을 나열합니다. - 입력: 없음 - 출력: 사용자가 접근할 수 있는 노트북 목록
get-notebook
특정 노트북의 세부 정보를 가져옵니다.
- 입력:
- notebook_id: 노트북 ID
list-sections
노트북 내 모든 섹션을 나열합니다.
- 입력:
- notebook_id: 노트북 ID
- 출력: 지정된 노트북의 섹션 목록
get-section
특정 섹션의 세부 정보를 가져옵니다.
- 입력:
- section_id: 섹션 ID
list-pages
섹션 내 모든 페이지를 나열합니다.
- 입력:
- section_id: 섹션 ID
- 출력: 지정된 섹션의 페이지 목록
get-page
특정 페이지의 내용을 가져옵니다.
- 입력:
- page_id: 페이지 ID
- 출력: 페이지 제목, 내용 및 메타데이터
create-notebook
새 노트북을 생성합니다.
- 입력:
- name: 노트북 이름
- 출력: 생성된 노트북의 ID 및 기타 세부 정보
create-section
노트북 내에 새 섹션을 생성합니다.
- 입력:
- notebook_id: 노트북 ID
- name: 섹션 이름
- 출력: 생성된 섹션의 ID 및 기타 세부 정보
create-page
섹션 내에 새 페이지를 생성합니다.
- 입력:
- section_id: 섹션 ID
- title: 페이지 제목
- content: HTML 형식의 페이지 내용
- 출력: 생성된 페이지의 ID 및 기타 세부 정보
update-page
기존 페이지의 내용을 업데이트합니다.
- 입력:
- page_id: 페이지 ID
- content: 새 HTML 내용
- 출력: 업데이트된 페이지 정보
search-content
OneNote 콘텐츠 내에서 검색합니다.
- 입력:
- query: 검색 쿼리
- notebook_id: (선택 사항) 검색 범위를 제한할 노트북 ID
- section_id: (선택 사항) 검색 범위를 제한할 섹션 ID
- 출력: 검색 쿼리와 일치하는 페이지 목록
사용 방법
인증 설정
이 서버는 Microsoft Graph API를 사용하므로 Microsoft 계정 인증이 필요합니다:
- Microsoft Azure 포털에서 앱 등록
- 적절한 OneNote API 권한 부여
- 클라이언트 ID 및 시크릿 획득
Claude Desktop 구성
Claude Desktop 구성 파일에 서버를 추가하는 예시:
{
"mcpServers": {
"onenote": {
"command": "npx",
"args": ["-y", "onenote-mcp-server"],
"env": {
"MICROSOFT_CLIENT_ID": "your_client_id",
"MICROSOFT_CLIENT_SECRET": "your_client_secret",
"MICROSOFT_REDIRECT_URI": "your_redirect_uri"
}
}
}
}인증 워크플로우
- 처음 사용 시 Microsoft 계정에 로그인하라는 메시지가 표시됩니다.
- 인증 코드를 입력하여 액세스 토큰을 받습니다.
- 토큰은 안전하게 저장되어 향후 요청에 사용됩니다.
보안 고려 사항
- Microsoft 계정 자격 증명을 안전하게 관리하세요.
- 필요한 최소한의 API 권한만 부여하세요.
- 클라이언트 시크릿을 노출하지 마세요.