stackgate.ai
Alle integrationer

Laravel Forge

Forbind Claude, ChatGPT eller Cursor til Laravel Forge via MCP. Inspicér servere, læs deploy/Nginx-logs, og trigger deployments sikkert.

Manual setup 17 værktøjer

Overblik

Forbind Laravel Forge så AI-klienter kan inspicere dine servere, sites og deployments — og udløse deploys når det er nødvendigt.

Integrationen bruger Forge API v2 (https://forge.laravel.com/api). Det ældre API v1 er deprecated — opret tokens fra Account → API i det nuværende Forge-dashboard.

Forudsætninger

  • En Laravel Forge-konto med API-adgang
  • En stackgate.ai-konto

Credentials

  1. Log ind på Laravel Forge.
  2. Gå til Account → API og opret et API-token. Kopiér det et sikkert sted — Forge viser det kun én gang.
  3. Notér din organization slug fra Forge-URL'en når du ser din organisation (for eksempel forge.laravel.com/orgs/my-org → slug er my-org). Brug list_organizations efter forbindelse hvis du er usikker.
  4. I stackgate.ai, gå til Mine integrationer → Laravel Forge.
  5. Klik Aktivér og indtast din organization slug og API-token.

Se Forge API-dokumentationen for token-tilladelser og organisationsadgang.

Brug med AI-klienter

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

Forge returnerer JSON:API payloads. MCP-værktøjer normaliserer dem for AI-klienter:

  • Lister: { "items": [...], "meta": { "per_page", "next_cursor", "prev_cursor" }, "links": {...} }
  • Enkeltressourcer: fladede felter (id, type, plus attributter som name, status)
  • Logs: { "content": "..." }

Brug meta.next_cursor med page_cursor på list-værktøjer til paginering. List-værktøjer understøtter også valgfrie filter- og sort-parametre — se hvert værktøjs beskrivelse.

Vigtige værktøjer:

  • list_servers, list_sites, list_org_sites — gennemse infrastruktur (understøtter filtre)
  • get_site — site-detaljer; kun site_id kræves
  • list_deployments, get_deployment_log — deploy-historik og fejl
  • get_site_application_log, get_site_nginx_access_log, get_site_nginx_error_log — debugging
  • trigger_deployment — deploy nu (kræver site:manage-deploys)

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

Fejlfinding

  • 422 integration not configured — udfyld credential-formularen i Mine integrationer med både API-token og organization slug.
  • 401 Unauthorized — regenerér API-tokenet i Forge og opdater dine integrationscredentials.
  • 403 Forbidden — din Forge-rolle mangler muligvis tilladelse til handlingen (for eksempel kræver trigger_deployment site:manage-deploys).
  • 429 Too many requests — Forge begrænser API-kald til 60 pr. minut; vent og brug paginering cursors i stedet for hurtig polling.

Tilgængelige værktøjer

  • list_organizations

    List Laravel Forge organizations accessible to the connected API token.

  • get_current_user

    Get the Laravel Forge user profile for the connected API token.

  • list_servers

    List servers in the configured Forge organization. Supports filter[name], filter[ip_address], filter[region], filter[provider], filter[php_version], and sort.

  • get_server

    Get details for a single Forge server by ID.

  • list_sites

    List sites on a Forge server. Supports filter[name], sort, and include.

  • get_site

    Get details for a single site in the configured Forge organization. Only site_id is required.

  • list_org_sites

    List all sites across the configured Forge organization. Supports filter[name] and include.

  • list_deployments

    List deployment history for a Forge site. Supports filter[commit_hash], filter[commit_message], filter[commit_author], and sort.

  • get_deployment

    Get details for a single deployment on a Forge site.

  • get_deployment_log

    Get the output log for a Forge site deployment.

  • get_deployment_script

    Get the deployment script configured for a Forge site.

  • get_deployment_status

    Get the current deployment status for a Forge site.

  • list_server_events

    List recent events for a Forge server. Supports filter[initiated_by], filter[ran_as], sort, and include.

  • get_site_application_log

    Get the application log for a Forge site.

  • get_site_nginx_access_log

    Get the Nginx access log for a Forge site.

  • get_site_nginx_error_log

    Get the Nginx error log for a Forge site.

  • trigger_deployment

    Trigger a deployment for a Forge site (Deploy Now). Requires site:manage-deploys permission.

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

Relaterede workflows

Multi-integrations-playbooks, der bruger Laravel Forge til konkrete forretningsresultater.

Opret konto Dokumentation