---
title: How do I connect a GCP project for the first time?
description: Once a user has been invited to OpsCompass they can add an account to be monitored by OpsCompass as long as they are an administrator in GCP.
---
[Skip to content](https://kb.opscompass.com/knowledge/connect-a-gcp-account#main-content)
[](https://opscompass.com)
- [Home](https://opscompass.com/)
- [Why Opscompass](https://opscompass.com/why-opscompass/)
- Product
Show submenu for Product
- [Inventory](https://opscompass.com/inventory/)
- [Configuration Drift](https://opscompass.com/product/configuration-drift/)
- [Compliance](https://opscompass.com/product/compliance/)
- [Licenses](https://opscompass.com/solutions/licenses/)
- Solutions
Show submenu for Solutions
- [Hybrid and Multi-Cloud Visibility](https://opscompass.com/solutions/multi-cloud-visibility/)
- [About Us](https://opscompass.com/company/)
Open main navigation
Close main navigation
- [Home](https://opscompass.com/)
- [Why Opscompass](https://opscompass.com/why-opscompass/)
- Product
Show submenu for Product
- [Inventory](https://opscompass.com/inventory/)
- [Configuration Drift](https://opscompass.com/product/configuration-drift/)
- [Compliance](https://opscompass.com/product/compliance/)
- [Licenses](https://opscompass.com/solutions/licenses/)
- Solutions
Show submenu for Solutions
- [Hybrid and Multi-Cloud Visibility](https://opscompass.com/solutions/multi-cloud-visibility/)
- [About Us](https://opscompass.com/company/)
- [Get a Demo](https://opscompass.com/demo/)
[Get a Demo](https://opscompass.com/demo/)
What are you looking for?
- There are no suggestions because the search field is empty.
1. [Help Center](https://kb.opscompass.com/knowledge)
2. [Getting Started](https://kb.opscompass.com/knowledge/getting-started)
3. [Connecting Cloud Accounts](https://kb.opscompass.com/knowledge/getting-started#connecting-cloud-accounts)
# How do I connect a GCP project for the first time?
## Once a user has been invited to OpsCompass they can add an account to be monitored by OpsCompass as long as they are an administrator in GCP.
*Note: OpsCompass will be provisioned to require only read-only permissions.*
1.) Click the "Add Project" button for Google Cloud Platform.
2.) Copy the OpsCompass Service Account information
*Note: We will use this account information in the GCP console in a minute.*
3.) Navigate to GCP ([https://console.cloud.google.com](https://console.cloud.google.com/)), click the top drop down menu, and navigate & click into the project you would like to add to OpsCompass.
4.) Search for "IAM" and select "IAM & Admin" from the results.
5.) Click the "Grant Access" button. Paste the Service Account information into the "New Principles" text field and click "Select a role"
6.) Add the role "Viewer" under "Project" \> "Viewer". Click "Save".
7.) To verify the new role is successful, navigate back to IAM & Admin \> IAM within GCP.
monitoring@opscompass.iam.gserviceaccount.com should now have a "viewer" role:
8.) Navigate to the GCP Dashboard for your project, and copy the "Project ID".
9.) Navigate back to OpsCompass, and paste the "Project ID" into the text field. Click the "Connect" button.
OpsCompass will begin to scan the environment. You will see the accounts added to the dashboard, and a compliance score will begin to be assigned as we analyze the resources.
Additional Resource:
[How do I connect additional clouds to OpsCompass](https://kb.opscompass.com/knowledge/how-do-i-connect-a-cloud-account-to-opscompass)?
[How do I connect an Azure account to OpsCompass](https://kb.opscompass.com/knowledge/connect-an-azure-account)?
[How do I connect an AWS account to OpsCompass](https://kb.opscompass.com/knowledge/connect-an-aws-account)?
[How do I connect a Microsoft 365 Tenant to OpsCompass](https://kb.opscompass.com/knowledge/connect-365-account)?
[How do I invite a new user to OpsCompass](https://kb.opscompass.com/knowledge/invite-user)?
- [About Opscompass](https://kb.opscompass.com/knowledge/about-opscompass#main-content)
- [Company Information](https://kb.opscompass.com/knowledge/about-opscompass#company-information)
- [Getting Started](https://kb.opscompass.com/knowledge/getting-started#main-content)
- [Logging In](https://kb.opscompass.com/knowledge/getting-started#logging-in)
- [Connecting Cloud Accounts](https://kb.opscompass.com/knowledge/getting-started#connecting-cloud-accounts)
- [Users and Teams](https://kb.opscompass.com/knowledge/getting-started#users-and-teams)
- [Opscompass CLI](https://kb.opscompass.com/knowledge/opscompass-cli#main-content)
- [Getting Started](https://kb.opscompass.com/knowledge/opscompass-cli#getting-started)
- [Resources](https://kb.opscompass.com/knowledge/opscompass-cli#resources)
- [Accounts](https://kb.opscompass.com/knowledge/opscompass-cli#accounts)
- [Compliance](https://kb.opscompass.com/knowledge/opscompass-cli#compliance)
- [Licensing](https://kb.opscompass.com/knowledge/opscompass-cli#licensing)
- [Examples](https://kb.opscompass.com/knowledge/opscompass-cli#examples)
- [AI Skills](https://kb.opscompass.com/knowledge/opscompass-cli#ai-skills)
- [Opscompass FAQs](https://kb.opscompass.com/knowledge/opscompass-faqs#main-content)
- [General](https://kb.opscompass.com/knowledge/opscompass-faqs#general)
- [New Features](https://kb.opscompass.com/knowledge/new-features)
- [Account Management](https://kb.opscompass.com/knowledge/account-management)
- [Compliance](https://kb.opscompass.com/knowledge/compliance)
- [Documents](https://kb.opscompass.com/knowledge/documents)
- [Drift](https://kb.opscompass.com/knowledge/drift)
- [Inventory](https://kb.opscompass.com/knowledge/inventory)
- [Licenses](https://kb.opscompass.com/knowledge/licenses#main-content)
- [Oracle](https://kb.opscompass.com/knowledge/licenses#oracle)
- [SQL Server](https://kb.opscompass.com/knowledge/licenses#sql-server)
- [Navigation and Dashboard](https://kb.opscompass.com/knowledge/navigation-and-dashboard)
- [Opscompass Integrations](https://kb.opscompass.com/knowledge/opscompass-integrations)
- [Tutorials](https://kb.opscompass.com/knowledge/tutorials#main-content)
- [CLI](https://kb.opscompass.com/knowledge/tutorials#cli)
[](http://opscompass.com)
Copyright © 2025, Opscompass