MCP Server Integration Guide

Integration Overview

The InitRepo MCP Server integrates with popular AI development tools to provide structured project context and intelligent assistance. This guide covers setup for all supported tools and platforms.

Prerequisites Required: Your project must have InitRepo-generated documentation in the /docs folder with proper ID structure. Generate documentation at initrepo.com first.

Supported AI Development Tools

Claude Code

Native MCP integration with Anthropic’s AI coding assistant

Cursor

Enhanced AI IDE with advanced MCP support

VS Code

Popular editor with MCP extension support

JetBrains IDEs

IntelliJ, WebStorm, PyCharm, and other JetBrains tools

Claude Code Integration

Quick Setup (Recommended)

For the fastest setup, use Claude Code’s built-in MCP integration command:

Quick Connection Command

claude mcp add --transport http initrepo https://mcp.initrepo.com/

What happens when you run this:

Claude Code attempts to connect to the MCP server
Server responds with “Authentication Required”
Claude Code automatically opens https://initrepo.com/mcp-auth in your browser
Sign in and generate your MCP token
Claude Code detects successful authentication and connects automatically

Manual Token Setup (if needed)

If the automatic flow doesn’t work, get your token manually:

Visit: https://initrepo.com/mcp-auth
Sign in with your account
Generate your MCP token
Use the token with Claude Code:

claude mcp add --transport http initrepo https://mcp.initrepo.com/?token=YOUR_TOKEN

Verify Connection

Ask Claude Code:

"What InitRepo tools are available?"

You should see a list of 37+ available tools including:

Project analysis and structure understanding
Context retrieval by ID (T-001, US-001, etc.)
Task management and prioritization
Documentation validation
Implementation guidance

Alternative Manual Setup

If you prefer manual configuration or need custom settings:

Install InitRepo MCP Server

npm install -g initrepo-mcp

Verify installation:

initrepo-mcp --version

Configure Claude Code

Add to your Claude Code configuration file:

{
  "mcp": {
    "servers": {
      "initrepo": {
        "command": "initrepo-mcp",
        "args": [],
        "env": {}
      }
    }
  }
}

Verify Connection

Ask Claude Code:

"What InitRepo tools are available?"

You should see a list of 37+ available tools.

Test Intelligence

Try these example queries:

"Show me the context for task T-001"
"What are my highest priority tasks today?"
"Generate an implementation brief for US-005"

Claude Code Usage Examples

Daily Development Planning:

You: "What should I work on today?"

Claude Code (with MCP): Based on your InitRepo project documentation, here are your highest priority tasks:

1. T-003: Implement user authentication (blocking US-001)
2. T-007: Set up database schema (dependency for multiple stories)
3. T-012: Create API error handling middleware (high business value)

Each task includes full context with acceptance criteria, dependencies, and implementation guidance.

Implementation Guidance:

You: "How should I implement the user authentication system?"

Claude Code (with MCP): Based on T-003 and related technical architecture:

[Provides detailed implementation brief including:]
- Technical requirements from architecture docs
- Step-by-step implementation plan
- Code examples and best practices
- Testing strategies
- Integration points with other components

Cursor Integration

Setup Process

Configuration
Workspace Setup

Add to your Cursor settings or .cursorrules:

{
  "mcpServers": {
    "initrepo-mcp": {
      "command": "initrepo-mcp",
      "args": []
    }
  }
}

Create a .cursor/mcp.json file in your project root:

{
  "servers": {
    "initrepo": {
      "command": "initrepo-mcp",
      "args": [],
      "cwd": ".",
      "env": {
        "INITREPO_PROJECT_PATH": "."
      }
    }
  }
}

Enhanced Cursor Workflows

AI-Enhanced Code Completion:

Cursor automatically provides context-aware suggestions based on your project requirements
Code completions include relevant user stories and acceptance criteria
Intelligent variable and function naming based on project terminology

Real-Time Context Sharing:

Cursor maintains awareness of current task context (T-001, US-005, etc.)
Automatic cross-referencing between code changes and requirements
Live validation against acceptance criteria during coding

Smart Code Review:

Automatic checking of implementation against project requirements
Suggestion of missing components based on user stories
Integration testing recommendations based on technical architecture

VS Code Integration

Extension Installation

Install MCP Extension

Search for and install the “Model Context Protocol” extension in VS Code marketplace

Configure Settings

Add to your VS Code settings.json:

{
  "mcp.servers": {
    "initrepo": {
      "command": "initrepo-mcp",
      "args": [],
      "env": {}
    }
  },
  "mcp.autoStart": true
}

Restart VS Code

Restart VS Code to load the MCP server configuration

Verify Integration

Open the Command Palette (Ctrl/Cmd+Shift+P) and search for “MCP” commands

VS Code Features

Command Palette Integration:

MCP: Get Task Context - Retrieve context for specific tasks
MCP: Generate Implementation Brief - Create detailed implementation guidance
MCP: Validate Documentation - Check project documentation completeness
MCP: Show Project Map - Display project structure and relationships

Side Panel Integration:

InitRepo Explorer: Navigate project structure by epics, user stories, and tasks
Context Viewer: Display relevant context for current file or selection
Progress Tracker: Monitor task completion and dependencies

Status Bar Information:

Current task context (T-001, US-005, etc.)
Project completion percentage
Next recommended task

JetBrains IDEs Integration

Plugin Installation

IntelliJ IDEA

Go to File → Settings → Plugins
Search for “InitRepo MCP” plugin
Install and restart IntelliJ IDEA
Configure in Settings → Tools → InitRepo MCP

WebStorm

Open WebStorm → Preferences → Plugins
Install “InitRepo MCP” plugin
Configure server settings in Tools → InitRepo

PyCharm

Settings → Plugins → Install “InitRepo MCP”
Configure Python project integration
Enable AI assistant features

JetBrains Configuration

<!-- .idea/mcp.xml -->
<mcp>
  <servers>
    <server name="initrepo-mcp">
      <command>initrepo-mcp</command>
      <args></args>
      <workingDirectory>$PROJECT_DIR$</workingDirectory>
    </server>
  </servers>
</mcp>

JetBrains Features

Integrated AI Assistant:

Right-click context menus with InitRepo intelligence
Inline code suggestions based on project requirements
Automatic documentation generation for functions and classes

Project Navigation:

Navigate between code and requirements using ID references
Jump from implementation to related user stories
Visualize dependencies between tasks and code components

Code Quality Integration:

Real-time validation against acceptance criteria
Suggestion of missing test cases based on requirements
Architecture compliance checking

Terminal Integration

Setup for Command Line Usage

Install Terminal Client

npm install -g @initrepo/mcp-client

Initialize Configuration

initrepo-mcp-client init

Test Connection

initrepo-mcp-client query "What tools are available?"

Terminal Usage Examples

Interactive Mode:

# Start interactive session
initrepo-mcp-client interactive

# Example queries in interactive mode
> get-context T-001
> generate-implementation-brief US-005
> validate-documentation

Script Integration:

#!/bin/bash
# Get context for current sprint tasks

TASKS=("T-001" "T-002" "T-003")

for task in "${TASKS[@]}"; do
    echo "Getting context for $task..."
    initrepo-mcp-client query "get-context $task" > "context-$task.md"
done

echo "Task contexts generated!"

Advanced Integration Scenarios

CI/CD Pipeline Integration

GitHub Actions Workflow:

name: InitRepo MCP Analysis
on: [push, pull_request]

jobs:
  mcp-analysis:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
          
      - name: Install InitRepo MCP
        run: npm install -g initrepo-mcp @initrepo/mcp-client
        
      - name: Validate Documentation
        run: |
          initrepo-mcp-client query "validateDocumentationCompleteness" > validation.json
          cat validation.json
          
      - name: Generate Progress Report
        run: |
          initrepo-mcp-client query "generateProgressReport" > progress.md
          
      - name: Upload Reports
        uses: actions/upload-artifact@v3
        with:
          name: mcp-analysis
          path: |
            validation.json
            progress.md

Team Collaboration Setup

Shared Configuration:

// .initrepo/team-mcp-config.json
{
  "team": {
    "name": "Development Team Alpha",
    "members": ["dev1", "dev2", "dev3"],
    "shared_context": true,
    "progress_sync": true
  },
  "notifications": {
    "slack_webhook": "https://hooks.slack.com/...",
    "progress_updates": true,
    "blocker_alerts": true
  }
}

Team Dashboard Integration:

// team-dashboard.js
const MCPClient = require('@initrepo/mcp-client');

class TeamDashboard {
    async getTeamProgress() {
        const client = new MCPClient();
        
        const progress = await client.query('generateProgressReport', {
            scope: 'team',
            includeVelocity: true,
            includeBlockers: true
        });
        
        return this.formatDashboard(progress);
    }
    
    formatDashboard(progress) {
        return {
            completedTasks: progress.completed.length,
            inProgressTasks: progress.inProgress.length,
            blockers: progress.blockers,
            velocity: progress.teamVelocity,
            estimatedCompletion: progress.estimatedCompletion
        };
    }
}

Troubleshooting Integration

Common Issues

Server Not Detected

Symptoms: AI assistant doesn’t recognize InitRepo toolsSolutions:

# Verify installation
which initrepo-mcp
initrepo-mcp --version

# Check if server starts
initrepo-mcp --test

# Restart your AI assistant/IDE

No InitRepo Documentation Found

Symptoms: Error message about missing documentation structureSolutions:

Ensure /docs folder exists in your project
Verify documentation was generated by InitRepo platform
Check for proper ID format (T-001, US-001, E-001)
Validate documentation completeness using CLI

Connection Timeout

Symptoms: MCP server connection fails or times outSolutions:

# Check system resources
ps aux | grep initrepo-mcp

# Restart server
pkill initrepo-mcp
initrepo-mcp --restart

# Check logs
initrepo-mcp --logs

Performance Optimization

For Large Projects:

Enable caching: Set INITREPO_CACHE_ENABLED=true
Increase memory: export NODE_OPTIONS="--max-old-space-size=2048"
Use specific context scopes to reduce processing time
Configure background processing for non-critical queries

For Teams:

Set up dedicated MCP server instance for team sharing
Use WebSocket transport for real-time collaboration
Configure load balancing for multiple concurrent users
Implement progress synchronization across team members

Best Practices

Development Workflow Integration

Start with Context: Always get task context before beginning implementation
Validate Frequently: Use MCP tools to verify implementation against requirements
Document Decisions: Record architectural decisions using MCP intelligence
Track Progress: Regular progress updates maintain project visibility

Team Collaboration

Shared Standards: Use consistent MCP queries across team members
Regular Sync: Schedule regular progress synchronization
Communication: Use MCP insights to inform team communications
Knowledge Sharing: Leverage MCP context for knowledge transfer

Advanced Integration Scenarios

CI/CD Pipeline Integration

GitHub Actions Workflow:

name: InitRepo MCP Analysis
on: [push, pull_request]

jobs:
  mcp-analysis:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install InitRepo MCP
        run: npm install -g initrepo-mcp @initrepo/mcp-client

      - name: Validate Documentation
        run: |
          initrepo-mcp-client query "validateDocumentationCompleteness" > validation.json
          cat validation.json

      - name: Generate Implementation Brief
        run: |
          initrepo-mcp-client query "generateSmartImplementationBrief" --args '{"taskId": "T-001"}' > brief.md
          cat brief.md

Jenkins Pipeline:

pipeline {
    agent any

    stages {
        stage('MCP Analysis') {
            steps {
                sh 'npm install -g initrepo-mcp'

                sh 'initrepo-mcp validateDocumentationCompleteness > validation.json'

                sh 'initrepo-mcp generateProgressReport > progress.md'

                archiveArtifacts artifacts: '*.json,*.md', fingerprint: true
            }
        }
    }

    post {
        always {
            publishHTML(target: [
                allowMissing: false,
                alwaysLinkToLastBuild: true,
                keepAll: true,
                reportDir: '.',
                reportFiles: 'validation.json,progress.md',
                reportName: 'MCP Analysis'
            ])
        }
    }
}

Team Collaboration Setup

Shared Configuration:

// .initrepo/team-mcp-config.json
{
  "team": {
    "name": "Development Team Alpha",
    "members": ["dev1", "dev2", "dev3"],
    "shared_context": true,
    "progress_sync": true
  },
  "notifications": {
    "slack_webhook": "https://hooks.slack.com/...",
    "progress_updates": true,
    "blocker_alerts": true
  }
}

Team Dashboard Integration:

// team-dashboard.js
const MCPClient = require('@initrepo/mcp-client');

class TeamDashboard {
    async getTeamProgress() {
        const client = new MCPClient();

        const progress = await client.query('generateProgressReport', {
            scope: 'team',
            includeVelocity: true,
            includeBlockers: true
        });

        return this.formatDashboard(progress);
    }

    formatDashboard(progress) {
        return {
            completedTasks: progress.completed.length,
            inProgressTasks: progress.inProgress.length,
            blockers: progress.blockers,
            velocity: progress.teamVelocity,
            estimatedCompletion: progress.estimatedCompletion
        };
    }
}

Terminal Integration

Setup for Command Line Usage:

# Install terminal client
npm install -g @initrepo/mcp-client

# Initialize configuration
initrepo-mcp-client init

# Test connection
initrepo-mcp-client query "What tools are available?"

Interactive Mode:

# Start interactive session
initrepo-mcp-client interactive

# Example queries
> get-context T-001
> generate-implementation-brief US-005
> validate-documentation

Script Integration:

#!/bin/bash
# Get context for current sprint tasks

TASKS=("T-001" "T-002" "T-003")

for task in "${TASKS[@]}"; do
    echo "Getting context for $task..."
    initrepo-mcp-client query "get-context $task" > "context-$task.md"
done

echo "Task contexts generated!"

Performance Optimization

For Large Projects:

Enable caching: Set INITREPO_CACHE_ENABLED=true
Increase memory: export NODE_OPTIONS="--max-old-space-size=2048"
Use specific context scopes to reduce processing time
Configure background processing for non-critical queries

For Teams:

Set up dedicated MCP server instance for team sharing
Use WebSocket transport for real-time collaboration
Configure load balancing for multiple concurrent users
Implement progress synchronization across team members

Troubleshooting Integration

Common Issues

Server Not Detected

Symptoms: AI assistant doesn’t recognize InitRepo toolsSolutions:

# Verify installation
which initrepo-mcp
initrepo-mcp --version

# Check if server starts
initrepo-mcp --test

# Restart your AI assistant/IDE

No InitRepo Documentation Found

Symptoms: Error message about missing documentation structureSolutions:

Ensure /docs folder exists in your project
Verify documentation was generated by InitRepo platform
Check for proper ID format (T-001, US-001, E-001)
Validate documentation completeness using CLI

Connection Timeout

Symptoms: MCP server connection fails or times outSolutions:

# Check system resources
ps aux | grep initrepo-mcp

# Restart server
pkill initrepo-mcp
initrepo-mcp --restart

# Check logs
initrepo-mcp --logs

Next Steps

Explore All 37+ Tools

Learn about every MCP tool and advanced capabilities

Best Practices Guide

Optimize your MCP integration for maximum productivity

Troubleshooting Guide

Solve common issues and get help when needed

Complete Quick Start

Follow our 5-minute setup guide to get started immediately

Getting Started

Plans & Pricing

Security & Compliance

MCP Server

CLI Tool

​Integration Overview

​Supported AI Development Tools

Claude Code

Cursor

VS Code

JetBrains IDEs

​Claude Code Integration

​Quick Setup (Recommended)

​Alternative Manual Setup

​Claude Code Usage Examples

​Cursor Integration

​Setup Process

​Enhanced Cursor Workflows

​VS Code Integration

​Extension Installation

​VS Code Features

​JetBrains IDEs Integration

​Plugin Installation

​JetBrains Configuration

​JetBrains Features

​Terminal Integration

​Setup for Command Line Usage

​Terminal Usage Examples

​Advanced Integration Scenarios

​CI/CD Pipeline Integration

​Team Collaboration Setup

​Troubleshooting Integration

​Common Issues

​Performance Optimization

​Best Practices

​Development Workflow Integration

​Team Collaboration

​Advanced Integration Scenarios

​CI/CD Pipeline Integration

​Team Collaboration Setup

​Terminal Integration

​Performance Optimization

​Troubleshooting Integration

​Common Issues

​Next Steps

Explore All 37+ Tools

Best Practices Guide

Troubleshooting Guide

Complete Quick Start

Integration Overview

Supported AI Development Tools

Claude Code Integration

Quick Setup (Recommended)

Alternative Manual Setup

Claude Code Usage Examples

Cursor Integration

Setup Process

Enhanced Cursor Workflows

VS Code Integration

Extension Installation

VS Code Features

JetBrains IDEs Integration

Plugin Installation

JetBrains Configuration

JetBrains Features

Terminal Integration

Setup for Command Line Usage

Terminal Usage Examples

Advanced Integration Scenarios

CI/CD Pipeline Integration

Team Collaboration Setup

Troubleshooting Integration

Common Issues

Performance Optimization

Best Practices

Development Workflow Integration

Team Collaboration

Advanced Integration Scenarios

CI/CD Pipeline Integration

Team Collaboration Setup

Terminal Integration

Performance Optimization

Troubleshooting Integration

Common Issues

Next Steps