Skip to content

docs: document developer token access levels and add MCP client configs#62

Merged
Raibaz merged 1 commit intogoogleads:mainfrom
ZLeventer:docs/developer-token-access-levels
Apr 29, 2026
Merged

docs: document developer token access levels and add MCP client configs#62
Raibaz merged 1 commit intogoogleads:mainfrom
ZLeventer:docs/developer-token-access-levels

Conversation

@ZLeventer
Copy link
Copy Markdown
Contributor

Summary

  • Add a table documenting the three developer token access levels (test account, Basic, Standard) with what each can do and how to obtain it
  • Add a note explaining the common "test accounts only" error and how to resolve it
  • Add guidance for MCP end-users on how to navigate the Basic access application
  • Add Claude Code and Cursor/VS Code configuration examples alongside the existing Gemini examples
  • Rename the "Configure Gemini" section to "Configure your MCP client" since the server is client-agnostic

Motivation

Addresses #50 — multiple users have reported confusion when their developer token only works with test accounts. The README currently says "get a Developer Token" without explaining that new tokens start at test-account-only access and that a separate application is needed for production data.

The MCP client config examples address the implicit Gemini-only framing, since this server works equally well with Claude Code, Cursor, and other MCP clients.

Test plan

  • Verify all links resolve correctly
  • Confirm table renders properly on GitHub

Copy link
Copy Markdown
Collaborator

@Raibaz Raibaz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for putting this together!

Left a couple comments.

Comment thread README.md Outdated
Record 'YOUR_DEVELOPER_TOKEN', you will need this for the the 'Configure Gemini' step below
#### Developer Token Access Levels

New developer tokens start at **test account access**, which only works with
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not correct: new developer tokens may be automatically upgraded to Explorer access, which is sufficient to use the MCP server.

Besides, I don't want to duplicate existing documentation here, so I think we should just link to the right page in the Google Ads API documentation.

Comment thread README.md Outdated
```


#### Claude Code (Anthropic)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the idea of having instructions for different MCP clients, but since the format of the mcpServers block is the same, can we synthesize this?

@ZLeventer
Copy link
Copy Markdown
Contributor Author

Thanks for the review!

  • Replaced the duplicated access-levels content with a short pointer to the official access levels documentation.
  • Consolidated the per-client config blocks into a single "Other MCP clients" note that references the existing mcpServers example.

Comment thread README.md

Record 'YOUR_DEVELOPER_TOKEN', you will need this for the the 'Configure Gemini' step below
If you see the error *"The developer token is only approved for use with test
accounts"*, your token does not yet have access to production accounts. See the
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd also mention that developer tokens must have at least explorer access here.

Comment thread README.md Outdated
```


<<<<<<< HEAD
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You may want to resolve conflicts here :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah thank ya

@ZLeventer ZLeventer force-pushed the docs/developer-token-access-levels branch from b5875b2 to d6b35ce Compare April 29, 2026 01:19
@ZLeventer
Copy link
Copy Markdown
Contributor Author

Resolved the conflicts by rebasing onto current main (incorporating the Cloud Run/Docker changes from #65). Single clean commit now. Thanks again for the review!

@Raibaz Raibaz self-requested a review April 29, 2026 09:43
@Raibaz Raibaz merged commit 6f88c49 into googleads:main Apr 29, 2026
8 checks passed
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.

2 participants