convez.ai
MCP ServerIntegração & APIsIntermediário
gleanwork

Configurador de Servidor MCP para Glean

gleanwork/configure-mcp-server

Configure clientes MCP para conectar aos servidores Glean automaticamente

Ver no GitHub
BomPluginScore · de 0 a 100

Utilitário de linha de comando que configura clientes MCP populares para conectar aos servidores MCP da Glean. Suporta tanto servidores remotos com OAuth e DCR quanto instâncias locais experimentais, facilitando a integração com a plataforma Glean.

Instalação

$npx convez-ai gleanwork/configure-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
75%
Último commit
há 1 mês
Versão
v3.2.1
Issues abertas
7
Contribuidores
8

Casos de uso

  • Integração automática de clientes MCP com servidores remotos Glean
  • Gerenciamento de autenticação OAuth com Dynamic Client Registration
  • Configuração de servidores MCP locais em desenvolvimento

Veredito

Ferramental sólido (GA) para integração com ecossistema Glean/MCP. Essencial para desenvolvedores que precisam conectar clientes MCP aos servidores Glean, com suporte robusto a OAuth/DCR e autenticação por token.

README

A tradução para o português deste README ainda está na fila.

@gleanwork/configure-mcp-server

GA CI Build npm version License

A command-line utility for configuring popular MCP clients to connect to Glean's MCP servers.

Overview

This package configures MCP clients to connect to:

  • Remote MCP servers (primary): URL-based servers that use OAuth with Dynamic Client Registration (DCR) for authentication
  • Local MCP server (experimental): Locally-installed server instances using @gleanwork/local-mcp-server

Authentication

OAuth with Dynamic Client Registration (Recommended): Automatic authentication with no manual token management required. This is the preferred method for remote MCP servers.

Bearer Tokens: For MCP hosts that don't support OAuth, you can use user-scoped Client API tokens with the MCP scope. Contact your Glean administrator to provision these tokens.

Configuration

Remote MCP Servers (Recommended)

Configure your client to connect to a remote MCP server using OAuth:

npx -y @gleanwork/configure-mcp-server remote --url https://your-instance-be.glean.com/mcp/default --client cursor

Supported clients: cursor, claude-desktop, claude-code, vscode, windsurf, goose

For clients that don't support OAuth, you can specify a token:

npx -y @gleanwork/configure-mcp-server remote --url https://your-instance-be.glean.com/mcp/default --client cursor --token your-api-token

Local MCP Server

For local server installations, specify both token and instance:

npx -y @gleanwork/configure-mcp-server local --client cursor --token your-api-token --server-url https://your-company-be.glean.com

# Deprecated: --instance is still accepted but --server-url is preferred
npx -y @gleanwork/configure-mcp-server local --client cursor --token your-api-token --instance instance-name

You can also use an environment file:

npx -y @gleanwork/configure-mcp-server local --client cursor --env path/to/.env.glean

The environment file should contain:

GLEAN_SERVER_URL=https://your-company-be.glean.com
GLEAN_API_TOKEN=your-api-token
# Deprecated: GLEAN_INSTANCE is still accepted but GLEAN_SERVER_URL is preferred
# GLEAN_INSTANCE=instance-name

Note: Both GLEAN_SUBDOMAIN and GLEAN_INSTANCE are deprecated. Use GLEAN_SERVER_URL instead.

Post-Configuration Steps

  • Cursor: Restart Cursor and the agent will have access to Glean tools
  • Claude Desktop: Restart Claude and use the hammer icon to access Glean tools
  • Windsurf: Open Settings > Advanced Settings, scroll to Cascade section, and press refresh
  • Goose: Restart Goose to load the new configuration

Project Initialization

You can initialize project-level tools and prompts for enhanced development experience:

# Initialize Cursor rules
npx -y @gleanwork/configure-mcp-server init --client cursor

# Initialize Claude Code agents
npx -y @gleanwork/configure-mcp-server init --client claude-code

# Create AGENTS.md file
npx -y @gleanwork/configure-mcp-server init --agents

# Preview files without creating them
npx -y @gleanwork/configure-mcp-server init --client cursor --dryRun

This creates client-specific files:

  • Cursor: .cursor/rules/glean-mcp.mdc - Usage rules and examples
  • Claude Code: .claude/agents/*.md - AI agents for enhanced development
  • AGENTS.md: Project-level documentation following the agents.md standard

Server Name Configuration

By default, the CLI uses glean_default as the server name in generated templates. If your Glean MCP server is configured with a different name, you can specify it using the --server-name flag:

# Use custom server name with Cursor
npx -y @gleanwork/configure-mcp-server init --client cursor --server-name my_company_glean

# Use custom server name with Claude Code
npx -y @gleanwork/configure-mcp-server init --client claude-code --server-name enterprise_glean

# Combine with other options
npx -y @gleanwork/configure-mcp-server init --client cursor --agents --server-name acme_glean

This ensures that all generated prompts and configurations reference the correct server name for your MCP setup. The server name must match the name you used when configuring your MCP server connection.

Contributing

Please see CONTRIBUTING.md for development setup and guidelines.

License

MIT License - see the LICENSE file for details

Support

Ver o original no GitHub

Bom para

Relacionados