주요 콘텐츠로 건너뛰기
AI 튜토리얼

ORC8R MCP 플러그인으로 Claude를 ORC8R Cloud에 연결하기

이 튜토리얼에서는 ORC8R Claude 플러그인 설치, 원격 MCP 서버를 통한 인증, 읽기 및 쓰기 권한 제어, 포함된 관리 스킬 사용, 자체 호스팅 ORC8R 서버 연결 방법을 설명합니다.

ORC8R MCP 플러그인으로 Claude를 ORC8R Cloud에 연결하기

ORC8R Claude 플러그인의 기능

ORC8R 플러그인은 ORC8R Cloud를 https://orc8r.com/mcp의 원격 Model Context Protocol(MCP) 서버를 통해 Claude에 연결합니다.

인증이 완료되면 Claude는 계정에 부여된 액세스 권한으로 ORC8R 리소스를 사용할 수 있습니다. 또한 플러그인에는 Claude가 작업을 찾고, 입력값을 확인하고, 결과를 보고하도록 돕는 간단한 스킬이 포함되어 있습니다.

이 플러그인은 공개 GitHub 저장소에서 플러그인 소스로 배포됩니다. Anthropic 디렉터리에 등록된 항목은 아닙니다.

주요 기능

  • 원격 MCP 서버를 통해 Claude를 ORC8R Cloud에 연결합니다.
  • Claude.ai, Claude Desktop, Claude Code에 설치할 수 있습니다.
  • orc8r 커넥터와 ORC8R 관리 스킬을 포함합니다.
  • 플러그인에 API 키나 사용자 자격 증명을 저장하지 않고 OAuth 로그인과 동의를 사용합니다.
  • 기본적으로 읽기 액세스를 지원하며, 동의 화면을 통해 선택적으로 쓰기 액세스를 허용할 수 있습니다.
  • 사용자 지정 MCP 커넥터를 사용해 자체 호스팅 ORC8R 서버를 구성할 수 있습니다.

Claude.ai 또는 Claude Desktop에 플러그인 설치

  1. Customize → Plugins → Add → Add marketplace를 엽니다.
  2. 저장소 URL을 입력합니다: https://github.com/admte/orc-claude-plugin.
  3. 마켓플레이스에서 ORC8R 플러그인을 추가합니다.
  4. 플러그인의 Connectors 탭을 엽니다.
  5. orc8r를 추가하거나 연결합니다.
  6. ORC8R에 로그인하고 허용할 OAuth 범위를 승인합니다.

Team 및 Enterprise 요금제에서는 사용자가 연결하기 전에 Owner가 조직에 커넥터를 추가해야 할 수 있습니다.

Claude Code에 플러그인 설치

Claude Code CLI를 사용해 마켓플레이스를 추가하고 플러그인을 설치합니다.

claude plugin marketplace add admte/orc-claude-plugin
claude plugin install orc8r@orc-claude-plugin

새 Claude Code 세션을 시작합니다. /mcp를 실행한 다음 메시지가 표시되면 plugin:orc8r:orc8r을 인증합니다.

인증 및 액세스 제어

ORC8R은 모든 사용자에게 로그인하고 액세스를 승인하도록 요청합니다. 동의 페이지에서는 읽기 작업을 허용하는 orc:read를 항상 부여합니다. 변경을 허용하려면 orc:write도 선택합니다.

액세스는 기존 조직 권한에 의해서도 제한됩니다. 즉, 플러그인은 ORC8R 계정에 이미 할당된 권한을 우회하지 않습니다.

플러그인에는 API 키나 사용자 자격 증명이 포함되어 있지 않습니다.

기본 사용법

ORC8R 리소스에 대해 질문하기

커넥터가 인증되면 Claude에 ORC8R 리소스에 대해 질문할 수 있습니다. 예를 들면 다음과 같습니다.

내가 액세스할 수 있는 ORC8R 리소스는 무엇인가요?

Claude는 연결된 ORC8R 도구를 사용해 인증된 계정에서 사용할 수 있는 리소스를 조사할 수 있습니다. 단, 승인된 범위와 조직 권한이 적용됩니다.

ORC8R 관리 스킬 실행

Claude Code에서 다음 명령으로 포함된 관리 스킬을 실행합니다.

/orc8r:manage-orc8r

이 스킬은 Claude가 사용 가능한 작업을 찾고, 해당 작업에 필요한 입력을 확인하고, 결과를 보고하도록 설계되었습니다.

자체 호스팅 ORC8R 고급 설정

기본적으로 이 플러그인은 https://orc8r.com/mcp의 ORC8R Cloud에 연결합니다. 자체 호스팅 ORC8R 서버를 운영하는 경우 클라우드 엔드포인트를 사용하지 마세요. 대신 서버의 MCP 엔드포인트를 사용자 지정 커넥터로 추가합니다.

https://<your-server>/mcp

<your-server>를 ORC8R 설치 환경의 호스트 이름으로 바꾼 다음 서버 구성에 따라 커넥터를 통해 인증합니다.

실용적인 팁

  • 특히 연결을 처음 테스트할 때는 orc:read만 승인해 읽기 전용 액세스로 시작하세요.
  • Claude가 변경 작업을 수행해야 할 때만 orc:write를 허용하세요.
  • Claude Code에서 /mcp를 사용해 MCP 연결을 검토하고 인증하세요.
  • 조직 배포에서 Team 또는 Enterprise 워크스페이스에 필요하다면 Owner에게 커넥터 추가를 요청하세요.
  • 사용 가능한 도구와 범위, 연결 해제 방법은 ORC8R MCP 문서를 확인하세요.
  • ORC8R이 서비스를 통해 전송된 데이터를 처리하는 방식을 알아보려면 ORC8R 개인정보 보호 페이지를 읽어보세요.

저장소 구성

  • plugins/orc8r/에는 MCP 구성과 스킬을 포함한 설치 가능한 Claude 플러그인이 있습니다.
  • .claude-plugin/marketplace.json은 이 저장소에서 플러그인을 설치하는 데 사용되는 마켓플레이스 카탈로그를 제공합니다.

결론

ORC8R Claude 플러그인은 MCP를 통해 Claude를 ORC8R에 직접 연결하는 방법을 제공합니다. 저장소에서 플러그인을 설치하고 orc8r 커넥터를 인증한 다음 Claude로 리소스를 확인하거나 포함된 관리 워크플로를 실행하세요. 더 안전한 액세스 제어를 위해 읽기 권한으로 시작하고 필요한 경우에만 쓰기 액세스를 추가하세요.