Troubleshoot MCP Connectivity

This guide provides troubleshooting steps for known issues when connecting to Glean MCP server.

Prerequisites

Before troubleshooting, complete the following prerequisites:

1. MCP Server enabled: Admin console → Platform → Glean MCP servers
2. OAuth Server enabled: Admin console → Users & permissions → Third-party access (OAuth)
3. Correct instance name: Found in Admin console → About Glean
4. User has Glean access: Active account with appropriate permissions

Known Issues

ChatGPT

See host-specific troubleshooting: ChatGPT

Glean plug-in for Cursor, Claude Code, and Codex

For marketplace installation, authentication, tool availability, and host reload issues, see Troubleshoot Glean plug-in deployment and Troubleshoot the Glean plug-in.

General Setup Requirements

Authentication

• OAuth server must be enabled (Admin console → Users & permissions → Third-party access (OAuth))
• User must have active Glean account with appropriate permissions
• For API tokens: Use the MCP scope. No other scopes are needed for MCP access.

Network

• Firewall must allow HTTPS traffic to *.glean.com
• Check proxy settings if behind corporate firewall

Host-Specific Configuration

• Refer to the MCP Configurator for user-facing host setup instructions: Navigate to Settings → Install → MCP Configurator
• Conceptual overview: What is an MCP Host?

Support

During Beta:

• Post in the Glean developer community on Gleaniverse
• Include: Host application, error messages, reproduction steps

Resources:

• MCP Configurator - Navigate to Settings → Install → MCP Configurator
• Setting up Glean MCP server - Initial setup guide