CoRoid 커넥터는 사용자 기기에 있는 코딩 에이전트가 CoRoid를 위해 작업을 수행하도록 해주는 프로그램입니다 (참조:사용자 기기의 코딩 에이전트). 이 프로그램은 Apache-2.0 라이선스에 따라 오픈 소스이며, 전체 소스 코드는 다음 주소에 있습니다:github.com/COROID-AI/coroid-connector. 이 페이지는 해당 프로그램을 조직의 기기에서 실행할 수 있는지 여부를 결정하는 담당자를 위한 내용입니다.
데이터 흐름 방식
사용자의 컴퓨터
CoRoid 커넥터
오픈 소스로 제공됩니다. 새로운 빈 디렉터리에서 에이전트를 실행한 뒤 작업이 끝나면 자동으로 종료됩니다.
귀사의 코딩 에이전트
사용자가 직접 로그인하여 사용하는 에이전트로, 자체 도구는 비활성화된 상태입니다.
- 1작업을 요청합니다. 각 요청은 최대 25초간 유지되며, 커넥터는 3초마다 에이전트의 응답 내용을 보고합니다.
- 2해당 역할의 도구들을 호출합니다. 이번 작업에만 사용되는 토큰으로, 작업이 끝나면 즉시 효력을 잃습니다.
- 3자신의 모델에 문의합니다. CoRoid 없이도 동일하게 작동합니다. CoRoid는 해당 로그인 정보를 절대 확인할 수 없습니다.
CoRoid
오케스트레이터
작업을 시작한 사람의 컴퓨터에 해당 역할의 작업을 할당합니다(1).
해당 역할의 도구들
작업용 샌드박스에서 실행되며, 사용자의 코드는 그곳에 보관됩니다(2).
에이전트의 제공자
사용자의 로그인 정보를 바탕으로, 사용자가 이용 중인 요금제에 따라 에이전트의 모델 요청에 응답합니다(3).
컴퓨터 내부로는 아무것도 접근할 수 없습니다. 커넥터는 포트를 열지 않으며, 파일을 전송하거나 자체 명령을 실행하지 않습니다.
컴퓨터에는 에이전트에 대한 사용자의 로그인 정보와 작업 중에 에이전트가 보관하는 데이터만 남습니다.
- 외부로만 전송됩니다.커넥터는 로그인 시 잠시 동안을 제외하고는 포트를 열지 않습니다.
127.0.0.1커넥터는 HTTPS를 통해 CoRoid에 작업을 요청합니다. 각 요청은 최대 25초간 유지된 후 다시 전송되며, 이를 통해 CoRoid는 기기가 연결되어 있음을 확인할 수 있습니다. - 사용자의 코드는 CoRoid 내에 저장됩니다.저장소는 기기로 복사되지 않습니다. 역할에 할당된 도구(파일 읽기, 테스트 실행, 코드 변경 등)는 CoRoid의 작업 샌드박스 내에서 실행됩니다. 기기로 전송되는 것은 해당 역할의 지침과 도구의 반환값, 즉 에이전트가 읽은 파일의 내용이나 테스트 결과 등입니다.
- 에이전트의 모델 요청은 해당 제공업체로 전송됩니다, 사용자의 로그인 정보와 요금제를 기반으로 처리되며, 이는 CoRoid를 사용하지 않을 때와 동일한 방식입니다. 에이전트가 모델에 전송하는 데이터에는 역할의 도구에서 반환된 결과가 포함되므로, 해당 제공업체와의 계약이 이를 적용합니다.
- 작업은 해당 작업을 시작한 사람에게만 할당됩니다.특정 역할이 기기에서 실행되려면 할당된 에이전트가 지정되어야 하고, 작업을 시작한 사람이 해당 조직에서 연결된 기기를 보유해야 하며, 조직의 정책에서 해당 에이전트 사용을 허용해야 합니다. 자동화와 같이 누군가 시작하지 않은 작업은 해당 모델에서 실행됩니다.
커넥터의 기능
- 로그인하기브라우저에서 OAuth 2.1 및 PKCE를 이용해 하나의 범위에 대해 로그인합니다(
connector.turns). 액세스 토큰의 유효 기간은 15분이며, 갱신 토큰은 30일간 유효하고 사용될 때마다 교체됩니다.연결 끊기메뉴에서사용자 기기두 토큰을 모두 취소합니다. - 해당 토큰들을 보관합니다macOS의 키체인이나 Linux 데스크톱의 Secret Service에 저장하며, 표준 입력을 통해 해당 도구에 전달하고 명령줄에는 절대 노출하지 않습니다. 이러한 저장소가 없는 경우에만 사용자만 읽을 수 있는 파일에 보관됩니다.
coroid-connector status토큰의 저장 위치는 해당 문서에서 확인할 수 있습니다. - CoRoid에 알립니다, 첫 요청 시 기기의 이름, 운영 체제, 자체 버전, 각 에이전트의 버전과 상태, 제공하는 모델 정보를 전달합니다.
- 한 번의 작업을 실행합니다:에이전트를 새로운 빈 디렉터리에서 시작하며, 에이전트 고유의 도구는 비활성화되고 해당 작업을 위한 역할의 도구만 제공됩니다. 에이전트의 발언을 전달하고 해당 도구를 호출하는 요청 외의 권한 요청은 거부한 뒤 작업을 중단합니다. 그 후 해당 디렉터리는 삭제됩니다.
커넥터가 수행하지 않는 작업
- 사용자의 파일을 읽거나 전송하거나 자체 명령을 실행하지 않습니다. 읽는 파일 중 자체 파일이 아닌 것은 Cursor의 설정 파일뿐이며, 이는 Cursor 사용 허용 여부를 결정하는 두 가지 값을 확인하기 위함입니다 (제한 사항 참조). 해당 파일의 내용은 기기를 떠나지 않습니다.
- 에이전트가 자체 셸, 파일 편집, 웹 검색, 또는 자체 MCP 서버 및 커넥터를 사용하도록 허용하지 않습니다. 각 에이전트는 테스트된 버전에 맞게 해당 기능이 비활성화된 상태로 시작되며, 다른 버전의 에이전트는 목록에만 표시되고 사용되지 않습니다.
- 다른 사용자가 접근할 수 있는 포트를 열거나, 열린 연결을 통해 CoRoid 외의 누군가로부터 지침을 받지 않습니다.
- 실행 중에 어떠한 파일도 다운로드하지 않습니다.
coroid-connector add에이전트 어댑터는 릴리스의 잠금 파일에 명시된 패키지에서 한 번만 설치되며(각각 버전과 SHA-512로 고정됨), 설치 스크립트는 비활성화됩니다.
커넥터가 보내는 요청
| 대상 | 시점 | 목적 |
|---|---|---|
CoRoid의 API(https://api.coroid.ai) | 로그인 및 로그아웃 | 커넥터 등록, 토큰 교환·갱신·취소(/oauth/…) |
| CoRoid의 API | 실행 중에 | 작업 요청(/connector/v1/poll) 및 작업 결과 보고(/connector/v1/turns/…/events) |
| npm 레지스트리 | 오직coroid-connector add | 어댑터는 릴리스의 잠금 파일에 명시된 패키지를 사용합니다 |
에이전트가 아닌 커넥터가 역할의 도구를 호출하며(해당 작업의 토큰을 사용하여), 이는 다음 주소에 있습니다:/connector/v1/turns/, 그리고 자체 제공업체에도 요청합니다.
견딜 수 있도록 설계된 사항
| 만약 | 그러면 |
|---|---|
| 다른 사람이 사용자 대신 기기 연결을 요청하는 경우 | 승인 절차는 사용자 본인으로 로그인한 상태에서 브라우저 내에서 진행되며, 로그인은 해당 프로세스를 시작한 머신에서만 완료됩니다 (127.0.0.1), PKCE 방식을 사용합니다. 단지 바로 전에 시작한 커넥터만 승인하십시오. |
| 커넥터의 토큰이 도난당하는 경우 | 해당 토큰은 하나의 범위까지만 접근할 수 있으며, 이는 특정 사용자의 작업 내용을 조회하고 보고하는 용도입니다. 액세스 토큰은 15분 내에 만료되며, '연결 끊기' 기능을 통해 두 가지 권한이 모두 취소됩니다. |
| 특정 턴에서 토큰이 재사용되는 경우 | 이 토큰은 해당 턴에만 유효하며, 턴이 종료되면 더 이상 작동하지 않습니다. |
| 해당 턴에서 에이전트에게 다른 요청을 하는 경우 | 에이전트 자체의 도구는 비활성화되며, 커넥터는 다른 권한 요청을 거부합니다. 역할별 도구는 클라우드 모델과 동일하며, 동일한 QA, 리뷰, 게이트 및 단계 제한이 적용됩니다. |
| 릴리스의 내용이 소스에 명시된 내용과 다른 경우 | GitHub Actions를 통해 공개 저장소의 태그가 지정된 커밋으로부터 각 릴리스가 빌드되며, 증명 절차를 거쳐 출처 정보와 함께 npm에 게시됩니다. Homebrew 공식 패키지는 증명 확인 후에만 새 버전을 인식합니다. 직접 확인할 수도 있습니다(아래 참조). |
제한 사항
- 에이전트는 사용자 본인의 권한으로 해당 머신에서 실행됩니다. CoRoid의 도구 사용 여부는 각 에이전트별 설정에 따라 결정되므로, 커넥터는 테스트된 버전에서만 에이전트를 사용합니다.
- 에이전트가 턴과 관련하여 자체 저장소에 보관하는 데이터는 에이전트별로 상이합니다(참조: 사용자 머신에 남는 데이터). 조직의 정책에 따라 사용 가능한 에이전트가 결정됩니다(참조: 조직에서 허용하는 항목).
- Cursor는 기본 설정에서 웹 페치, 웹 검색 및 브라우저 기능을 사용하기 전에 요청을 합니다. 커넥터는 머신에서 해당 설정 두 가지(승인 모드, 웹 검색 자동 허용 여부)를 읽어들이며, 이러한 설정에서 해당 도구를 무단으로 실행하도록 허용하면 Cursor를 사용하지 않습니다.
- 해당 커넥터는 Windows에서 테스트된 적이 없습니다.
릴리스 확인하기
GitHub의 각 릴리스에는 게시된 패키지, 커넥터 파일, CycloneDX 자재 명세서가 포함됩니다.SHA256SUMS. 다음을 교체하십시오:<version>확인하려는 릴리스로 교체하세요.
npm 패키지의 레지스트리 서명 및 출처 정보:
mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signatures해당 파일을 빌드한 커밋 및 워크플로우를 명시한 증명 정보:
gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
--signer-workflow COROID-AI/coroid-connector/.github/workflows/release.yml태그가 지정된 소스로 직접 빌드한 파일:
git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs # the same as its line in SHA256SUMS취약점을 신고하려면 저장소의 보안 정책(GitHub의 비공개 취약점 신고 절차)을 이용하십시오.