@gleanwork/mcp-config-glean

@gleanwork/mcp-config-glean

Glean-specific MCP configuration defaults and helpers. Wraps @gleanwork/mcp-config-schema with Glean-specific constants and convenience functions.

Installation

npm install @gleanwork/mcp-config-glean

Usage

Quick Start

import {
  createGleanRegistry,
  createGleanHeaders,
  buildGleanMcpUrl,
} from '@gleanwork/mcp-config-glean';

// Create a pre-configured registry (remote / HTTP only)
const registry = createGleanRegistry();
const builder = registry.createBuilder('cursor');

// Generate HTTP configuration
const httpConfig = builder.buildConfiguration({
  transport: 'http',
  serverUrl: buildGleanMcpUrl('https://my-company-be.glean.com'),
  headers: createGleanHeaders('my-api-token'),
});

// Pin the CLI version in generated install commands
const command = builder.buildCommand({
  transport: 'http',
  serverUrl: buildGleanMcpUrl('https://my-company-be.glean.com'),
  headers: createGleanHeaders('my-api-token'),
  cliVersion: '3.1.0',
});
// -> `npx -y @gleanwork/configure-mcp-server@3.1.0 remote --url ... --client cursor --token ...`

Available Exports

Constants

import { GLEAN_REGISTRY_OPTIONS, GLEAN_ENV } from '@gleanwork/mcp-config-glean';

// Registry options for Glean's remote MCP server (HTTP only)
GLEAN_REGISTRY_OPTIONS.tokenEnvVarName   // 'GLEAN_API_TOKEN'
GLEAN_REGISTRY_OPTIONS.commandBuilder    // Functions to generate CLI commands
GLEAN_REGISTRY_OPTIONS.serverNameBuilder // Callback that prefixes server names with glean_
GLEAN_REGISTRY_OPTIONS.managedSetupUrls  // Admin setup destinations for managed clients

// Environment variable names
GLEAN_ENV.SERVER_URL // 'GLEAN_SERVER_URL'
GLEAN_ENV.API_TOKEN  // 'GLEAN_API_TOKEN'

The Glean registry provides managed setup destinations for ChatGPT, Claude Teams/Enterprise, and Cursor Team:

const registry = createGleanRegistry();

registry.getManagedSetupUrl('chatgpt');
// https://chatgpt.com/admin/apps?tab=available&q=glean

registry.getManagedSetupUrl('claude-teams-enterprise');
// https://claude.ai/directory/connectors/glean

registry.getManagedSetupUrl('cursor-team');
// https://cursor.com/dashboard/integrations

Helper Functions

Function	Description
createGleanRegistry()	Create MCPConfigRegistry with Glean defaults
createGleanServerUrlEnv(serverUrl, apiToken?)	Create env vars using server URL
buildGleanMcpUrl(serverUrl, endpoint?)	Build full MCP endpoint URL from server URL
createGleanHeaders(apiToken)	Create Authorization header
normalizeGleanProductName(productName?)	Normalize product name for white-labeling (defaults to 'glean')
buildGleanServerName(options)	Build server name with glean_ prefix
normalizeGleanServerName(name, productName?)	Normalize server name to safe config key with prefix

Server Name Functions

These functions handle server name generation with proper prefixing:

import {
  normalizeGleanProductName,
  buildGleanServerName,
  normalizeGleanServerName,
} from '@gleanwork/mcp-config-glean';

// Normalize product names for white-labeling
normalizeGleanProductName();              // 'glean'
normalizeGleanProductName('Acme Corp');   // 'acme_corp'

// Build server names with glean_ prefix
buildGleanServerName({ transport: 'http' });                               // 'glean_default'
buildGleanServerName({ transport: 'http', serverUrl: '.../mcp/analytics' }); // 'glean_analytics'
buildGleanServerName({ serverName: 'custom' });                            // 'glean_custom'
buildGleanServerName({ agents: true });                                    // 'glean_agents'

// Normalize existing server names
normalizeGleanServerName('custom');        // 'glean_custom'
normalizeGleanServerName('glean_custom');  // 'glean_custom' (no double prefix)

Types

import type { GleanConnectionOptions, GleanEnvVars } from '@gleanwork/mcp-config-glean';

// GleanConnectionOptions extends MCPConnectionOptions with:
// - productName?: string  (for white-label support)
// - agents?: boolean      (use agents endpoint)

Re-exports

This package re-exports everything from @gleanwork/mcp-config-schema, so you can import both Glean-specific and generic types from a single package:

import {
  // Glean-specific
  createGleanRegistry,
  createGleanServerUrlEnv,
  GLEAN_ENV,

  // From mcp-config-schema
  MCPConfigRegistry,
  type MCPConnectionOptions,
  type ClientId,
} from '@gleanwork/mcp-config-glean';

Migration from @gleanwork/mcp-config

If you're migrating from the older @gleanwork/mcp-config package:

• Update your package.json:

  - "@gleanwork/mcp-config": "^3.x"
  + "@gleanwork/mcp-config-glean": "^4.x"
  

• Update your imports:

  - import { ... } from '@gleanwork/mcp-config';
  + import { ... } from '@gleanwork/mcp-config-glean';
  

The API is fully compatible - no code changes required beyond the import path.

Related Packages

• @gleanwork/mcp-config-schema - Vendor-neutral base package with core types and builders

License

MIT