Skip to content

Adds support for mcp server installation #4428

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

Closed
wants to merge 17 commits into from
Closed

Adds support for mcp server installation #4428

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
f216adb
Adds support for mcp server installation
axosoft-ramint Jun 25, 2025
2fa6250
Updates storage key and splits automatic and manual installation subt…
axosoft-ramint Aug 25, 2025
a45a6e3
Adds gates and deeplink command support
axosoft-ramint Aug 25, 2025
10bc6ff
Updates to include new params
axosoft-ramint Aug 26, 2025
e00ca9d
Updates terminology and adds telemetry
axosoft-ramint Aug 26, 2025
6bd22a7
Includes source and CLI version in telemetry
axosoft-ramint Aug 26, 2025
2adb175
Uses built-in app name function and always passes to mcp install command
axosoft-ramint Aug 26, 2025
b7227b0
Improvements from feedback
axosoft-ramint Aug 27, 2025
6116f26
Sends status from installCLI
axosoft-ramint Aug 27, 2025
fd02577
Install command always verifies path existence to proxy
axosoft-ramint Aug 27, 2025
e0cd714
Fixes wording inconsistencies on error messages
axosoft-ramint Aug 27, 2025
89daa6a
install -> setup
axosoft-ramint Aug 27, 2025
eff6102
Leaves out auto-install (for now)
axosoft-ramint Aug 27, 2025
3a3322c
Points release server to supported environment
axosoft-ramint Aug 27, 2025
a23c67f
Fixes 'checking for updates' CLI response from causing error with flow
axosoft-ramint Sep 4, 2025
55d8d3e
Adds messaging to complete setup manually on unsupported apps
axosoft-ramint Sep 4, 2025
2a0ea7a
Updates unsupported app modal and wording
axosoft-ramint Sep 4, 2025
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
4 changes: 4 additions & 0 deletions contributions.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -311,6 +311,10 @@
"icon": "$(sparkle)",
"commandPalette": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
},
"gitlens.ai.mcp.install": {
"label": "Install GitKraken MCP Server",
"commandPalette": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should add isWeb (I think that is the context key) here to not show this on the web

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not isWeb, or at least that's not working as intended because using && !isWeb in the "when" clause prevents the command from appearing even when I'm not on web.

},
Comment on lines +314 to +317
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Eventually we will want versions of this command to other usages (e.g. home, etc) so we can understand the usage and make sure source is correct

"gitlens.ai.rebaseOntoCommit:graph": {
"label": "AI Rebase Current Branch onto Commit (Preview)...",
"icon": "$(sparkle)",
Expand Down
2 changes: 2 additions & 0 deletions docs/links.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -274,6 +274,8 @@ _{prefix}/command/{command}_

- _inspect_ - Runs the `GitLens: Inspect Commit Details` command.

- _install-mcp_ - Runs the `GitLens: Install MCP` command.

- _login_ - Runs the `GitLens: Sign In to GitKraken...` command.

- _signup_ - Runs the `GitLens: Sign Up for GitKraken...` command.
Expand Down
233 changes: 153 additions & 80 deletions docs/telemetry-events.md
View file
Open in desktop

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6296,6 +6296,11 @@
"category": "GitLens",
"icon": "$(sparkle)"
},
{
"command": "gitlens.ai.mcp.install",
"title": "Install GitKraken MCP Server",
"category": "GitLens"
},
{
"command": "gitlens.ai.rebaseOntoCommit:graph",
"title": "AI Rebase Current Branch onto Commit (Preview)...",
Expand Down Expand Up @@ -11070,6 +11075,10 @@
"command": "gitlens.ai.generateRebase",
"when": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
},
{
"command": "gitlens.ai.mcp.install",
"when": "gitlens:enabled && !gitlens:untrusted && gitlens:gk:organization:ai:enabled"
},
{
"command": "gitlens.ai.rebaseOntoCommit:graph",
"when": "false"
Expand Down
1 change: 1 addition & 0 deletions src/constants.commands.generated.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -690,6 +690,7 @@ export type ContributedPaletteCommands =
| 'gitlens.ai.generateChangelog'
| 'gitlens.ai.generateCommitMessage'
| 'gitlens.ai.generateRebase'
| 'gitlens.ai.mcp.install'
| 'gitlens.ai.switchProvider'
| 'gitlens.applyPatchFromClipboard'
| 'gitlens.associateIssueWithBranch'
Expand Down
3 changes: 3 additions & 0 deletions src/constants.storage.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,9 @@ export type GlobalStorage = {
// Value based on `currentOnboardingVersion` in composer's protocol
'composer:onboarding:dismissed': string;
'composer:onboarding:stepReached': number;
'gk:cli:install': { status: 'attempted' | 'unsupported' | 'completed'; attempts: number; version?: string };
'gk:cli:corePath': string;
'gk:cli:path': string;
'home:sections:collapsed': string[];
'home:walkthrough:dismissed': boolean;
'launchpad:groups:collapsed': StoredLaunchpadGroup[];
Expand Down
51 changes: 51 additions & 0 deletions src/constants.telemetry.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,13 @@ export interface TelemetryEvents extends WebviewShowAbortedEvents, WebviewShownE
/** Sent when user opts in to AI All Access */
'aiAllAccess/optedIn': void;

/** Sent when a CLI install attempt is started */
'cli/install/started': CLIInstallStartedEvent;
/** Sent when a CLI install attempt succeeds */
'cli/install/succeeded': CLIInstallSucceededEvent;
/** Sent when a CLI install attempt fails */
'cli/install/failed': CLIInstallFailedEvent;

/** Sent when connecting to one or more cloud-based integrations */
'cloudIntegrations/connecting': CloudIntegrationsConnectingEvent;

Expand Down Expand Up @@ -238,6 +245,13 @@ export interface TelemetryEvents extends WebviewShowAbortedEvents, WebviewShownE
/** Sent when a launchpad operation is taking longer than a set timeout to complete */
'launchpad/operation/slow': LaunchpadOperationSlowEvent;

/** Sent when GitKraken MCP setup is started */
'mcp/setup/started': MCPSetupStartedEvent;
/** Sent when GitKraken MCP setup is completed */
'mcp/setup/completed': MCPSetupCompletedEvent;
/** Sent when GitKraken MCP setup fails */
'mcp/setup/failed': MCPSetupFailedEvent;

/** Sent when a PR review was started in the inspect overview */
openReviewMode: OpenReviewModeEvent;

Expand Down Expand Up @@ -472,6 +486,43 @@ export interface AIFeedbackEvent extends AIEventDataBase {
'unhelpful.custom'?: string;
}

export interface CLIInstallStartedEvent {
source?: Sources;
autoInstall: boolean;
attempts: number;
}

export interface CLIInstallSucceededEvent {
autoInstall: boolean;
attempts: number;
source?: Sources;
version?: string;
}

export interface CLIInstallFailedEvent {
autoInstall: boolean;
attempts: number;
'error.message'?: string;
source?: Sources;
}

export interface MCPSetupStartedEvent {
source: Sources;
}

export interface MCPSetupCompletedEvent {
source: Sources;
'cli.version'?: string;
requiresUserCompletion: boolean;
}

export interface MCPSetupFailedEvent {
source: Sources;
reason: string;
'cli.version'?: string;
'error.message'?: string;
}

interface CloudIntegrationsConnectingEvent {
'integration.ids': string | undefined;
}
Expand Down
1 change: 1 addition & 0 deletions src/constants.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -179,6 +179,7 @@ export const urls = Object.freeze({
githubDiscussions: `https://github.com/gitkraken/vscode-gitlens/discussions/?${utm}`,
helpCenter: `https://help.gitkraken.com/gitlens/gitlens-start-here/?${utm}`,
helpCenterHome: `https://help.gitkraken.com/gitlens/home-view/?${utm}`,
helpCenterMCP: `https://help.gitkraken.com/mcp/mcp-getting-started/?${utm}`,
releaseNotes: `https://help.gitkraken.com/gitlens/gitlens-release-notes-current/?${utm}`,

acceleratePrReviews: `https://help.gitkraken.com/gitlens/gitlens-start-here/?${utm}#accelerate-pr-reviews`,
Expand Down
Loading
Loading