Connect using our agent skill
The fastest way to connect your GCP project. Our agent skill walks you through the setup and configures the required service account automatically.Copy and run this prompt to connect your GCP project automatically.
Manual setup
If you prefer to configure the service account yourself, follow the steps below.Set up manually
Set up manually
Before you begin
- GCP project access — make sure you are logged in to the Google Cloud project you want to connect.
- Your Leanly tenant ID — find this in your Leanly dashboard under Settings.
1. Create the operator service account
Create a service account
Click Create service account and enter a friendly name (e.g.
LeanlyOperator), then click Create and continue.Assign the required roles
Search for and add each of the following roles, then click Continue.
- Service Account Admin (
roles/iam.serviceAccountAdmin) — create and manage workload-specific service accounts - Project IAM Admin (
roles/resourcemanager.projectIamAdmin) — bind project-level roles to those service accounts - Viewer (
roles/viewer) — read-only visibility into project resources
Add Leanly as a service account user
Under Grant users access to this service account, add the following as a Service Account User.Then click Done.
2. Connect the service account to Leanly
Open integrations
In your Leanly dashboard, go to Integrations, select Google Cloud, and click Connect Account.
Acknowledge the setup
Confirm that you have created the operator service account. This will reveal the service account input field.
Permissions
The operator service account is granted the minimum permissions needed to manage workload infrastructure on your behalf.| Role | Why |
|---|---|
roles/iam.serviceAccountAdmin | Create and manage workload-specific service accounts |
roles/resourcemanager.projectIamAdmin | Bind project-level roles to the new service accounts |
roles/viewer | Read-only visibility into project resources |
