Skip to content

docs: add macOS + Claude Desktop installation guide (closes #29)#145

Open
ZLeventer wants to merge 1 commit intogoogleanalytics:mainfrom
ZLeventer:docs/macos-claude-desktop-install-guide
Open

docs: add macOS + Claude Desktop installation guide (closes #29)#145
ZLeventer wants to merge 1 commit intogoogleanalytics:mainfrom
ZLeventer:docs/macos-claude-desktop-install-guide

Conversation

@ZLeventer
Copy link
Copy Markdown

Summary

Adds a comprehensive macOS + Claude Desktop installation guide at docs/installation-macos-claude-desktop.md, closing #29.

The main README covers Gemini CLI setup well but leaves Claude Desktop users without step-by-step guidance. This guide fills that gap, covering the issues flagged in #29 that the README doesn't address.

What's covered

  1. Prerequisites and Python/pipx/gcloud installation
  2. Google Cloud project setup
  3. Enabling the Analytics Data and Admin APIs
  4. Creating an OAuth 2.0 Desktop client (with consent screen walkthrough)
  5. Running gcloud auth application-default login with correct scopes
  6. Quota project configuration (set-quota-project) — a common failure point not in the README
  7. Claude Desktop config (claude_desktop_config.json) with full absolute paths
  8. Verification steps
  9. Troubleshooting section covering 6 common errors:
    • Insufficient authentication scopes
    • Quota exceeded / RESOURCE_EXHAUSTED
    • Server not appearing in tools
    • Silent call failures (with log path)
    • "Cannot perform dynamic registration without issuer" (Gemini CLI only — directs users away from /mcp auth)

A one-line link to the guide is added to the README's setup section.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant