IRM MCP Extension
Connects GitHub Copilot Chat to the IRM MCP Server for access to:
- IRM Knowledge Base (MediaWiki)
- IRM Git repositories
Installation
Install via VSIX package (internal distribution):
- Download the latest
irm-mcp-*.vsix from the release or from your admin
- In VS Code: Extensions → ⋯ → Install from VSIX...
- Restart VS Code
- Sign in via IRM MCP: Sign In to IRM Network (see Usage)
Sign-In (OAuth)
The extension uses OAuth 2.0 with PKCE — no passwords or secrets need to be configured manually.
- Open the Command Palette (
Ctrl+Shift+P)
- Run IRM MCP: Sign In to IRM Network
- A browser window opens with the IRM login page
- After login the browser confirms success and VS Code connects automatically
Your session is stored securely in VS Code's built-in credential store and refreshed automatically.
To sign out: IRM MCP: Sign Out from IRM Network
Configuration
All settings are optional. Defaults work for the standard IRM deployment.
| Setting |
Default |
Description |
irmMcp.serverUrl |
https://mcp.irmnet.de/sse |
MCP server SSE endpoint |
irmMcp.clientId |
github-copilot-irm |
OAuth client ID fallback (used when Dynamic Client Registration is unavailable) |
irmMcp.autoStart |
true |
Activate MCP provider on VS Code startup |
irmMcp.enableAutoReconnect |
true |
Automatically reconnect when the server restarts |
Usage
Once signed in, the extension connects to the IRM MCP server in the background. GitHub Copilot Chat can then use IRM tools automatically during conversations.
The MCP server entry in Copilot shows your username, e.g. IRM (Max Mustermann).
Commands
| Command |
Description |
| IRM MCP: Sign In to IRM Network |
Open browser login (OAuth PKCE) |
| IRM MCP: Sign Out from IRM Network |
Sign out and clear stored session |
| IRM MCP: Show Connection Status |
Show current connection state and logged-in user |
| IRM MCP: Restart MCP Server |
Manually restart the MCP server connection |
Auto-Reconnect
The extension reconnects automatically using exponential backoff (2 s → 4 s → 8 s → 16 s → 32 s, max 5 attempts). Disable with irmMcp.enableAutoReconnect: false.
Requirements
- VS Code ≥ 1.95
- GitHub Copilot Chat extension installed
- Node.js and npm available on
PATH (needed for npx mcp-remote)
- Network access to
mcp.irmnet.de
Development
Building & Packaging
# Compile TypeScript
npm run compile
# Run tests
npm test
# Create .vsix package (patch version bump + package)
npm run publish:patch
# Create .vsix and publish to VS Code Marketplace
npm run release:patch
Changelog & Version Management
# Add a changelog entry
npm run changelog:add "Your change description" -- --type=added|changed|fixed|removed
# Bump version only (creates new CHANGELOG section, no package)
npm run version:patch # bug fixes
npm run version:minor # new features
npm run version:major # breaking changes
See docs/CHANGELOG_GUIDE.md for details.
Architecture
src/authProvider.ts — vscode.AuthenticationProvider (OAuth 2.0 + PKCE, Dynamic Client Registration, token refresh)src/extension.ts — Extension entry point, MCP server definition provider, commandsscripts/ — Version bump, changelog, publish automation
