105 lines
1.9 KiB
Markdown
105 lines
1.9 KiB
Markdown
---
|
|
description: Configure GCloud CLI authentication
|
|
---
|
|
|
|
# GCloud Tools Setup
|
|
|
|
**Source:** [googleapis/gcloud-mcp](https://github.com/googleapis/gcloud-mcp)
|
|
|
|
Check GCloud MCP status and configure CLI authentication if needed.
|
|
|
|
## Step 1: Check gcloud CLI
|
|
|
|
Run: `gcloud --version`
|
|
|
|
If not installed: Continue to Step 2.
|
|
If installed: Skip to Step 3.
|
|
|
|
## Step 2: Install gcloud CLI
|
|
|
|
Tell the user:
|
|
|
|
```
|
|
Install Google Cloud SDK:
|
|
|
|
macOS (Homebrew):
|
|
brew install google-cloud-sdk
|
|
|
|
macOS/Linux (Manual):
|
|
curl https://sdk.cloud.google.com | bash
|
|
exec -l $SHELL
|
|
|
|
Windows:
|
|
Download from: https://cloud.google.com/sdk/docs/install
|
|
|
|
After install, restart your terminal.
|
|
```
|
|
|
|
## Step 3: Authenticate
|
|
|
|
Run these commands:
|
|
|
|
```bash
|
|
# Login with your Google account
|
|
gcloud auth login
|
|
|
|
# Set up Application Default Credentials (required for MCP)
|
|
gcloud auth application-default login
|
|
```
|
|
|
|
Both commands will open a browser for authentication.
|
|
|
|
## Step 4: Set Default Project
|
|
|
|
```bash
|
|
# List available projects
|
|
gcloud projects list
|
|
|
|
# Set default project
|
|
gcloud config set project YOUR_PROJECT_ID
|
|
```
|
|
|
|
## Step 5: Verify Setup
|
|
|
|
Run: `gcloud auth list`
|
|
|
|
Should show your authenticated account with asterisk (\*).
|
|
|
|
## Step 6: Restart Claude Code
|
|
|
|
Tell the user:
|
|
|
|
```
|
|
After authentication:
|
|
1. Exit Claude Code
|
|
2. Run `claude` again
|
|
|
|
The MCP will use your gcloud credentials.
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
If GCloud MCP fails:
|
|
|
|
```
|
|
Common fixes:
|
|
1. ADC not found - Run gcloud auth application-default login
|
|
2. Project not set - Run gcloud config set project PROJECT_ID
|
|
3. Permission denied - Check IAM roles in Cloud Console
|
|
4. Quota exceeded - Check quotas in Cloud Console
|
|
5. Token expired - Run gcloud auth application-default login again
|
|
```
|
|
|
|
## Alternative: Disable Plugin
|
|
|
|
If user doesn't need GCloud integration:
|
|
|
|
```
|
|
To disable this plugin:
|
|
1. Run /mcp command
|
|
2. Find the gcloud-observability server
|
|
3. Disable it
|
|
|
|
This prevents errors from missing authentication.
|
|
```
|