MCP

MCP는 Model Context Protocol(모델 컨텍스트 프로토콜)의 약자입니다. BibGenie는 MCP 호환 클라이언트가 Zotero 관련 도구에 접근할 수 있도록 로컬 MCP 서버를 실행할 수 있습니다.

MCP로 무엇을 할 수 있나요?Copy Anchor Link

외부 클라이언트는 BibGenie의 Zotero 도구를 사용해 다음 작업을 수행할 수 있습니다.

• Zotero 항목 검색
• 의미 기반 문헌 검색
• PDF 첨부 파일 읽기
• 스냅샷 읽기
• Zotero 노트 읽기
• 태그와 컬렉션 목록 조회
• Zotero 노트 생성
• 태그와 컬렉션 관리
• 메타데이터 조회 또는 편집

Zotero MCP란 무엇인가요?Copy Anchor Link

Zotero MCP는 Zotero 라이브러리와 외부 AI 클라이언트를 연결하는 BibGenie의 로컬 연결 기능입니다. 파일을 내보내거나 메타데이터를 직접 복사하는 대신, MCP 호환 클라이언트가 로컬 프로토콜을 통해 BibGenie에 Zotero 컨텍스트를 요청할 수 있습니다.

예를 들어 외부 클라이언트는 BibGenie의 MCP 도구를 통해 라이브러리를 검색하고, 컬렉션을 살펴보고, PDF 첨부 파일을 읽거나 Zotero 노트를 만들 수 있습니다.

핵심 장점Copy Anchor Link

핵심 기능Copy Anchor Link

플러그인 채팅과 MCP 비교Copy Anchor Link

서버 유형과 URLCopy Anchor Link

BibGenie의 MCP 서버는 Streamable HTTP를 사용합니다. 서버 URL은 보통 다음과 같은 형식입니다.

http://127.0.0.1:23119/bibgenie/mcp

Zotero HTTP 서버가 사용자 지정 포트를 사용한다면 포트가 다를 수 있습니다. 직접 입력하지 말고 항상 BibGenie 설정에 표시된 서버 URL을 복사하세요.

MCP 서버 활성화Copy Anchor Link

외부 클라이언트 연결Copy Anchor Link

Streamable HTTP MCP를 지원하는 클라이언트에서 BibGenie 설정의 서버 URL을 사용하세요.

CursorCopy Anchor Link

Cursor는 BibGenie의 Streamable HTTP 엔드포인트에 직접 연결할 수 있습니다.

{
  "mcpServers": {
    "ZoteroBibGenie": {
      "url": "http://127.0.0.1:23119/bibgenie/mcp"
    }
  }
}

Claude CodeCopy Anchor Link

Claude Code는 HTTP MCP 서버를 직접 지원합니다.

claude mcp add ZoteroBibGenie --transport http http://127.0.0.1:23119/bibgenie/mcp

BibGenie 설정에 다른 포트가 표시된다면 URL을 바꾸세요.

Claude DesktopCopy Anchor Link

일부 Claude Desktop 빌드는 로컬 HTTP 엔드포인트보다 stdio MCP 서버에 더 안정적으로 연결됩니다. 이 경우 mcp-remote를 간단한 브리지로 사용하여 Claude Desktop을 BibGenie의 로컬 HTTP 서버에 연결하세요.

{
  "mcpServers": {
    "ZoteroBibGenie": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:23119/bibgenie/mcp"]
    }
  }
}

Cherry StudioCopy Anchor Link

Cherry Studio는 Streamable HTTP MCP를 직접 지원합니다.

프롬프트 예시Copy Anchor Link

• "2023년 이후에 출판된 검색 증강 생성 관련 Zotero 논문을 찾아 줘."
• "이 Zotero 항목의 PDF 첨부 파일을 읽고 논문의 핵심 기여를 요약해 줘."
• "내 머신러닝 컬렉션의 항목을 나열하고 연도 메타데이터가 없는 항목을 찾아 줘."

보안 권장 사항Copy Anchor Link

• 신뢰하는 클라이언트에만 MCP 서버 URL을 공유하세요.
• 노트 생성, 메타데이터 편집, 태그 및 컬렉션 관리처럼 Zotero 라이브러리에 쓰기 작업을 수행하는 도구를 사용할 때는 주의하세요.
• MCP를 사용하지 않을 때는 서버를 끄세요.
• 외부 클라이언트가 예상과 다르게 작동하면 MCP 서버를 중지하고 클라이언트 설정을 검토하세요.

자주 묻는 질문Copy Anchor Link