Skip to content

docs: update to use GLEAN_SERVER_URL instead of GLEAN_INSTANCE #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
chris-freeman-glean merged 1 commit into from
Mar 5, 2026
Merged

docs: update to use GLEAN_SERVER_URL instead of GLEAN_INSTANCE #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Official Glean plugins for [Claude Code](https://claude.com/claude-code), enabli

- [Claude Code](https://claude.com/claude-code) (latest version)
- A Glean account with MCP access
- Your Glean MCP server URL (format: `https://[instance]-be.glean.com/mcp/[server-name]`)
- Your Glean MCP server URL (find it at [app.glean.com/admin/about-glean](https://app.glean.com/admin/about-glean)); format: `[server-url]/mcp/[server-name]`

## Support

Expand Down
14 changes: 7 additions & 7 deletions plugins/glean-core/commands/mcp-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,9 @@ Help the user configure a Glean MCP server for Claude Code. This command can be

Guide the user through these steps interactively using AskUserQuestion:

### Step 1: Get Instance Name
### Step 1: Get Server URL

Ask the user for their Glean instance name. Explain that if their Glean URL is `https://acme-be.glean.com`, their instance name is `acme`.

You can find your Glean URL here: <https://app.glean.com/admin/about-glean>
Ask the user for their Glean server URL. Explain that they can find it at <https://app.glean.com/admin/about-glean>. The URL will look something like `https://acme-be.glean.com` or `https://be-4f5226e2.glean.com`.

### Step 2: Get Server Name

Expand All @@ -33,9 +31,11 @@ Ask what friendly name to use for this server in Claude Code. Suggest:
Once you have all three values, construct and run the command:

```bash
claude mcp add [friendly-name] https://[instance]-be.glean.com/mcp/[server-name] --transport http --scope user
claude mcp add [friendly-name] [server-url]/mcp/[server-name] --transport http --scope user
```

Where `[server-url]` is the URL from Step 1 (e.g., `https://acme-be.glean.com` or `https://be-4f5226e2.glean.com`).

### Step 5: Confirm Success

After running the command:
Expand All @@ -47,8 +47,8 @@ After running the command:

## Important Notes

- The URL format is: `https://[instance]-be.glean.com/mcp/[server-name]`
- The `-be` suffix is required (it's the backend endpoint)
- The URL format is: `[server-url]/mcp/[server-name]`
- Find your server URL at <https://app.glean.com/admin/about-glean>
- Transport must be `http` (Glean MCP is a remote server)
- Scope should be `user` for personal configuration
- Claude Code handles OAuth authentication automatically on first tool use