Coroid는 원격 Model Context Protocol(MCP) 서버를 제공합니다. Hermes, Codex 또는 Claude Code와 같은 외부 어시스턴트나 에이전트가 채팅 어시스턴트가 사용하는 동일한 규제된 도구 레지스트리를 통해 Coroid와 작업할 수 있습니다.
다음 경로에서 설정하세요:설정 → 연결 → Coroid MCP 서버, 여기에는개요, 클라이언트 설정, 액세스 토큰, 승인및자동화 정책.
엔드포인트
MCP 서버는 API 게이트웨이에서 다음 주소로 실행됩니다:
https://api.coroid.ai/mcp전송 방식은 상태 비저장형 Streamable HTTP입니다. OAuth 또는 개인용 액세스 토큰으로 인증하세요.
활성화된 기능
Coroid는 모든 조직에 대해 단계별로 MCP 기능을 활성화합니다.
| 기능 | coroid.ai에서 |
|---|---|
| OAuth 로그인 | 활성화됨 |
| 도구 읽기 | 활성화됨 |
| 개인용 액세스 토큰 | 활성화됨 |
| 작업을 생성, 변경, 실행 또는 전달하는 도구 | 활성화됨 |
| 조직 설정을 포함한 관리 도구 | 아직 지원되지 않음 |
기능이 활성화되기 전까지는 클라이언트에서 해당 도구를 볼 수 없으며 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 headerHermes가 토큰을 요청할 때 이를 제공하세요. 구성 파일이 아닌 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_TOKENClaude 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기타 클라이언트
Streamable HTTP를 통한 원격 MCP 서버를 지원하는 모든 클라이언트가 연결할 수 있습니다. Coroid는 엔드포인트용 OAuth 메타데이터를 공개하며 PKCE를 이용한 동적 클라이언트 등록을 지원합니다. OAuth를 지원하지 않는 클라이언트는 다음 헤더에 베어러 토큰 형태로 액세스 토큰을 전송할 수 있습니다:Authorization.
에이전트가 어떤 내용이라도 변경하기 전에 Coroid의 도구 목록을 조회하고 다음 리소스를 읽도록 요청하세요:coroid://context. 이를 통해 에이전트가 어떤 사용자로 행동하는지, 어떤 범위와 프로젝트를 가진지 확인할 수 있습니다.
액세스 토큰
토큰은 다음 경로에서 생성 및 관리됩니다:액세스 토큰. 다른 모든 인증 정보와 마찬가지로, 토큰은 한 번만 표시되며 이후에는 다시 확인할 수 없습니다.
하나의 토큰을 여러 클라이언트가 공유하는 대신 클라이언트별로 별도의 토큰을 발급하세요. 이렇게 하면 단일 클라이언트의 접근 권한을 취소해도 전체 서비스 중단이 발생하지 않습니다.
토큰은 생성한 사람의 권한을 따르며 포털에 로그인한 사람만 토큰을 생성할 수 있습니다. 각 토큰은 고유한 범위를 가지며 30일, 90일 또는 365일 후에 만료되고 모든 프로젝트 또는 선택한 프로젝트에만 접근할 수 있습니다. 소유자는 자동화 정책도 연결할 수 있습니다. 모든 토큰은 동일한 접두사로 시작됩니다:cmp_pat_.
클라이언트의 환경이나 자격 증명 저장소에 토큰을 보관하세요. 절대 저장소나 프롬프트에 넣지 마세요.
범위 및 역할
범위는 연결이 수행할 수 있는 작업을 정의합니다. 조직 내에서의 역할이 한계를 결정하며, 도구는 해당 범위와 최소한의 역할을 모두 필요로 합니다. Coroid는 매번 호출 시 현재 역할을 확인하므로, 연결은 더 이상 가지지 못한 권한을 유지하지 않습니다.
| 범위 | 사용 가능한 기능 | 최저 역할 |
|---|---|---|
mcp.read | 프로젝트, 작업, 계획, 스프린트, 보고서, 종속성, 용량, 에이전트 실행, Factory 레인, 프로모션 및 릴리스 확인 | 리뷰어 |
mcp.work.write | 작업, 계획, 스프린트, 종속성 및 보고서 생성 및 수정 | 멤버 |
mcp.execute | 작업 시작, 중지, 재시도, 일시 중단, 재개 및 취소 | 멤버 |
mcp.delivery | 계획 승인, 스프린트 종료, 프로모션, 레인 유효성 검사 및 릴리스 처리 | 멤버 |
mcp.projects.admin | 프로젝트 생성, 업데이트, 보관 및 복원, 그리고 릴리스 버전 관리 | 관리자 |
mcp.schedules.admin | 일정 읽기, 생성, 업데이트, 트리거 및 삭제 | 관리자 |
mcp.integrations.admin | 통합 기능 읽기, 테스트, 활성화/비활성화 및 삭제 | 관리자 |
mcp.secrets.write | 자격 증명을 포함하는 통합 기능 생성 | 소유자 |
mcp.organization.admin | 멤버, 초대장, 조직 프로필 및 조직 설정 관리 | 소유자 |
mcp.billing.read | 예약됨. 아직 이를 사용하는 도구가 없습니다. | — |
mcp.billing.write | 예약됨. 아직 이를 사용하는 도구가 없습니다. | 소유자 |
최저 역할이 관리자인 범위를 부여할 수 있는 사람은 관리자 또는 소유자뿐이며, 최저 역할이 소유자인 범위를 부여할 수 있는 사람은 오직 소유자뿐입니다.
일부 프로젝트로 제한된 연결은 다른 프로젝트의 항목에 접근할 수 없으며, 작업, 계획, 스프린트, 보고서 또는 릴리스의 ID를 통해서도 접근할 수 없습니다. 또한 조직 전체에 적용되는 도구도 사용할 수 없습니다. 예:list_plans,
get_capacity_dashboard.
도구
클라이언트에는 활성화되어 있고 범위 및 역할에서 허용하는 도구만 표시됩니다. 승인 열에는 도구 호출 시 발생하는 상황이 명시되어 있습니다.
| 승인 | 발생하는 상황 |
|---|---|
| 없음 | 도구가 즉시 실행됩니다. |
| 정책 | 자동화 정책으로 처리되지 않는 한, 호출 시 승인을 기다립니다. |
| 항상 | 호출 시 반드시 소유자 또는 관리자의 승인을 받아야 합니다. |
읽기
이러한 도구를 사용하려면 리뷰어 역할과 다음 범위가 필요합니다:mcp.read. 이들 중 어느 것도 승인이 필요하지 않습니다.
| 영역 | 도구 |
|---|---|
| 프로젝트 | list_projects, get_project, get_project_dependencies, list_project_branches |
| 작업 | list_tasks, get_task, get_workflow_status, get_execution_status, check_task_can_start |
| 계획 | list_plans, get_plan, get_plan_progress, list_plan_tasks |
| 스프린트 | list_sprints, get_sprint, get_sprint_status |
| 종속성 | analyze_dependencies, get_dependency_graph, get_global_dependency_graph, get_cross_project_blockers |
| 보고서 | list_reports, get_report, export_report, explain_report_execution, list_report_folders, list_report_subscriptions, list_report_templates |
| 용량 및 활동 | get_capacity_dashboard, get_queue_eta, get_mission_control_activity, get_global_execution_stats, get_global_execution_actions, list_global_execution_runs |
| 에이전트 실행 | list_agent_executions, get_agent_execution, get_agent_execution_state, get_execution_conversation, list_tool_executions |
| Factory 레인 및 프로모션 | list_factory_lanes, get_factory_lane, list_factory_lane_tasks, get_factory_lane_gate_context, list_promotions, get_promotion |
| 코드 이력 | explain_code |
릴리스 도구에 대해서는MCP를 통한 릴리스.
작업 생성 및 변경
이 도구들을 사용하려면 Member 역할과 다음 범위가 필요합니다:mcp.work.write.
| 영역 | 도구 | 승인 |
|---|---|---|
| 작업 | create_task, update_task | 없음 |
| 계획 | create_plan, update_plan | 없음 |
| 계획 | delete_plan | 항상 |
| 스프린트 | create_sprint, plan_sprint, add_task_to_sprint | 없음 |
| 스프린트 | remove_task_from_sprint | 항상 |
| 종속성 | create_dependency | 없음 |
| 보고서 | create_report, update_report, create_report_folder, update_report_folder, create_report_subscription, update_report_subscription | 없음 |
| 보고서 | batch_update_reports, delete_report, delete_report_folder, delete_report_subscription | 항상 |
MCP를 통해 생성된 작업은 검증 단계를 거치지 않습니다. 작업 도구로 전송되는 계획 크기의 요청은 작업 대신 초안 계획으로 처리됩니다. MCP를 통해 생성된 계획은 초안 형태로 시작됩니다.
작업 실행
이 도구들을 사용하려면 Member 역할과 다음 범위가 필요합니다:mcp.execute.
| 영역 | 도구 | 승인 |
|---|---|---|
| 작업 | start_task_execution, retry_task_execution | 정책 |
| 작업 | stop_task_execution | 항상 |
| 계획 | start_planning_workflow, execute_plan, retry_plan_task_integration | 정책 |
| 계획 | cancel_plan | 항상 |
| 스프린트 | start_sprint | 정책 |
| 보고서 | pause_report, resume_report, cancel_report, retry_report_generation | 정책 |
| Factory | start_global_execution, pause_global_execution, resume_global_execution, pause_factory_lane, resume_factory_lane | 정책 |
| Factory | cancel_global_execution, set_agent_execution_state | 항상 |
배포
이 도구들을 사용하려면 Member 역할과 다음 범위가 필요합니다:mcp.delivery. 릴리스에 대한 내용은 아래에 별도로 설명되어 있습니다.
| 도구 | 승인 |
|---|---|
approve_plan, close_sprint, create_promotion, approve_promotion, request_promotion_changes, validate_factory_lane | 정책 |
force_merge_promotion | 항상 |
관리
이 도구들은 조직 및 프로젝트 설정을 변경합니다.
| 도구 | 범위 | 최저 역할 | 승인 |
|---|---|---|---|
create_project, update_project, restore_project | mcp.projects.admin | 관리자 | 없음 |
archive_project | mcp.projects.admin | 관리자 | 항상 |
list_schedules, get_schedule, create_schedule, update_schedule | mcp.schedules.admin | 관리자 | 없음 |
trigger_schedule | mcp.schedules.admin | 관리자 | 정책 |
delete_schedule | mcp.schedules.admin | 관리자 | 항상 |
list_integrations, get_integration | mcp.integrations.admin | 관리자 | 없음 |
test_integration | mcp.integrations.admin | 관리자 | 정책 |
set_integration_status, delete_integration | mcp.integrations.admin | 관리자 | 항상 |
create_integration | mcp.secrets.write | 소유자 | 항상 |
list_organization_members, list_organization_invitations | mcp.organization.admin | 소유자 | 없음 |
invite_organization_member, update_organization_member_role, remove_organization_member, revoke_organization_invitation, update_organization | mcp.organization.admin | 소유자 | 항상 |
조직 설정
Hermes와 같은 에이전트는 스크린샷, 파일 또는 설명을 바탕으로 조직을 구성할 수 있습니다. 해당 에이전트는 Coroid의 설정 형식을 읽어서 번들에 내용을 작성한 뒤 미리보기를 거쳐 적용합니다. 이러한 도구를 사용하려면 소유자 역할과 다음 범위가 필요합니다:mcp.organization.admin.
| 도구 | 기능 | 승인 |
|---|---|---|
describe_organization_settings_schema | 설정 형식과 그 섹션, 매핑 힌트를 반환합니다 | 없음 |
export_organization_settings | 비밀 정보는 플레이스홀더로 처리하여 현재 설정을 내보냅니다 | 없음 |
preview_organization_settings_import | 실제로 적용하지 않고 번들이 가져올 변경 사항을 미리 확인할 수 있습니다 | 없음 |
apply_organization_settings_import | 번들을 적용하며, 기본적으로는 현재 설정에 병합되거나 기존 설정을 대체합니다 | 항상 |
번들에는 비밀 값 대신 플레이스홀더가 포함되며, 비밀 정보가 포함된 번들은 Coroid에서 거부됩니다. 자세한 내용은설정 내보내기 및 가져오기.
MCP를 통한 릴리스 관리
릴리스 도구는 채팅 보조 프로그램에서 사용하는 것과 동일하며, 포털과 동일한 Release API를 통해 처리됩니다:
| 도구 | 범위 | 승인 |
|---|---|---|
list_releases, get_release, list_release_commits, preview_release, get_release_settings, list_release_pull_requests | mcp.read | 없음 |
create_release, update_release, run_release_checks, draft_release_notes | mcp.delivery | 없음 |
approve_release, request_release_deployment, bundle_release_pull_requests | mcp.delivery | 항상 |
update_release_versioning | mcp.projects.admin | 없음 |
create_release는 전체 커밋 SHA, 최근 커밋의 짧은 SHA를 받아들입니다.latest, 그리고 프로젝트의 버전 소스에 따라 버전이 결정되며 별도로 지정하지 않는 한
그대로 적용됩니다.get_release는 각 환경별로 검사 결과, 마지막
deployment 정보, 파이프라인에서 보고된 버전, 그리고 Coroid가 실행 중인 버전을 확인했는지 여부를 알려줍니다. 일부 프로젝트에만 접근 권한이 제한된 토큰은 다른 프로젝트의 릴리스에 접근할 수 없습니다. Release API는 자체 승인 규칙을 적용하므로, MCP를 통한 승인도 포털에서의 승인과 동일하게 처리됩니다.
list_release_pull_requestsCoroid가 제안하는 순서대로 프로젝트의 미완료 풀 리퀘스트 목록을 반환하며, 제외되는 항목의 사유도 함께 제공합니다.bundle_release_pull_requests해당 풀 리퀘스트들을 기반으로 릴리스 브랜치를 생성하며, 풀 리퀘스트는 지정된 순서대로 병합되고 하나의 릴리스 pull request가 포함됩니다. 브랜치를 푸시하고 pull request를 열기 때문에 반드시 사람의 승인을 기다립니다. 제외할 항목도 지정할 수 있습니다.prNumbersCoroid의 선택 기능을 활용하려면 이 옵션을 사용하세요.
승인 및 자동화 정책
승인은 인간의 승인을 기다리는 작업 큐입니다.자동화 정책해당 큐에 포함될 항목을 결정합니다.
이것이 가장 중요한 제어 수단입니다. 사용자를 대신하여 작업하는 외부 클라이언트는 일상적인 작업은 자유롭게 수행할 수 있지만, 중대한 작업은 반드시 사람의 동의를 거쳐야 합니다. 무인으로 실행되는 프로그램에 토큰을 제공하기 전에 먼저 정책을 설정하세요.
승인이 필요한 호출의 경우, 클라이언트는 결과 대신 승인 ID와 링크를 받습니다. 소유자나 관리자는 해당 도구와 인수 내용을 확인한 뒤 호출을 승인하거나 거부합니다. 승인 시 호출은 요청된 그대로 실행되며, 이후에는 클라이언트가 내용을 변경할 수 없습니다. 10분 내에 승인되지 않은 호출은 만료됩니다.
자동화 정책을 적용하면 Policy로 표시된 도구를 액세스 토큰으로 실행할 때 승인을 기다리지 않아도 됩니다. 정책은 오직 소유자만 생성하여 토큰에 연결할 수 있습니다. 정책에는 특정 도구 이름이 명시되며, 일부 프로젝트로 범위가 제한될 수 있고, 시간당, 일일 및 동시에 실행 가능한 호출 횟수도 제한할 수 있습니다. 정책에는 만료일도 설정할 수 있습니다. 정책을 취소하면 그에 연결된 모든 토큰의 권한도 함께 취소됩니다. Always로 표시된 도구는 절대 정책의 적용을 받지 않습니다.
OAuth 연결에서는 정책을 적용할 수 없습니다. OAuth를 통해 연결될 경우, Policy로 표시된 모든 도구는 승인을 기다립니다.
재시도, 작업 및 리소스
무언가를 변경하는 모든 도구에는 다음 매개변수가 필요합니다:idempotencyKey.
새로운 작업마다 새 키를 사용하고, 재시도할 때는 같은 키를 사용하세요. 그러면 Coroid는
두 번 실행하는 대신 첫 번째 결과를 반환합니다. 다른 인수와 함께 키를 재사용하면 요청이 거부됩니다.
변경 작업 시에는 상태와 결과가 기록되는 작업 정보도 함께 반환됩니다. 다음 네 가지 도구는 모든 연결에서 사용할 수 있습니다:
| 도구 | 기능 |
|---|---|
get_operation | 작업의 상태와 결과를 반환합니다 |
wait_for_operation | 작업의 상태가 변경될 때까지 최대 25초간 대기합니다 |
cancel_operation | 시작되지 않은 작업을 취소합니다 |
get_approval | 승인의 상태와 결과를 반환합니다 |
서버는 다음과 같은 리소스도 제공합니다:
| 리소스 | 내용 |
|---|---|
coroid://context | 연결이 수행하는 역할, 범위 및 프로젝트 정보 |
coroid://capabilities | 이 연결에서 사용할 수 있는 도구 목록 |
coroid://operations/{operationId} | 작업 하나 |
coroid://approvals/{approvalId} | 승인 하나 |
또한 다음 세 가지 프롬프트도 제공합니다:create_and_run_task, investigate_failure,
prepare_release.
각 도구에는 분당, 시간당 및 일별 사용 제한이 있습니다. 제한을 초과하는 호출은 실패하며, 다시 시도하기까지 기다려야 하는 시간이 안내됩니다.
의도적으로 노출하지 않는 기능
도구 레지스트리는 엄격하게 관리되며, 다음 기능들은 의도적으로 제외되었습니다:
- 셸 접근 권한
- Git 접근 권한
- 파일 시스템 접근 권한
- 원시 데이터베이스 접근 권한
- 임의의 내부 HTTP 요청
- Coroid 자체의 아웃바운드 MCP 관리 도구
사용자는 다음을 관리할 수 있는 기능을 얻게 됩니다:작업— 작업, 계획, 프로젝트 및 릴리스를 생성하고 확인할 수 있습니다. 이는 원격 실행 환경이 아닙니다. MCP 클라이언트는 Coroid를 임의 명령 실행 수단으로 사용할 수 없습니다.
활용 용도
Coroid를 이미 사용 중인 에디터, 비서 또는 내부 도구에서 직접 활용할 수 있어 별도로 포털로 전환할 필요가 없습니다. 터미널에서 바로 작업을 생성하거나 비서에게 차단된 항목을 확인하도록 요청하는 것도 현지에서 즉시 처리됩니다.