Main
按 README 建议使用更短的 server 名(如
gtm-mcp-server),避免部分客户端的名称长度限制导致工具被过滤。OAuth 凭据按机密处理:多人共享环境时按需清理本地 auth 状态。
先跑只读操作确认账号/容器选择无误,再逐步开放会产生变更的操作。
建议维护变更日志:agent 驱动的 GTM 变更应有可读的人工审计轨迹。
README (excerpt)
MCP Server for Google Tag Manager
This is a server that supports remote MCP connections, with Google OAuth built-in and provides an interface to the Google Tag Manager API.
Access the remote MCP server from Claude Desktop
Open Claude Desktop and navigate to Settings -> Developer -> Edit Config. This opens the configuration file that controls which MCP servers Claude can access.
Replace the content with the following configuration. Once you restart Claude Desktop, a browser window will open showing your OAuth login page. Complete the authentication flow to grant Claude access to your MCP server. After you grant access, the tools will become available for you to use.
{
"mcpServers": {
"gtm-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://gtm-mcp.stape.ai/mcp"
]
}
}
}Troubleshooting
MCP Server Name Length Limit
Some MCP clients (like Cursor AI) have a 60-character limit for the combined MCP server name + tool name length. If you use a longer server name in your configuration (e.g., gtm-mcp-server-your-additional-long-name), some tools may be filtered out.
To avoid this issue:
- Use shorter server names in your MCP configuration (e.g.,
gtm-mcp-server)
Clearing MCP Cache
mcp-remote stores all the credential information inside ~/.mcp-auth (or wherever your MCP_REMOTE_CONFIG_DIR points to). If you're having persistent issues, try running: You can run rm -rf ~/.mcp-auth to clear any locally stored state and tokens.
rm -rf ~/.mcp-authThen restarting your MCP client.
Source-backed notes
- README 提供 Claude Desktop 的 MCP 配置,使用
npx -y mcp-remote https://gtm-mcp.stape.ai/mcp连接。 - README 说明该远程 MCP Server 内置 OAuth,启动后会走浏览器授权流程。
- README 提醒部分客户端存在 server+tool 名称长度限制,并建议使用更短的 server 名。
FAQ
- 需要本地安装什么吗?:README 使用
npx+mcp-remote,主要需要 Node.js/npx。 - 为什么会弹出浏览器?:README 说明连接流程包含 OAuth 登录授权。
- 为什么工具显示不全?:README 提到名称长度限制;把 server 名改短通常能解决。