MCP
Troubleshooting MCP Connectivity
This guide provides troubleshooting steps for known issues when connecting to the Glean MCP Server.
Prerequisites
Before troubleshooting, verify:- MCP Server enabled: Admin Console > Platform > MCP
- OAuth Server enabled: Admin Console > Settings > Third-party access (OAuth)
- Correct instance name: Found in Admin Console > Settings > About Glean
- User has Glean access: Active account with appropriate permissions
Known Issues
ChatGPT: Initial Connection Error Requiring Refresh
Symptoms:- Error message when first connecting the ChatGPT connector
- Connection succeeds after refreshing the page
- Refresh the page after initial connection attempt
- If issue persists, re-add the Glean MCP connector in ChatGPT settings
https://[instance-name]-be.glean.com/mcp/chatgpt and supports search and fetch tools.
General Setup Requirements
Authentication
- OAuth server must be enabled (Admin Console > Settings > Third-party access)
- User must have active Glean account with appropriate permissions
- For API tokens: Use scopes MCP, AGENT, SEARCH, CHAT, DOCUMENTS, TOOLS, ENTITIES
Network
- Firewall must allow HTTPS traffic to
*.glean.com - Check proxy settings if behind corporate firewall
Host-Specific Configuration
- Refer to the MCP Host configurator for detailed setup instructions for your specific host
Support
During Beta:- Post in Developer Community group in Gleaniverse
- Include: Host application, error messages, reproduction steps
- MCP Host configurator - Latest setup instructions
- Setting up Glean MCP Server - Initial setup guide