VanThiel Documentation MCP Server

MCP (Model Context Protocol) server that provides Claude Desktop with access to VanThiel System documentation stored in OneDrive.

Features

• ✅ Zero Setup - No local documentation needed
• ✅ Cloud-Based - Reads directly from OneDrive shared folder
• ✅ Always Up-to-Date - Team sees latest docs when you update OneDrive
• ✅ Simple Install - One npm command
• ✅ Cross-Platform - Works on Windows, Mac, Linux

Installation

For Team Members (Super Simple - No Installation!)

Step 1: Configure Claude Desktop

Edit your Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "vanthiel-docs": {
      "command": "npx",
      "args": [
        "vanthiel-docs-mcp@latest"
      ],
      "env": {
        "VANTHIEL_CLIENT_SECRET": "YOUR_CLIENT_SECRET_HERE"
      }
    }
  }
}

IMPORTANT: Replace YOUR_CLIENT_SECRET_HERE with the actual Azure AD client secret provided by your IT admin.

Step 2: Restart Claude Desktop

Close and reopen Claude Desktop. You should see a tool icon (🔨) indicating MCP is connected.

Done! The package is automatically downloaded and run via npx. No manual installation needed!

Usage Examples

Ask About Business Logic

User: "Show me the notification logic in IT Services"

Claude will:
1. Search VanThiel documentation
2. Read business-rules.md from OneDrive
3. Explain BR-016: Email Notification Rules
4. Provide code references

Ask About Architecture

User: "Explain the 4-layer architecture pattern"

Claude will:
1. Read backend common-patterns.md
2. Explain Controller → Service → Repository → Database flow
3. Show implementation examples

Ask About Status Transitions

User: "What are the valid status transitions for IT requests?"

Claude will:
1. Read IT Services business-rules.md
2. Show BR-003: Request Status Progression
3. Explain validation rules

Search Across All Docs

User: "Find all documentation about reopening requests"

Claude will:
1. Search all markdown files
2. Find mentions in business-rules.md
3. Provide code locations and explanations

Available Tools

When this MCP server is connected, Claude Desktop has access to these tools:

1. list_docs

Lists all available VanThiel documentation files

Example: "List all available documentation"

2. read_doc

Reads a specific documentation file

Example: "Read the IT Services business rules document"

3. search_docs

Searches for text across all documentation

Example: "Search for 'notification' in the documentation"

OneDrive Documentation Location

This MCP server reads from: OneDrive: https://vanthielantiques-my.sharepoint.com/:f:/g/personal/anh_h_vanthiel_com/Ejg6HrySAwhAgyhPV6--KHsBGX-iala_d0BE96gL3sECFw?e=5mfxE4

Maintained by: [email protected]

Documentation Structure:

VanThiel Documentation/
├── CLAUDE.md (main system overview)
├── .claude/docs/
│   ├── architecture/
│   │   └── system-overview.md
│   ├── backend/
│   │   └── common-patterns.md
│   └── frontend/
│       └── portal-guide.md
└── backend/
    └── it-services/
        ├── CLAUDE.md
        └── docs/
            ├── business-rules.md
            ├── domain-model.md
            └── compliance-rules.md

Troubleshooting

MCP Not Connected

Problem: Tool icon (🔨) doesn't appear in Claude Desktop

Solution:

1. Check config file syntax (must be valid JSON)
2. Verify path: %APPDATA%\Claude\claude_desktop_config.json
3. Restart Claude Desktop
4. Check logs: %APPDATA%\Claude\logs\

Command Not Found

Problem: vanthiel-docs-mcp: command not found

Solution:

# Reinstall globally
npm install -g vanthiel-docs-mcp

# Verify installation
npm list -g vanthiel-docs-mcp

OneDrive Access Issues

Problem: "Error reading document from OneDrive"

Solution:

1. Verify you can access the OneDrive link in browser
2. Check share permissions with [email protected]
3. Wait a few minutes and retry (OneDrive rate limiting)

For Developers

Local Development

# Clone/navigate to the MCP server directory
cd C:\SourceGitHub\.claude\mcp-server

# Install dependencies
npm install

# Link for local testing
npm link

# Test the server
node index.js

Update OneDrive URL

Edit config.js and update the shareUrl:

export const ONEDRIVE_CONFIG = {
  shareUrl: 'your-new-onedrive-url',
  // ...
};

Add New Documentation Files

Edit config.js and add to DOCS_STRUCTURE:

export const DOCS_STRUCTURE = {
  'path/to/new-doc.md': 'Description of new document',
  // ...
};

Version History

v1.0.0 (Initial Release)

• OneDrive integration
• Read documentation files
• Search across all docs
• List available files
• Caching support

Support

Issues? Contact VanThiel IT Team

• Email: [email protected]
• Teams: VanThiel IT Support

License

UNLICENSED - Internal use only for VanThiel company