Laravel Cloud
Forbind Claude, ChatGPT eller Cursor til Laravel Cloud via MCP. Inspicér apps, environments og deployments, og trigger deploys sikkert.
Eksempelspørgsmål
Prøv at spørge din AI-klient
-
Hvilke Laravel Cloud-applikationer er i denne organisation?
-
Blev production-environment-deployet færdigt efter i går aftes?
-
Opsummér de seneste fejlede deployment-logs - deploy ikke igen.
-
Skriv et kort notat til Amalie om environment-status - stop ikke noget.
-
Hvilke kommandoer kørte på staging det sidste døgn?
Overblik
Forbind Laravel Cloud, så AI-klienter kan inspicere applikationer, environments, deployments, logs og forbrug - og trigger deploys, kommandoer eller environment-ændringer, når Write-adgang er slået til.
Integrationen bruger Laravel Cloud API på https://cloud.laravel.com/api. stackgate.ai gemmer dit organisations-API-token krypteret og returnerer værktøjsresultater til din AI-klient for den pågældende forespørgsel.
Forudsætninger
- En Laravel Cloud-organisation med API-adgang
- En stackgate.ai-konto
Hent credentials
- Log ind på Laravel Cloud og åbn den organisation, du vil forbinde.
- Gå til Settings → API tokens og klik Create API Token.
- Giv tokenet et navn, f.eks.
stackgate.ai. - Vælg udløb (1 måned, 6 måneder eller 1 år).
- Begræns tilladelser, og eventuelt én applikation eller ét environment, til det mindst nødvendige.
- Kopiér tokenet med det samme. Cloud viser det kun én gang.
- I stackgate.ai, åbn Mine integrationer → Laravel Cloud, indsæt tokenet, og klik Connect & enable.
- Gem valgfrit et standard application ID. Brug
list_applicationsefter forbindelsen, hvis du er i tvivl. - Brug Edit tool access efter forbindelsen, så Write-værktøjer er slået fra, indtil du har brug for en deploy eller ændring.
Behandl tokenet som en adgangskode. Roter det i Cloud, hvis det bliver eksponeret, og opdater Mine integrationer inden udløbsdatoen.
Se Laravel Cloud API-autentificering for token-opsætning.
Svarformat
Laravel Cloud returnerer JSON:API-payloads. MCP-værktøjer normaliserer dem til AI-klienter:
- Lister:
{ "items": [...], "meta": { ... }, "links": {...} } - Enkeltressourcer: fladgjorte felter (
id,typeplus attributter somname,status) - Deployment-logs: rå Cloud log-JSON (
data.build/ deploy-trin), ikke fladgjort JSON:API
Brug page på listeværktøjer, når svaret indeholder meta.current_page / meta.last_page. Environment-logs bruger cursor, from og to.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/laravel-cloudmed et Sanctum bearer-token - Private gateway: én config til alle integrationer - brug
laravel-cloud__*-navngivne værktøjer
Se Dokumentation for HTTP-godkendelse og private gateway-opsætning.
Anbefalet workflow
get_organization/list_applications- bekræft tokenet og find application ID'er.list_environments/get_environment- se status (running,stopped,hibernating,deploying).list_deployments/get_deployment/get_deployment_logs- debug fejlede builds.initiate_deployment- deploy nu (Write-adgang).list_environment_logs,run_command/get_command- runtime-fejlfinding.- Domæne-, env-var-, instance-, cache- og usage-værktøjer til resten af control planet.
Fejlfinding
- 422 integration not configured - indsæt et API-token under Mine integrationer.
- 401 Unauthorized - tokenet er udløbet eller tilbagekaldt. Opret et nyt token i Cloud Settings → API tokens og opdater Mine integrationer.
- 403 Forbidden - tokenet er scopet til en anden applikation eller et andet environment, eller mangler den RBAC-tilladelse.
- 429 Too many requests - vent, og brug paginering eller command/deploy-polling i stedet for tætte loops.
- Manglende applikation - sæt et standard application ID, eller send
application_idpå værktøjskaldet. - Destruktive handlinger -
stop_environment,delete_domainog sletning af env-vars kan give nedetid. Bekræft intent før Write-adgang. - Hemmeligheder i svar -
get_environmentkan indeholde variabelværdier. Indsæt ikke secrets i chatten, medmindre du bad om dem.
Tilgængelige værktøjer
-
get_organization
Get the Laravel Cloud organization for the connected API token.
-
list_regions
List available Laravel Cloud regions.
-
list_applications
List Laravel Cloud-applikationer i den forbundne organisation.
-
get_application
Get a Laravel Cloud application by ID.
-
list_environments
List environments for en applikation. Bruger standard application_id hvis det er gemt.
-
get_environment
Get a Laravel Cloud environment by ID. May include environment variable values - do not echo secrets unless the user asked.
-
list_deployments
List deployments for a Laravel Cloud environment. Supports filter[status], filter[branch_name], filter[commit_hash], and include.
-
get_deployment
Get a Laravel Cloud deployment by ID, including status, commit, and failure_reason.
-
get_deployment_logs
Get build and deploy logs for a Laravel Cloud deployment. Returns step output, not a JSON:API document.
-
initiate_deployment
Start en deployment for et environment. Bekræft med brugeren først.
-
list_environment_logs
Search Laravel Cloud environment logs. from and to are required ISO-8601 timestamps. Use cursor from a previous response for the next page.
-
get_environment_metrics
Get metrics for a Laravel Cloud environment.
-
start_environment
Start a Laravel Cloud environment and trigger a deployment. Confirm with the user first.
-
stop_environment
Stop a Laravel Cloud environment and cancel any in-progress deployment. Confirm with the user first.
-
purge_edge_cache
Purge the edge cache for all domains on a Laravel Cloud environment.
-
add_environment_variables
Add or update environment variables on a Laravel Cloud environment. Never echo secret values unless the user asked.
-
delete_environment_variables
Delete environment variables by key. Atomic: if any key is missing, nothing is deleted.
-
list_commands
List one-off commands run on a Laravel Cloud environment.
-
run_command
Kør en engangskommando på et environment og poll get_command for output.
-
get_command
Get a Laravel Cloud command by ID, including status, exit_code, and output.
-
list_domains
List custom domains for a Laravel Cloud environment.
-
get_domain
Get a Laravel Cloud domain and its required DNS records.
-
create_domain
Create a custom domain on a Laravel Cloud environment. After creating, add the DNS records from the response, then call verify_domain.
-
verify_domain
Check whether DNS records for a Laravel Cloud domain are set up.
-
delete_domain
Delete a Laravel Cloud domain. Confirm with the user first.
-
list_instances
List compute instances for a Laravel Cloud environment.
-
get_instance
Get a Laravel Cloud instance by ID.
-
list_instance_sizes
List available Laravel Cloud instance sizes grouped by category.
-
get_usage
Get Laravel Cloud usage for a billing period. period 0 is the current cycle.
-
list_caches
List Laravel Cloud caches for the connected organization.
-
get_cache
Get a Laravel Cloud cache by ID.
-
list_database_clusters
List Laravel Cloud database clusters for the connected organization.
-
get_database_cluster
Get a Laravel Cloud database cluster by ID.
MCP-endpoint:
https://stackgate.ai/mcp/laravel-cloud
(HTTP) eller via
private gateway.