stackgate.ai
Alle integrationer

Cursor Cloud Agents

Start og gennemgå Cursor Cloud Agents via MCP. Start agents på GitHub-repos, følg op med runs, og inspicér resultater og artifacts med en API-nøgle.

Manual setup 15 værktøjer

Overblik

Forbind Cursor Cloud Agents, så AI-klienter kan starte cloud agents på dine repositories, sende opfølgende prompts, og gennemgå run-status, resultater og artifacts via Cloud Agents API.

stackgate.ai gemmer din Cursor API-nøgle krypteret og kalder https://api.cursor.com på dine vegne. Værktøjsresultater returneres til din AI-klient for den pågældende forespørgsel.

Automations (planer, GitHub/Slack-triggers, tilladelsesscopes) konfigureres i Cursor Automations. Denne integration dækker start og gennemgang af cloud agents via den offentlige API - ikke oprettelse eller aktivering af Automations-definitioner.

Forudsætninger

  • En Cursor-konto med adgang til Cloud Agents
  • GitHub forbundet i Cursor til repo-baserede agents
  • En stackgate.ai-konto

Hent credentials

  1. Log ind på Cursor og åbn Dashboard → API Keys.
  2. Opret en bruger-API-nøgle eller en service account-nøgle. Kopiér den én gang (ofte med præfiks crsr_).
  3. Åbn Mine integrationer → Cursor Cloud Agents i stackgate.ai, indsæt nøglen, og klik Connect & enable.
  4. Angiv valgfrit et standard environment-navn (et navngivet Cursor cloud-environment fra dit Cloud Agents-dashboard). Når det er sat, kan create_agent bruge det environment, hvis du udelader repo_url.

Behandl nøglen som en adgangskode. Tilbagekald eller roter den i Cursor, hvis den bliver eksponeret.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/cursor med et Sanctum bearer-token
  • Private gateway: én config til alle integrationer - brug cursor__*-navngivne værktøjer

Se Dokumentation for HTTP-godkendelse og private gateway-opsætning.

Anbefalet workflow

  1. get_api_key_info / list_models - bekræft nøglen og vælg model om nødvendigt.
  2. list_agents / get_agent - find eksisterende agents.
  3. create_agent med prompt_text og repo_url (eller brug default_environment / environment_name).
  4. get_run - poll indtil FINISHED / ERROR / CANCELLED / EXPIRED; læs result og git.
  5. create_run til opfølgning; cancel_run hvis agenten er busy.
  6. list_artifacts / download_artifact til walkthrough-filer; archive_agent når du er færdig.

Fejlfinding

  • 422 integration not configured - indsæt en Cursor API-nøgle i Mine integrationer.
  • 401 Unauthorized - regenerér nøglen under Dashboard → API Keys og opdatér Mine integrationer.
  • Provide repo_url or environment - create_agent understøtter ikke no-repo agents. Angiv repo_url, eller sæt default_environment / environment_name. Navngivne environments og eksplicitte repos er gensidigt udelukkende upstream.
  • 409 agent_busy - vent på det aktive run, eller kald cancel_run, og brug derefter create_run.
  • 429 Too many requests - Cursor håndhæver team-rate limits; vent og prøv igen. Undgå at polle list_repositories (ca. 1/min og 30/time pr. bruger).
  • Automations-styring - aktiver/deaktiver triggers og tilladelser i Cursor-UI; denne MCP eksponerer ikke en Automations control API.

Tilgængelige værktøjer

  • get_api_key_info

    Get metadata for the connected Cursor API key (name, user email when user-scoped).

  • list_models

    List recommended models and parameters for create_agent model.id / model.params.

  • list_agents

    List Cursor cloud agents for den forbundne konto.

  • get_agent

    Get durable metadata for a Cursor cloud agent. Use latestRunId with get_run for execution status.

  • create_agent

    Opret en Cursor cloud agent og start det første run.

  • list_runs

    List runs for a Cursor cloud agent, newest first.

  • get_run

    Hent status og resultat for et agent-run.

  • create_run

    Send a follow-up prompt to an existing active agent. Returns 409 if another run is already CREATING or RUNNING.

  • cancel_run

    Cancel the active run for an agent. Cancellation is terminal; create a new run to continue.

  • archive_agent

    Archive a Cursor cloud agent. Archived agents remain readable but cannot accept new runs until unarchived.

  • unarchive_agent

    Unarchive a Cursor cloud agent so it can accept new runs again.

  • get_agent_usage

    Get token usage for an agent, optionally scoped to a single run.

  • list_artifacts

    List artifacts produced by a Cursor cloud agent (paths relative to artifacts/).

  • download_artifact

    Get a temporary presigned URL to download an agent artifact. Pass the path from list_artifacts.

  • list_repositories

    List GitHub repositories accessible via Cursor GitHub App installation. Very strict rate limits (about 1 request per user per minute and 30 per hour) - do not poll.

MCP-endpoint: https://stackgate.ai/mcp/cursor (HTTP) eller via private gateway.

Opret konto Dokumentation