Coroid를 MCP 서버로 활용하기

Coroid는 원격 Model Context Protocol(MCP) 서버를 제공합니다. Hermes, Codex, Claude Code 또는 Cursor와 같은 외부 어시스턴트나 에이전트는 채팅 어시스턴트가 사용하는 동일한 규제된 도구 레지스트리를 통해 Coroid와 작업하는 데 이 서버를 활용할 수 있습니다.

다음에서 설정하세요:설정 → 연결 → Coroid MCP 서버, 이 항목은 다음을 포함합니다:개요, 클라이언트 설정, 액세스 토큰, 승인및자동화 정책.

엔드포인트#

MCP 서버는 API 게이트웨이에서 다음 주소로 실행됩니다:

https://api.coroid.ai/mcp

전송 방식은 상태가 없는 Streamable HTTP입니다. OAuth 또는 개인 액세스 토큰으로 인증하세요.

활성화된 기능#

Coroid는 모든 조직에 대해 단계별로 MCP 기능을 활성화합니다.

기능이 활성화되기 전에는 클라이언트가 해당 도구를 볼 수 없으며 Coroid는 이에 대한 호출을 거부합니다. 이 페이지의 나머지 부분에서는 전체 기능 세트를 설명합니다.

클라이언트 연결하기#

클라이언트가 지원하는 경우 OAuth를 사용하세요. 브라우저에서 연결을 승인하고 언제든지 취소할 수 있습니다. 액세스 토큰의 유효 기간은 15분이며 갱신 토큰은 30일간 유효하고 각 갱신 시마다 갱신 토큰이 교체됩니다.

클라이언트는 연결 시 범위를 요청합니다. 승인하기 전에 해당 범위를 확인하고 클라이언트가 모든 프로젝트에 접근할 수 있는지 아니면 일부만 접근할 수 있는지 선택하세요. 범위를 요청하지 않는 클라이언트는 읽기 전용 권한만 가지므로 Codex 예시처럼 필요한 범위를 요청하세요.

Hermes#

hermes mcp add coroid --url https://api.coroid.ai/mcp --auth oauth
hermes mcp login coroid
hermes mcp test coroid

대신 액세스 토큰을 사용하는 경우:

hermes mcp add coroid --url https://api.coroid.ai/mcp --auth header

Hermes가 토큰을 요청할 때 이를 제공하세요. 구성 파일이 아닌 Hermes의 자격 증명 저장소에 보관하세요.

Codex#

codex mcp add coroid --url https://api.coroid.ai/mcp
codex mcp login coroid --scopes mcp.read,mcp.work.write,mcp.execute,mcp.delivery

대신 액세스 토큰을 사용하는 경우:

export COROID_MCP_TOKEN="cmp_pat_…"
codex mcp add coroid --url https://api.coroid.ai/mcp --bearer-token-env-var COROID_MCP_TOKEN

Claude Code#

claude mcp add --transport http --scope user coroid https://api.coroid.ai/mcp
/mcp

터미널에서 첫 번째 명령을 실행한 뒤 Claude Code에서 두 번째 명령을 입력하고 coroid를 선택한 후 브라우저에서 로그인하세요.

대신 액세스 토큰을 사용하는 경우:

export COROID_MCP_TOKEN="cmp_pat_…"
claude mcp add --transport http --scope user --header "Authorization: Bearer $COROID_MCP_TOKEN" coroid https://api.coroid.ai/mcp

Cursor#

Coroid를~/.cursor/mcp.json에 추가하거나.cursor/mcp.json리포지토리의 에 추가하여 이 설정을 작업하는 모든 사람과 공유하세요:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp"
    }
  }
}

Cursor는 OAuth로 로그인합니다: 요청 시 브라우저에서 연결을 승인하세요. 해당 화면에서 범위를 확인하세요. 쓰기 범위가 없는 연결은 읽기만 가능하기 때문입니다.

대신 액세스 토큰을 사용하는 경우:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:COROID_MCP_TOKEN}"
      }
    }
  }
}

다음을 설정하세요:COROID_MCP_TOKENCursor가 시작되는 환경에서 이 변수를 지정하세요..cursor/mcp.json리포지토리의 에 이 변수를 포함하여 커밋하세요. 토큰 자체는 절대 넣지 말고 반드시 변수로 지정하세요.

기타 클라이언트#

Streamable HTTP를 통한 원격 MCP 서버를 지원하는 모든 클라이언트는 연결할 수 있습니다. Coroid는 엔드포인트용 OAuth 메타데이터를 제공하며 PKCE를 이용한 동적 클라이언트 등록을 지원합니다. OAuth를 지원하지 않는 클라이언트는 다음 헤더에 베어러 토큰 형태로 액세스 토큰을 전송할 수 있습니다:Authorization.

에이전트가 무언가를 변경하기 전에 Coroid의 도구 목록을 조회하고 다음 리소스를 읽도록 요청하세요:coroid://context. 이를 통해 에이전트가 누구로 행동하는지, 어떤 범위와 프로젝트에 접근할 수 있는지 확인할 수 있습니다.

액세스 토큰#

토큰은 다음에서 생성 및 관리됩니다:액세스 토큰. 다른 모든 자격 증명과 마찬가지로 한 번만 표시되며 이후에는 다시 확인할 수 없습니다.

하나의 토큰을 여러 클라이언트가 공유하는 대신 클라이언트별로 별도의 토큰을 발급하세요. 그러면 특정 클라이언트의 액세스 권한을 취소해도 전체 시스템에 영향을 주지 않습니다.

토큰은 생성한 사용자의 권한을 따르며 포털에 로그인한 사용자만 토큰을 생성할 수 있습니다. 각 토큰은 고유한 범위를 가지며 30일, 90일 또는 365일 후에 만료되고 모든 프로젝트 또는 선택한 프로젝트에만 접근할 수 있습니다. 소유자는 자동화 정책도 연결할 수 있습니다. 모든 토큰은 동일한 접두사로 시작됩니다:cmp_pat_.

토큰은 클라이언트의 환경 또는 자격 증명 저장소에 보관하세요. 절대 리포지토리나 프롬프트에 넣지 마세요.

범위 및 역할#

범위는 연결이 수행할 수 있는 작업을 정의합니다. 조직 내에서의 역할이 이에 대한 제한을 결정합니다: 도구를 사용하려면 해당 범위와 최소한의 역할이 모두 필요합니다. Coroid는 모든 호출 시 현재 역할을 확인하므로 연결이 더 이상 가지지 못한 권한을 유지할 수 없습니다.

최소 역할이 관리자인 범위를 부여할 수 있는 사람은 관리자 또는 소유자뿐입니다. 최소 역할이 소유자인 범위를 부여할 수 있는 사람은 소유자뿐입니다.

일부 프로젝트로 제한된 연결은 다른 프로젝트의 어떤 항목에도 접근할 수 없으며, 작업, 계획, 스프린트, 보고서 또는 릴리스의 ID를 통해서도 접근할 수 없습니다. 또한 다음과 같은 조직 전체 도구도 사용할 수 없습니다:list_plans, get_capacity_dashboard.

도구#

클라이언트는 활성화되어 있고 사용자의 범위 및 역할에서 허용되는 도구만 표시합니다. 승인 열에는 도구가 호출될 때 발생하는 상황이 명시되어 있습니다.

읽기#

이러한 도구는 리뷰어 역할과 다음 범위가 필요합니다:mcp.read. 이들 중 어느 것도 승인이 필요하지 않습니다.

릴리스 도구에 대한 내용은 다음을 참조하세요:MCP를 통한 릴리스.

편집기의 안티슬롭 규칙#

두 개의 안티슬롭 도구를 통해 개발자의 에이전트가 pull request가 존재하기 전에 모든 pull request에 적용되는 품질 관리 기준에 맞게 작업을 수행하도록 할 수 있습니다.

• anti_slop_rules는 프로젝트에 적용된 안티슬롭 정책을 반환합니다: 규칙, 차단되는 규칙, 사용자 정의 규칙, 격리된 규칙, Coroid가 공개 레지스트리에서 조회할 수 있는 새 종속성, 그리고 다음을 위한 코드 스니펫 AGENTS.md는 로컬 에이전트를 위한 동일한 규칙을 명시합니다. 이 스니펫을AGENTS.md, 또는.cursor/rules의 Cursor용 규칙에 붙여넣으세요.
• anti_slop_scan는 Coroid가 동기화한 브랜치, 태그 또는 커밋을 기본 브랜치인 베이스와 비교하여 확인합니다. 이 도구는 파일을 변경하거나 명령을 실행하거나 프로그램을 설치하거나 모델을 호출하지 않으며 읽기 작업만 수행합니다. 분당 5회로 제한됩니다.

스캔 결과는 미리보기일 뿐입니다. 품질 관리에서 여전히 pull request를 검사하며, 그 판정이 최종적으로 적용됩니다. 다음을 참조하세요:안티슬롭 검사.

작업 생성 및 변경#

이러한 도구는 멤버 역할과 다음 범위가 필요합니다:mcp.work.write.

MCP를 통해 생성된 작업은 자격 검증 단계를 거치지 않습니다. 작업 도구에 전송되는 계획 크기의 요청은 작업 대신 초안 계획으로 처리됩니다. MCP를 통해 생성된 계획은 초안 형태로 시작됩니다.

작업 실행#

이러한 도구는 멤버 역할과 다음 범위가 필요합니다:mcp.execute.

배포#

이러한 도구는 멤버 역할과 다음 범위가 필요합니다:mcp.delivery. 릴리스에 대한 별도의 섹션이 아래에 있습니다.

관리#

이러한 도구는 조직 및 프로젝트 설정을 변경합니다.

조직 설정#

Hermes와 같은 에이전트는 스크린샷, 파일 또는 설명을 기반으로 조직을 구성할 수 있습니다. 이 에이전트는 Coroid의 설정 형식을 읽어 해당 내용을 번들에 작성한 뒤 미리보기를 거쳐 적용합니다. 이러한 도구를 사용하려면 소유자 역할과 다음 범위가 필요합니다:mcp.organization.admin.

번들에는 비밀 값 대신 플레이스홀더가 포함되며, 비밀 정보가 포함된 번들은 Coroid에서 거부됩니다. 자세한 내용은 다음을 참조하세요.설정 내보내기 및 가져오기.

MCP를 통한 릴리스#

릴리스 도구는 채팅 어시스턴트가 사용하는 도구와 동일하며, 포털과 동일한 Release API를 통해 처리됩니다:

create_release전체 커밋 SHA, 최근 커밋의 짧은 SHA를 허용합니다.latest, 프로젝트의 버전 소스에 따라 버전이 결정되며 별도로 지정하지 않는 한 그렇게 적용됩니다.get_release각 환경별로 체크 내용, 마지막 배포 정보, 파이프라인에서 보고한 버전, 그리고 Coroid가 실행 중인 버전을 검증했는지 여부를 알려줍니다. 일부 프로젝트에만 접근 권한이 있는 토큰은 다른 프로젝트의 릴리스에 접근할 수 없습니다. Release API는 자체 승인 규칙을 적용하므로 MCP를 통한 승인도 포털에서의 승인과 동일하게 처리됩니다.

list_release_pull_requestsCoroid가 제안하는 순서대로 프로젝트의 열려 있는 pull request를 반환하며, 제외되는 이유도 함께 제공합니다.bundle_release_pull_requests이를 바탕으로 릴리스를 생성합니다: pull request를 순서대로 병합한 릴리스 브랜치와 하나의 릴리스 pull request를 만듭니다. 브랜치를 푸시하고 pull request를 열므로 항상 사람의 개입을 기다립니다. 다음을 생략하세요prNumbersCoroid의 선택 기능을 사용하려면 다음을 입력하세요.

승인 및 자동화 정책#

승인는 사람의 개입을 기다리는 작업 대기열입니다.자동화 정책그 대기열에 무엇을 넣을지 결정합니다.

이것이 가장 중요한 제어 요소입니다. 외부 클라이언트가 사용자를 대신해 작업할 때는 일상적인 작업은 자유롭게 수행할 수 있지만, 중대한 작업은 반드시 사람의 동의를 거쳐야 합니다. 무인으로 실행되는 프로그램에 토큰을 제공하기 전에 반드시 정책을 설정하세요.

승인이 필요한 호출의 경우 클라이언트는 결과 대신 승인 ID와 링크를 받습니다. 소유자나 관리자가 정확한 도구와 인수를 확인한 뒤 호출을 승인하거나 거부합니다. 승인하면 호출이 처음 요청된 그대로 실행되며, 이후에는 클라이언트가 이를 변경할 수 없습니다. 10분 내에 승인되지 않은 호출은 만료됩니다.

자동화 정책을 사용하면 Policy로 표시된 도구를 승인을 기다리지 않고 실행할 수 있습니다. 정책은 소유자만 만들 수 있으며 토큰에 연결할 수 있습니다. 정책에는 허용되는 정확한 도구 목록, 적용 가능한 프로젝트 범위, 시간당/일별/동시 실행 가능한 호출 횟수 제한이 포함되며 만료일도 설정할 수 있습니다. 정책을 취소하면 이에 연결된 모든 토큰의 권한도 함께 취소됩니다. Always로 표시된 도구는 정책의 적용을 받지 않습니다.

OAuth 연결에서는 정책을 적용할 수 없습니다. OAuth를 사용할 경우 Policy로 표시된 모든 도구는 승인을 기다립니다.

재시도, 작업 및 리소스#

무언가를 변경하는 모든 도구에는 다음 매개변수가 필요합니다:idempotencyKey. 새로운 작업마다 새 키를 사용하고, 재시도할 때는 동일한 키를 사용하세요. 그러면 Coroid는 두 번 실행하는 대신 첫 번째 결과를 반환합니다. 다른 인수와 함께 재사용된 키는 거부됩니다.

변경 사항은 작업 상태와 결과를 기록하는 작업 정보도 반환합니다. 다음 네 가지 도구는 모든 연결에 적용됩니다:

서버는 다음과 같은 리소스도 제공합니다:

또한 세 가지 프롬프트도 제공합니다:create_and_run_task, investigate_failure, prepare_release.

각 도구는 분당, 시간당, 일별 사용 제한이 있습니다. 제한을 초과한 호출은 실패하며 다시 시도하기까지 기다려야 하는 시간을 알려줍니다.

의도적으로 노출하지 않는 기능#

도구 레지스트리는 엄격하게 관리되며 제외된 항목은 의도적입니다. 다음 기능은 제공되지 않습니다:

• 셸
• Git 접근
• 파일 시스템
• 원시 데이터베이스 접근
• 임의의 내부 HTTP
• Coroid 자체의 아웃바운드 MCP 관리 도구

이제 다음을 관리할 수 있게 됩니다:작업— 작업, 계획, 프로젝트 및 릴리스를 생성하고 검토할 수 있습니다 — 이는 원격 실행 환경이 아닙니다. MCP 클라이언트는 임의의 명령을 실행하기 위해 Coroid를 사용할 수 없습니다.

활용 분야#

이미 사용 중인 편집기, 보조 도구, 내부 툴 등에서 바로 Coroid를 활용할 수 있어 포털로 전환할 필요가 없습니다. 터미널에서 작업을 생성하거나 보조 도구로 차단된 항목을 확인하는 것도 로컬에서 간편하게 처리할 수 있습니다.

관련 내용#

• 작업 시작 방법
• 설정 내보내기 및 가져오기
• 외부 MCP 서버
• 채팅 보조 도구
• 출처