BibGenie 문서MCP 설정
BibGenie의 로컬 MCP 서버를 켜거나 끄고, URL을 복사하고, 연결을 테스트하세요.
MCP 설정에서는 BibGenie의 로컬 MCP 서버를 제어합니다. 서버를 활성화하면 외부 MCP 클라이언트가 서버 URL에 연결하여 BibGenie의 Zotero 도구에 접근할 수 있습니다.
제어 항목
MCP 서버 활성화
로컬 MCP 서버를 시작하거나 중지합니다.
서버 URL
외부 클라이언트가 BibGenie에 연결할 때 사용하는 URL입니다. 보통 http://127.0.0.1:23119/bibgenie/mcp 형식이지만 Zotero가 사용자 지정 HTTP 서버 포트를 사용한다면 포트가 다를 수 있습니다.
복사
서버 URL을 클립보드에 복사합니다.
연결 테스트
HTTP POST JSON-RPC로 MCP 초기화 요청을 보내 엔드포인트에 접근할 수 있는지 확인합니다.
브라우저 테스트는 오해를 불러올 수 있습니다
브라우저에서 서버 URL을 직접 여는 것은 MCP 연결과 다릅니다. MCP 클라이언트는 POST JSON-RPC 요청을 보내지만 브라우저 주소 표시줄은 GET 요청을 보냅니다. 실제 연결 확인에는 연결 테스트를 사용하세요.
상태 안내
| 상태 | 의미 |
|---|---|
| 서버 꺼짐 | MCP 서버가 비활성화되어 있습니다 |
| 시작 중 | 서버를 시작하고 있습니다 |
| 서버 실행 중 | 외부 클라이언트를 연결할 준비가 되었습니다 |
| 연결 테스트 중 | 연결 테스트를 진행하고 있습니다 |
| 연결 확인됨 | 테스트에 성공했습니다 |
| 연결 실패 | 테스트에 실패했습니다. URL 또는 서버 상태를 확인하세요 |
연결에 실패할 때
- Zotero가 실행 중인지 확인하세요.
- Zotero에서 BibGenie가 활성화되어 있는지 확인하세요.
- MCP 서버 활성화가 켜져 있는지 확인하세요.
- 포트를
23119로 가정하지 말고 표시된 서버 URL을 복사하세요. - 최근에 서버를 활성화했거나 플러그인을 업데이트했다면 Zotero를 다시 시작하세요.
MCP 활성화
BibGenie 환경설정을 엽니다.
MCP 서버 섹션을 찾습니다.
MCP 서버 활성화를 켭니다.
서버 URL이 나타날 때까지 기다립니다.
복사를 클릭하고 외부 MCP 클라이언트에 URL을 붙여 넣습니다.
연결 테스트를 클릭하여 정상 작동하는지 확인합니다.
MCP 비활성화
외부 클라이언트를 사용하지 않을 때는 MCP 서버 활성화를 끄세요. 외부 클라이언트는 더 이상 BibGenie의 MCP 도구에 접근할 수 없습니다.
신뢰하는 클라이언트만 연결하세요
MCP 도구는 Zotero 라이브러리를 읽거나 수정할 수 있습니다. 신뢰하는 클라이언트에만 서버 URL을 공유하세요.