docs: document developer token access levels and add MCP client configs#62
Conversation
Raibaz
left a comment
There was a problem hiding this comment.
Thanks for putting this together!
Left a couple comments.
| 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 |
There was a problem hiding this comment.
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.
| ``` | ||
|
|
||
|
|
||
| #### Claude Code (Anthropic) |
There was a problem hiding this comment.
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?
|
Thanks for the review!
|
|
|
||
| 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 |
There was a problem hiding this comment.
I'd also mention that developer tokens must have at least explorer access here.
| ``` | ||
|
|
||
|
|
||
| <<<<<<< HEAD |
There was a problem hiding this comment.
You may want to resolve conflicts here :)
…ent MCP setup instructions
b5875b2 to
d6b35ce
Compare
|
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! |
Summary
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