Coroid tillhandahåller en fjärrserver för Model Context Protocol (MCP). En extern assistent eller agent, till exempel Hermes, Codex eller Claude Code, kan använda den för att arbeta med Coroid via samma styrda verktygsregister som chattassistenten använder.
Konfigurera under Inställningar → Anslutningar → Coroid MCP-server, där du hittar Översikt, Klientkonfiguration, Åtkomsttoken, Godkännanden och Automatiseringspolicyer.
Endpointen
MCP-servern körs på API-gatewayen på den här adressen:
https://api.coroid.ai/mcpTransporten är tillståndslös Streamable HTTP. Autentisera med OAuth eller en personlig åtkomsttoken.
Aktiverade funktioner
Coroid aktiverar MCP-funktioner stegvis för alla organisationer samtidigt.
| Funktion | På coroid.ai |
|---|---|
| OAuth-inloggning | På |
| Läsverktyg | På |
| Personliga åtkomsttoken | På |
| Verktyg som skapar, ändrar, kör eller levererar arbete | På |
| Administrationsverktyg, inklusive organisationsinställningar | Inte ännu |
Innan en funktion är aktiverad visas inte dess verktyg för klienterna, och Coroid avvisar anrop till dem. Resten av den här sidan beskriver hela uppsättningen.
Anslut en klient
Använd OAuth när klienten stöder det. Du godkänner anslutningen i webbläsaren och kan återkalla den när som helst. Åtkomsttoken gäller i 15 minuter och uppdateringstoken i 30 dagar. Varje uppdatering ersätter uppdateringstoken.
Klienten begär behörigheter när den ansluter. Innan du godkänner ser du behörigheterna och väljer om klienten ska få åtkomst till alla projekt eller bara några. En klient som inte begär några behörigheter får endast läsåtkomst. Begär därför de behörigheter du behöver, som i Codex-exemplet.
Hermes
hermes mcp add coroid --url https://api.coroid.ai/mcp --auth oauth
hermes mcp login coroid
hermes mcp test coroidMed en åtkomsttoken i stället:
hermes mcp add coroid --url https://api.coroid.ai/mcp --auth headerGe Hermes token när den ber om den. Förvara den i Hermes autentiseringsuppgifter i stället för i konfigurationsfilen.
Codex
codex mcp add coroid --url https://api.coroid.ai/mcp
codex mcp login coroid --scopes mcp.read,mcp.work.write,mcp.execute,mcp.deliveryMed en åtkomsttoken i stället:
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
/mcpKör det första kommandot i terminalen. Skriv sedan det andra i Claude Code, välj coroid och logga in i webbläsaren.
Med en åtkomsttoken i stället:
export COROID_MCP_TOKEN="cmp_pat_…"
claude mcp add --transport http --scope user --header "Authorization: Bearer $COROID_MCP_TOKEN" coroid https://api.coroid.ai/mcpAndra klienter
Alla klienter som stöder fjärranslutna MCP-servrar via Streamable HTTP kan ansluta.
Coroid publicerar OAuth-metadata för slutpunkten och stöder dynamisk klient-
registrering med PKCE. En klient utan OAuth kan skicka en åtkomsttoken som en
bearer-token i den här headern: Authorization.
Innan en agent ändrar något ber du den lista Coroids verktyg och läsa
den här resursen: coroid://context. Där visas vem agenten agerar som och vilka
behörigheter och projekt den har.
Åtkomsttoken
Token skapas och hanteras under Åtkomsttoken. Precis som alla andra autentiseringsuppgifter visas de bara en gång och går inte att hämta igen.
Skapa en token per klient i stället för att dela på en. Då kan du återkalla en enskild klients åtkomst utan att det påverkar alla andra.
En token agerar som personen som skapade den, och bara en person som är inloggad i
portalen kan skapa en. Varje token har egna behörigheter, upphör att gälla efter 30, 90 eller
365 dagar och ger åtkomst till alla projekt eller bara de projekt du väljer. En ägare
kan också koppla en automatiseringspolicy till token. Alla token börjar med samma prefix:
cmp_pat_.
Förvara en token i klientens miljö eller i dess autentiseringslager. Lägg den aldrig i ett repo eller en prompt.
Behörigheter och roller
En behörighet anger vad en anslutning får göra. Din roll i organisationen sätter gränsen: ett verktyg kräver både rätt behörighet och minst den angivna rollen. Coroid kontrollerar din aktuella roll vid varje anrop, så en anslutning behåller aldrig behörigheter du har förlorat.
| Behörighet | Vad den ger åtkomst till | Lägsta roll |
|---|---|---|
mcp.read | Läsa projekt, uppgifter, planer, sprintar, rapporter, beroenden, kapacitet, agentkörningar, mjukvarufabrikens arbetsflöden, befordringar och versioner | Granskare |
mcp.work.write | Skapa och ändra uppgifter, planer, sprintar, beroenden och rapporter | Medlem |
mcp.execute | Starta, stoppa, försöka igen, pausa, återuppta och avbryta arbete | Medlem |
mcp.delivery | Godkänna planer, avsluta sprintar och godkänna befordringar, validering av arbetsflöden och versioner | Medlem |
mcp.projects.admin | Skapa, uppdatera, arkivera och återställa projekt samt versionshantera versioner | Administratör |
mcp.schedules.admin | Läsa, skapa, uppdatera, utlösa och ta bort scheman | Administratör |
mcp.integrations.admin | Läsa, testa, aktivera eller inaktivera och ta bort integrationer | Administratör |
mcp.secrets.write | Skapa integrationer som hanterar autentiseringsuppgifter | Ägare |
mcp.organization.admin | Medlemmar, inbjudningar, organisationsprofilen och Organisationsinställningar | Ägare |
mcp.billing.read | Reserverad. Inga verktyg använder den ännu | — |
mcp.billing.write | Reserverad. Inga verktyg använder den ännu | Ägare |
Bara en administratör eller ägare kan bevilja en behörighet vars lägsta roll är Administratör. Bara en ägare kan bevilja en behörighet vars lägsta roll är Ägare.
En anslutning som är begränsad till vissa projekt kan inte nå något i andra projekt,
inte ens via ID:t för en uppgift, plan, sprint, rapport eller version. Den kan inte heller använda
organisationsövergripande verktyg, till exempel följande: list_plans,
get_capacity_dashboard.
Verktyg
Klienten visar bara verktyg som är aktiverade och som dina behörigheter och din roll ger åtkomst till. Kolumnen Godkännanden visar vad som händer när ett verktyg anropas:
| Godkännanden | Vad händer |
|---|---|
| Inga | Verktyget körs direkt |
| Policy | Anropet väntar på godkännande, såvida det inte omfattas av en automatiseringspolicy |
| Alltid | Anropet väntar alltid på att en ägare eller administratör ska godkänna det |
Läsa
De här verktygen kräver rollen Granskare och den här behörigheten: mcp.read. Inget av dem
kräver godkännande.
| Område | Verktyg |
|---|---|
| Projekt | list_projects, get_project, get_project_dependencies, list_project_branches |
| Uppgifter | list_tasks, get_task, get_workflow_status, get_execution_status, check_task_can_start |
| Planer | list_plans, get_plan, get_plan_progress, list_plan_tasks |
| Sprintar | list_sprints, get_sprint, get_sprint_status |
| Beroenden | analyze_dependencies, get_dependency_graph, get_global_dependency_graph, get_cross_project_blockers |
| Rapporter | list_reports, get_report, export_report, explain_report_execution, list_report_folders, list_report_subscriptions, list_report_templates |
| Kapacitet och aktivitet | get_capacity_dashboard, get_queue_eta, get_mission_control_activity, get_global_execution_stats, get_global_execution_actions, list_global_execution_runs |
| Agentkörningar | list_agent_executions, get_agent_execution, get_agent_execution_state, get_execution_conversation, list_tool_executions |
| Mjukvarufabrikens körfält och befordringar | list_factory_lanes, get_factory_lane, list_factory_lane_tasks, get_factory_lane_gate_context, list_promotions, get_promotion |
| Kodhistorik | explain_code |
Skapa och ändra arbete
De här verktygen kräver rollen Medlem och den här behörigheten: mcp.work.write.
| Område | Verktyg | Godkännanden |
|---|---|---|
| Uppgifter | create_task, update_task | Inga |
| Planer | create_plan, update_plan | Inga |
| Planer | delete_plan | Alltid |
| Sprintar | create_sprint, plan_sprint, add_task_to_sprint | Inga |
| Sprintar | remove_task_from_sprint | Alltid |
| Beroenden | create_dependency | Inga |
| Rapporter | create_report, update_report, create_report_folder, update_report_folder, create_report_subscription, update_report_subscription | Inga |
| Rapporter | batch_update_reports, delete_report, delete_report_folder, delete_report_subscription | Alltid |
Arbete som skapas via MCP går inte igenom Kvalificering. En förfrågan som är tillräckligt omfattande för en plan och skickas till uppgiftsverktyget blir ett utkast till en plan i stället för en uppgift. Planer som skapas via MCP börjar som utkast.
Köra arbete
De här verktygen kräver rollen Medlem och den här behörigheten: mcp.execute.
| Område | Verktyg | Godkännanden |
|---|---|---|
| Uppgifter | start_task_execution, retry_task_execution | Policy |
| Uppgifter | stop_task_execution | Alltid |
| Planer | start_planning_workflow, execute_plan, retry_plan_task_integration | Policy |
| Planer | cancel_plan | Alltid |
| Sprintar | start_sprint | Policy |
| Rapporter | pause_report, resume_report, cancel_report, retry_report_generation | Policy |
| Mjukvarufabrik | start_global_execution, pause_global_execution, resume_global_execution, pause_factory_lane, resume_factory_lane | Policy |
| Mjukvarufabrik | cancel_global_execution, set_agent_execution_state | Alltid |
Leverans
De här verktygen kräver rollen Medlem och följande behörighet: mcp.delivery. Versioner har ett eget avsnitt längre ner.
| Verktyg | Godkännanden |
|---|---|
approve_plan, close_sprint, create_promotion, approve_promotion, request_promotion_changes, validate_factory_lane | Policy |
force_merge_promotion | Alltid |
Administration
De här verktygen ändrar hur organisationen och dess projekt är konfigurerade.
| Verktyg | Behörigheter | Lägsta roll | Godkännanden |
|---|---|---|---|
create_project, update_project, restore_project | mcp.projects.admin | Administratör | Ingen |
archive_project | mcp.projects.admin | Administratör | Alltid |
list_schedules, get_schedule, create_schedule, update_schedule | mcp.schedules.admin | Administratör | Ingen |
trigger_schedule | mcp.schedules.admin | Administratör | Policy |
delete_schedule | mcp.schedules.admin | Administratör | Alltid |
list_integrations, get_integration | mcp.integrations.admin | Administratör | Ingen |
test_integration | mcp.integrations.admin | Administratör | Policy |
set_integration_status, delete_integration | mcp.integrations.admin | Administratör | Alltid |
create_integration | mcp.secrets.write | Ägare | Alltid |
list_organization_members, list_organization_invitations | mcp.organization.admin | Ägare | Ingen |
invite_organization_member, update_organization_member_role, remove_organization_member, revoke_organization_invitation, update_organization | mcp.organization.admin | Ägare | Alltid |
Organisationsinställningar
En agent som Hermes kan konfigurera en organisation utifrån skärmbilder, filer eller en beskrivning. Den läser formatet för Coroids inställningar, skriver in informationen i ett paket, förhandsgranskar paketet och tillämpar det sedan. De här verktygen kräver rollen Ägare och följande behörighet: mcp.organization.admin.
| Verktyg | Vad det gör | Godkännanden |
|---|---|---|
describe_organization_settings_schema | Returnerar inställningsformatet, dess avsnitt och tips för mappning | Ingen |
export_organization_settings | Exporterar de aktuella inställningarna, med hemligheter som platshållare | Ingen |
preview_organization_settings_import | Visar vad ett paket skulle ändra utan att skriva något | Ingen |
apply_organization_settings_import | Tillämpar ett paket, som som standard slås samman med de aktuella inställningarna eller ersätter dem | Alltid |
Ett paket innehåller platshållare i stället för hemliga värden, och Coroid avvisar paket som innehåller en hemlighet. Se Exportera och importera inställningar.
Versioner via MCP
Versionsverktygen är desamma som chattassistenten använder, och de följer samma Release API som portalen:
| Verktyg | Omfattning | Godkännande |
|---|---|---|
list_releases, get_release, list_release_commits, preview_release, get_release_settings, list_release_pull_requests | mcp.read | Inget |
create_release, update_release, run_release_checks, draft_release_notes | mcp.delivery | Inget |
approve_release, request_release_deployment, bundle_release_pull_requests | mcp.delivery | Alltid |
update_release_versioning | mcp.projects.admin | Inget |
create_release tar emot en fullständig commit-SHA, en kort SHA för en nylig commit eller
latest, och använder projektets versionskälla om du inte anger någon. get_release visar kontrollerna, den senaste driftsättningen och den version som rapporterats av din pipeline för varje miljö, samt om Coroid har verifierat den version som körs. En token med åtkomst till vissa projekt kan inte nå versioner i andra projekt. Release API tillämpar fortfarande sina egna godkännanderegler, så ett godkännande via MCP räknas precis som ett i portalen.
list_release_pull_requests returnerar ett projekts öppna pull requests i den ordning Coroid föreslår, tillsammans med skälet till att eventuella pull requests utelämnas.
bundle_release_pull_requests skapar en release utifrån dem: en release-branch
med pull requests sammanfogade i ordning och en release-pull request. Den pushar
en branch och öppnar en pull request, så den alltid väntar på en person. Utelämna
prNumbers om du vill använda Coroids urval.
Godkännanden och automatiseringspolicyer
Godkännanden är en kö med åtgärder som väntar på en människa. Automatiseringspolicyer avgör vad som ska hamna i kön.
Det här är den viktiga kontrollen. En extern klient som agerar för din räkning ska kunna utföra rutinuppgifter fritt, men bara utföra betydelsefulla åtgärder när en person har godkänt dem. Ställ in policyerna innan du ger en token till något som körs utan uppsikt.
När ett anrop kräver godkännande får klienten ett godkännande-ID och en länk i stället för ett resultat. En ägare eller administratör granskar det exakta verktyget och argumenten och godkänner eller avvisar sedan anropet. Vid godkännande körs anropet exakt som det skickades, och klienten kan inte ändra det i efterhand. Anrop som inte godkänns inom 10 minuter upphör att gälla.
Med en automatiseringspolicy kan en åtkomsttoken köra verktyg markerade med Policy utan att invänta godkännande. Endast ägare kan skapa policyer och koppla dem till token. En policy anger exakt vilka verktyg som omfattas, kan begränsas till vissa projekt och sätter ett tak för hur många anrop som får köras per timme, per dag och samtidigt. Den kan också upphöra att gälla. Om en policy återkallas återkallas även alla token som är kopplade till den. Verktyg markerade med Always omfattas aldrig av en policy.
En OAuth-anslutning kan inte ha en policy. Via OAuth kräver alla verktyg markerade med Policy godkännande.
Återförsök, åtgärder och resurser
Alla verktyg som ändrar något kräver den här parametern: idempotencyKey.
Använd en ny nyckel för varje ny åtgärd och samma nyckel när du försöker igen. Coroid returnerar då
det första resultatet i stället för att utföra åtgärden två gånger. Om en nyckel återanvänds med andra argument
avvisas anropet.
En ändring returnerar också en åtgärd som registrerar status och resultat. De här fyra verktygen fungerar för alla anslutningar:
| Verktyg | Vad det gör |
|---|---|
get_operation | Returnerar en åtgärds status och resultat |
wait_for_operation | Väntar i upp till 25 sekunder på att en åtgärd ska ändras |
cancel_operation | Avbryter en åtgärd som inte har startat |
get_approval | Returnerar ett godkännandes status och resultat |
Servern tillhandahåller också följande resurser:
| Resurs | Innehåll |
|---|---|
coroid://context | Vem anslutningen agerar som, med roll, behörigheter och projekt |
coroid://capabilities | Verktygen som anslutningen kan använda |
coroid://operations/{operationId} | En åtgärd |
coroid://approvals/{approvalId} | Ett godkännande |
Det finns också tre prompter: create_and_run_task, investigate_failure,
prepare_release.
Varje verktyg har gränser per minut, timme och dag. Ett anrop som överskrider en gräns misslyckas och anger hur länge du ska vänta innan du försöker igen.
Det här tillhandahålls medvetet inte
Verktygsregistret styrs av policyer, och begränsningarna är avsiktliga. Det ger inte tillgång till något av följande:
- ett shell
- Git-åtkomst
- filsystemet
- direktåtkomst till databasen
- godtycklig intern HTTP-trafik
- Coroid egna utgående MCP-administrationsverktyg
Du får möjlighet att hantera arbete — skapa och granska uppgifter, planer, projekt och versioner — inte en fjärrmiljö för körning. En MCP-klient kan inte använda Coroid för att köra godtyckliga kommandon.
När det passar bra
Styr Coroid där du redan arbetar — i en editor, en assistent eller ett internt verktyg — utan att växla till portalen. Skapa en uppgift från terminalen eller låt en assistent kontrollera vad som blockerar arbetet, direkt där du jobbar.