커넥터의 기능
MCP(Model Context Protocol)는 AI 어시스턴트가 다른 시스템의 도구를 사용할 수 있도록 하는 오픈 표준입니다. PaperOffice는 이를 위한 원격 MCP 서버를 제공합니다. 연결이 완료되면 Claude와 같은 어시스턴트는 귀하의 PaperOffice 워크스페이스에 있는 문서와 상호작용할 수 있습니다: 검색, 읽기, 요약, 데이터 추출, 업로드, 이름 변경, 이동, 서명 요청 및 워크플로우 시작 등 모든 작업은 귀하의 PaperOffice 권한 내에서 수행됩니다.
설치가 필요하지 않습니다. 어시스턴트는 URL로 연결되며, PaperOffice 계정으로 로그인하면 채팅 창 내에 PaperOffice 도구가 표시됩니다.
지원되는 어시스턴트 및 커넥터 URL
- Claude(claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, OAuth 2.1로 로그인합니다. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, OAuth 2.1로 로그인합니다. - Grok:
https://mcp.paperoffice.ai/grok, OAuth 2.1로 로그인합니다. - Cursor:
https://mcp.paperoffice.ai/cursor, 개인 사용자 토큰 또는 그룹 토큰을 사용합니다.
프로필은 동일한 서버를 가리키며, 도구 범위의 차이만 있습니다.
필요한 항목
- 최소 하나의 워크스페이스가 포함된 PaperOffice 계정.
- 계정의 Credits. 도구 호출은 API 호출처럼 요금 청구됩니다.
- 커넥터를 허용하는 어시스턴트 플랜(예: Claude Pro, Max, Team 또는 Enterprise). Team 및 Enterprise 플랜에서는 관리자가 먼저 커넥터를 활성화해야 할 수 있습니다.
Claude 연결
- claude.ai에서 설정 → Connectors를 엽니다.
- 사용자 정의 커넥터 추가를 선택하고, 이름에 PaperOffice, URL에
https://mcp.paperoffice.ai/claude를 입력합니다. 클라이언트 ID와 시크릿은 비워두면 OAuth 로그인이 자동으로 시작됩니다. - 연결을 선택하고 PaperOffice 계정으로 로그인합니다. 요청된 접근 권한을 검토하고 확인합니다.
- 채팅에서 해당 대화에 대해 PaperOffice 도구를 활성화합니다.
Claude Desktop은 claude.ai와 동일한 커넥터 목록을 사용합니다. Claude Code에서는 claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude로 서버를 추가하고, /mcp 명령어로 로그인을 완료합니다.
첫 번째 테스트: "접근할 수 있는 PaperOffice 워크스페이스는 무엇인가요?"라고 물어보세요. Claude가 귀하의 워크스페이스 목록을 표시해야 합니다.
ChatGPT 및 Grok 연결
ChatGPT: 설정 → Connectors을(를) 열고, 이름이 PaperOffice인 사용자 지정 커넥터를 추가하세요. URL은 https://mcp.paperoffice.ai/chatgpt이며, 인증 방식은 OAuth입니다. 연결한 후 로그인하세요. 구독 계획에 따라 사용자 지정 커넥터를 사용하려면 개발자 모드를 활성화해야 할 수 있습니다. ChatGPT 프로필은 선별된 도구 모음으로, 서명 도구나 워크플로우 도구를 포함하지 않습니다.
Grok: grok.com/connectors로 이동하여 사용자 지정 커넥터를 생성하세요. URL은 https://mcp.paperoffice.ai/grok이며, 첫 연결 시 PaperOffice 계정으로 로그인하세요. Grok 프로필 또한 선별된 도구 모음입니다.
토큰으로 Cursor 연결
- PaperOffice 앱에 로그인하고 계정 → API를 엽니다.
- 사용자 토큰을 생성하거나 관리자에게서 그룹 토큰을 받으세요. API 페이지에서 언제든지 토큰을 확인하고 복사할 수 있으므로 안전하게 보관하세요.
- Cursor의 mcp.json 파일에 URL
https://mcp.paperoffice.ai/cursor와 Authorization 헤더의 Bearer 토큰으로 토큰을 추가합니다. - Cursor를 다시 시작하거나 MCP 서버를 새로 고칩니다.
실제 토큰이 포함된 mcp.json 파일을 저장소에 커밋하지 마세요. REST API의 비밀 키와 공개 키는 MCP에서 차단됩니다.
권한: 어시스턴트는 사용자보다 더 많은 권한을 얻지 않습니다
어시스턴트는 로그인된 PaperOffice 사용자의 권한으로 작동합니다. 워크스페이스 멤버십, 역할, 공유 폴더, 보존 규칙(WORM) 및 법적 보류는 변경 없이 적용됩니다. PaperOffice에서 읽기 전용 사용자인 경우 어시스턴트에서도 읽기 전용으로 유지됩니다.
각 도구는 제목과 읽기 전용인지 변경 가능한지를 나타내는 힌트를 제공합니다. 어시스턴트는 이러한 힌트를 사용하여 실행 전에 사용자에게 확인을 요청합니다. 삭제, 휴지통 비우기, 서명 요청 보내기는 파괴적인 작업으로 표시되므로 확인 메시지가 표시됩니다. 삭제된 문서는 먼저 PaperOffice 휴지통으로 이동하며 앱에서 복원할 수 있습니다.
계정 설정, 청구, 사용자 관리 및 API 키 생성은 커넥터를 통해 사용할 수 없습니다. 이러한 기능은 PaperOffice 앱에 남아 있습니다.
데이터 흐름: 어시스턴트가 보는 것과 PaperOffice가 받는 것
- 어시스턴트에 요청을 작성합니다.
- 어시스턴트는 호출할 PaperOffice 도구를 결정하고 검색어 또는 문서 ID와 같은 매개변수를 PaperOffice MCP 서버로 보냅니다.
- PaperOffice는 사용자의 권한으로 호출을 실행하고 결과(예: 단일 문서의 텍스트 또는 파일 이름 목록)를 반환합니다.
- 결과는 어시스턴트와의 대화의 일부가 되며 어시스턴트 제공업체의 약관에 따라 처리됩니다.
PaperOffice는 채팅 기록, 프롬프트 또는 어시스턴트의 답변을 받지 않습니다. 서버에 도달하는 것은 도구 호출 자체(도구 이름, 매개변수, 시간 및 사용자)뿐입니다. PaperOffice는 문서 자체를 어시스턴트 제공업체에 업로드하지 않으며, 제공업체는 어시스턴트가 요청한 내용만 받습니다.
모든 도구 호출은 시간, 사용자 및 Credits와 함께 기록됩니다. 관리자는 API 및 개발자 → API 사용량에서 호출 내역을 확인할 수 있습니다.
청구
커넥터를 통한 모든 도구 호출은 해당 API 호출과 정확히 동일한 방식으로 Credits로 청구됩니다. 별도의 커넥터 구독은 없습니다. 일부 상태 및 상태 확인 쿼리는 청구되지 않으며, 자세한 내용은 API 문서에서 확인할 수 있습니다. Credits가 소진되면 명확한 메시지와 함께 호출이 거부되며 데이터는 삭제되지 않습니다. 청구 및 Credits에 대한 가이드를 참조하세요: PaperOffice AI의 청구 및 Credits.
액세스 취소
- 어시스턴트에서 PaperOffice 커넥터를 제거하거나 연결을 해제합니다. 어시스턴트는 즉시 해당 커넥터 사용을 중단하지만, 이미 PaperOffice 결과를 포함하고 있는 대화는 해당 텍스트를 유지합니다.
- PaperOffice에서 계정 → API로 이동하세요. 어시스턴트 연결은 MCP 배지가 표시된 토큰 목록에 나타납니다. 해당 연결의 토큰을 삭제하세요.
- Cursor의 경우, 동일한 페이지에서 토큰을 회전(갱신)하거나 삭제하세요.
액세스를 취소해도 데이터는 삭제되지 않습니다.
문제 해결
- 로그인 창이 열리지 않음: 어시스턴트에 대한 팝업 허용 여부를 확인하고 시크릿 브라우저 창에서 시도하세요. Team 또는 Enterprise 플랜의 경우 관리자에게 커넥터가 활성화되어 있는지 문의하세요.
- 연결되었지만 PaperOffice 도구가 표시되지 않음: 대화에 도구를 활성화하거나 새 대화를 시작하세요.
- 도구 호출 중 '인증되지 않음' 오류: 연결이 취소되거나 만료되었습니다. 다시 연결하세요. 토큰을 사용하는 경우 사용자 또는 그룹 토큰인지 확인하세요.
- 어시스턴트가 문서를 찾지 못함: 먼저 워크스페이스 목록을 요청하세요. 연결된 사용자가 예상하는 워크스페이스에 접근 권한이 없을 수 있습니다. 최근에 업로드된 문서는 처리가 완료될 때까지 시간이 필요합니다.
- Credits 부족: PaperOffice 앱에서 충전하거나 자동 충전을 활성화하세요.
여전히 문제가 해결되지 않나요? 어시스턴트와 플랜, 정확한 메시지, 시간대 포함 시간 및 가능한 경우 개인 데이터가 없는 스크린샷을 포함하여 지원 티켓을 열어주세요.
IT 팀을 위한 권장 사항
- 허용할 도메인: mcp.paperoffice.ai, api.paperoffice.ai 및 app.paperoffice.ai. 모든 트래픽은 HTTPS를 사용하며 네트워크로의 수신 연결이 필요하지 않습니다.
- 파일럿 프로젝트로 시작하세요: 하나의 워크스페이스와 읽기 전용 역할로 시작합니다. 파일럿 후 각 워크스페이스별로 쓰기 역할을 활성화하세요.
- 첫 몇 주 동안 API 사용량을 정기적으로 검토하세요.
자주 묻는 질문
- 무엇을 설치해야 하나요? 아닙니다. 어시스턴트는 URL에 연결됩니다.
- 어시스턴트가 모든 문서를 볼 수 있나요? PaperOffice 사용자가 볼 수 있는 문서만 볼 수 있습니다.
- PaperOffice가 채팅 내용을 읽나요? 아닙니다. 도구 호출만 PaperOffice에 전달됩니다.
- 커넥터에 별도의 구독이 있나요? 아닙니다. 호출은 API 호출과 마찬가지로 Credits에서 청구됩니다.
- 액세스를 종료하는 방법은 무엇인가요? 어시스턴트에서 커넥터를 제거하고, 계정 → API 하위에서 해당 연결의 토큰을 삭제하세요.