Add comprehensive agentic coding documentation
- Add 6 MCP server documentation pages (bc-code-intelligence, al-dependency, azure-devops, serena, al-objid, clockify) - Add AI Coding Agents documentation (GitHub Copilot, Claude, Cursor) - Add Getting Started section (what is agentic coding, setup, prompting, best practices, limitations, glossary) - Add Getting More section (code review, documentation, telemetry examples) - Add Community Resources placeholders (articles, videos, tools) - Update Tools section to focus on MCP servers instead of VSCode extensions
This commit is contained in:
Jeremy Vyska
parent
3254d9b7e8
commit
4db38ba4d3
28 changed files with 8152 additions and 0 deletions
133
content/docs/agentic-coding/CommunityResources/Tools/_index.md
Normal file
133
content/docs/agentic-coding/CommunityResources/Tools/_index.md
Normal file
|
|
@ -0,0 +1,133 @@
|
|||
---
|
||||
title: "MCP Servers"
|
||||
linkTitle: "Tools"
|
||||
weight: 3
|
||||
description: >
|
||||
Model Context Protocol (MCP) servers that enhance AI-assisted AL development
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This section catalogs Model Context Protocol (MCP) servers designed to enhance AI coding assistants for Business Central development. MCP is an open standard that enables AI assistants to connect to external tools, databases, and knowledge sources, making them significantly more powerful for AL development workflows.
|
||||
|
||||
**What is MCP?**
|
||||
- Standard protocol for connecting AI assistants to external capabilities
|
||||
- STDIO transport for local execution
|
||||
- Tool-based architecture for exposing features to AI assistants
|
||||
- Supported by Claude Desktop, GitHub Copilot, Cursor, VS Code extensions, and more
|
||||
|
||||
Each MCP server below has its own dedicated page with detailed information, setup instructions, and integration guidance.
|
||||
|
||||
---
|
||||
|
||||
## AL & Business Central MCP Servers
|
||||
|
||||
### [BC Code Intelligence MCP](bc-code-intelligence-mcp.md)
|
||||
|
||||
**Key Features**:
|
||||
- 14 specialist AI personas for BC development (Sam Coder, Dean Debug, Alex Architect, etc.)
|
||||
- 20+ MCP tools for knowledge discovery, code analysis, and workflow orchestration
|
||||
- Seamless specialist handoffs with context preservation
|
||||
- Integration with GitHub Copilot, Claude Desktop, VS Code
|
||||
|
||||
---
|
||||
|
||||
### [AL Dependency MCP Server](al-dependency-mcp-server.md)
|
||||
|
||||
**Key Features**:
|
||||
- Exposes AL workspace compiled symbols (.app files) to AI assistants
|
||||
- 6 token-optimized tools for symbol search and dependency analysis
|
||||
- O(1) lookups with optimized indexing for 50MB+ symbol files
|
||||
- Auto-discovers .alpackages directories
|
||||
|
||||
---
|
||||
|
||||
### [Serena MCP](serena-mcp.md)
|
||||
|
||||
**Key Features**:
|
||||
- Multi-language LSP-based coding assistant with AL support
|
||||
- AL Language Server integration via VS Code AL extension
|
||||
- Symbolic operations (find references, definitions, document symbols)
|
||||
- Supports 20+ languages including AL, Python, TypeScript, Rust, Go
|
||||
|
||||
---
|
||||
|
||||
### [AL Object ID Ninja MCP](al-objid-mcp-server.md)
|
||||
|
||||
**Key Features**:
|
||||
- AL object ID collision prevention and management
|
||||
- Two modes: LITE (individual developers) and STANDARD (teams)
|
||||
- Backend integration for shared ID pools and team collaboration
|
||||
- Automatic app identification via Git integration
|
||||
|
||||
---
|
||||
|
||||
## DevOps & Productivity MCP Servers
|
||||
|
||||
### [Azure DevOps MCP](azure-devops-mcp.md)
|
||||
|
||||
**Key Features**:
|
||||
- Official Microsoft MCP server for Azure DevOps integration
|
||||
- 50+ tools covering work items, repos, pipelines, wiki, and advanced security
|
||||
- Domain filtering to manage tool count and focus
|
||||
- Multiple authentication options (interactive, azcli, env)
|
||||
|
||||
---
|
||||
|
||||
### [Clockify MCP](clockify-mcp.md)
|
||||
|
||||
**Key Features**:
|
||||
- Comprehensive Clockify time tracking integration
|
||||
- 33 tools for workspace, client, project, task, tag, and time entry management
|
||||
- Timer start/stop functionality and bulk operations
|
||||
- Full CRUD operations for all Clockify entities
|
||||
|
||||
---
|
||||
|
||||
## Contributing Tools
|
||||
|
||||
**Created a tool for AI-assisted AL development?**
|
||||
|
||||
Share it with the community!
|
||||
|
||||
**Submission Guidelines**:
|
||||
- Must be useful for AL/BC development
|
||||
- Should enhance AI-assisted workflows
|
||||
- Open source preferred
|
||||
- Well documented
|
||||
|
||||
**How to Submit**: See [Contributing](../../../contributing) section
|
||||
|
||||
---
|
||||
|
||||
## Tool Safety & Privacy
|
||||
|
||||
### Privacy Considerations
|
||||
|
||||
**What Gets Shared**:
|
||||
- Code in your workspace (with AI assistants)
|
||||
- File names and structure
|
||||
- Your prompts and questions
|
||||
|
||||
**Best Practices**:
|
||||
- Review extension permissions
|
||||
- Understand data handling
|
||||
- Use organization-approved tools
|
||||
- Don't include sensitive data in code
|
||||
|
||||
### Security
|
||||
|
||||
**Verify Extensions**:
|
||||
- Check publisher reputation
|
||||
- Read reviews
|
||||
- Review permissions requested
|
||||
- Keep extensions updated
|
||||
|
||||
---
|
||||
|
||||
## Related Resources
|
||||
|
||||
- [Setup Guide](../../getting-started/setup) - Environment configuration
|
||||
- [Blog Posts](../articles) - Tool reviews and comparisons
|
||||
- [Videos](../videos) - Tool demonstrations
|
||||
- [GitHub Discussions](https://github.com/microsoft/alguidelines/discussions) - Tool recommendations and support
|
||||
|
|
@ -0,0 +1,45 @@
|
|||
---
|
||||
title: "AL Dependency MCP Server"
|
||||
linkTitle: "AL Dependency MCP"
|
||||
weight: 2
|
||||
description: >
|
||||
Expose AL workspace compiled symbols to AI assistants for intelligent code navigation and dependency analysis
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
The AL Dependency MCP Server exposes all compiled AL package symbols (.app files) to AI assistants, enabling them to understand dependencies, navigate code, and provide accurate suggestions based on Microsoft base app and other extension symbols.
|
||||
|
||||
**Created by**: [Stefan Maron](https://github.com/StefanMaron)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**Symbol Database**:
|
||||
- O(1) lookup performance via optimized indices
|
||||
- Streaming JSON parser for large symbol files (handles 50MB+ Microsoft base app)
|
||||
- Sub-100ms query responses
|
||||
- <500MB memory usage even with massive symbol databases
|
||||
|
||||
**6 Token-Optimized Tools**:
|
||||
- `al_search_objects` - Search for AL objects across all packages
|
||||
- `al_get_object_definition` - Get full object definition with all members
|
||||
- `al_get_object_summary` - Get token-optimized summary (96% smaller)
|
||||
- `al_get_object_members` - Get object members without full definition
|
||||
- `al_packages` - List all available AL packages
|
||||
- `al_get_stats` - Get database statistics and diagnostics
|
||||
|
||||
**Auto-Discovery**:
|
||||
- Automatically finds .alpackages directories in your workspace
|
||||
- Detects package changes in real-time
|
||||
- Supports multiple package sources
|
||||
|
||||
**Requirements**: Node.js 18+, .NET SDK 8.0+ (for development)
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/StefanMaron/AL-Dependency-MCP-Server
|
||||
- **npm Package**: https://www.npmjs.com/package/al-mcp-server
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
title: "AL Object ID Ninja MCP"
|
||||
linkTitle: "AL Object ID Ninja"
|
||||
weight: 5
|
||||
description: >
|
||||
AL object ID collision prevention and management for Business Central development teams
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
The AL Object ID Ninja MCP Server manages AL object IDs to prevent collisions in Business Central development. It provides two modes: LITE for individual developers and STANDARD for teams with shared ID pools and backend integration.
|
||||
|
||||
**Created by**: [SShadowS (Vjeko Kundačina)](https://github.com/SShadowS)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**Two Modes**:
|
||||
- **LITE Mode** (4 tools) - Individual developers: authorization, config, allocate_id, analyze_workspace
|
||||
- **STANDARD Mode** (8 tools) - Teams: adds pool management, consumption reports, backend sync, activity logs
|
||||
|
||||
**Collision Prevention**:
|
||||
- Automatic ID conflict detection
|
||||
- Smart ID allocation with preview/reserve/reclaim
|
||||
- Git integration for automatic app identification
|
||||
- Real-time workspace analysis
|
||||
|
||||
**Team Collaboration** (STANDARD):
|
||||
- Shared ID pools across team members
|
||||
- Backend integration with AL Object ID Ninja service
|
||||
- Consumption tracking and reporting
|
||||
- Audit trail with activity logs
|
||||
|
||||
**Configuration**:
|
||||
Set `MCP_MODE` environment variable to `lite` or `standard` (default: lite)
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/SShadowS/al-objid-mcp-server
|
||||
- **npm Package**: https://www.npmjs.com/package/@sshadows/objid-mcp
|
||||
- **Backend Service**: AL Object ID Ninja (vjekocom-alext-weu.azurewebsites.net)
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
---
|
||||
title: "Azure DevOps MCP"
|
||||
linkTitle: "Azure DevOps MCP"
|
||||
weight: 4
|
||||
description: >
|
||||
Official Microsoft MCP server for comprehensive Azure DevOps integration with AI assistants
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
The Azure DevOps MCP Server is Microsoft's official Model Context Protocol implementation for Azure DevOps, providing AI assistants with comprehensive access to work items, repositories, pipelines, wiki, search, and advanced security features.
|
||||
|
||||
**Publisher**: [Microsoft](https://github.com/microsoft)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**50+ Tools Across All Azure DevOps Services**:
|
||||
- Core (projects, teams, identities)
|
||||
- Work (iterations, capacity)
|
||||
- Work Items (CRUD, queries, comments, linking)
|
||||
- Repositories (repos, branches, PRs, commits, file contents)
|
||||
- Pipelines (builds, logs, artifacts, triggering)
|
||||
- Wiki (pages, content, CRUD operations)
|
||||
- Search (code, wiki, work items)
|
||||
- Advanced Security (alerts, findings)
|
||||
|
||||
**Domain Filtering**:
|
||||
- Enable only needed domains to reduce tool count
|
||||
- Example: `-d work-items -d repositories` for focused workflows
|
||||
|
||||
**Multiple Authentication Options**:
|
||||
- Interactive (default) - Browser-based OAuth
|
||||
- Azure CLI - Use existing `az login` session
|
||||
- Environment variable - PAT via `AZURE_DEVOPS_PAT`
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/microsoft/azure-devops-mcp
|
||||
- **npm Package**: https://www.npmjs.com/package/@azure-devops/mcp
|
||||
- **Getting Started**: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md
|
||||
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
---
|
||||
title: "BC Code Intelligence MCP"
|
||||
linkTitle: "BC Code Intelligence"
|
||||
weight: 1
|
||||
description: >
|
||||
Business Central knowledge base with 14 specialist AI personas for comprehensive development guidance
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
The BC Code Intelligence MCP Server provides atomic Business Central knowledge topics through an innovative specialist system. Instead of a single generic AI, you interact with 14 domain-expert personas who provide focused, expert guidance for specific BC development areas.
|
||||
|
||||
**Created by**: [Jeremy Vyska](https://github.com/JeremyVyska)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**14 BC Domain Specialists**:
|
||||
- Sam Coder (AL coding), Dean Debug (troubleshooting), Alex Architect (design)
|
||||
- Casey Cloud (cloud/SaaS), Morgan Modern (DevOps), Taylor Test (testing)
|
||||
- Quinn Quality (code quality), Riley Report (reporting), Parker Performance (optimization)
|
||||
- Jordan Journey (learning), Blake Business (business logic), Skyler Security (security)
|
||||
- Drew Data (data modeling), Finley Flow (workflow/UX)
|
||||
|
||||
**Smart Routing**:
|
||||
- Automatic routing to the right specialist based on your question
|
||||
- Multi-specialist collaboration for complex questions
|
||||
- Seamless context handoffs between specialists
|
||||
|
||||
**20+ MCP Tools**:
|
||||
- Knowledge discovery (search topics, get content)
|
||||
- Specialist management (routing, handoffs)
|
||||
- Code analysis (reviews, patterns, architecture)
|
||||
- Workflow orchestration
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/JeremyVyska/bc-code-intelligence-mcp
|
||||
- **Knowledge Base**: https://github.com/JeremyVyska/bc-code-intelligence
|
||||
- **npm Package**: https://www.npmjs.com/package/bc-code-intelligence-mcp
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
title: "Clockify MCP"
|
||||
linkTitle: "Clockify MCP"
|
||||
weight: 6
|
||||
description: >
|
||||
Comprehensive Clockify time tracking integration for project management and invoicing
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
The Clockify MCP Server provides comprehensive integration with Clockify time tracking and project management. It exposes 33 tools for managing workspaces, clients, projects, tasks, tags, time entries, and timers through AI assistants.
|
||||
|
||||
**Created by**: [Jeremy Vyska](https://github.com/JeremyVyska)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**33 Tools for Complete Clockify Management**:
|
||||
- Workspace Management - list, get, update workspaces
|
||||
- Client Management - full CRUD operations
|
||||
- Project Management - full CRUD operations
|
||||
- Task Management - full CRUD operations
|
||||
- Tag Management - full CRUD operations
|
||||
- Time Entry Management - CRUD plus bulk operations
|
||||
- Timer Operations - start, stop, get active timer
|
||||
|
||||
**Enhanced from Reference Implementation**:
|
||||
- Full CRUD operations (create, read, update, delete)
|
||||
- Bulk operations for time entries
|
||||
- Comprehensive filtering and pagination
|
||||
- Timer start/stop functionality
|
||||
|
||||
**Requirements**:
|
||||
- Node.js 20+
|
||||
- CLOCKIFY_API_KEY from Clockify profile settings
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/JeremyVyska/clockify-mcp
|
||||
- **Clockify API**: https://clockify.me/developers-api
|
||||
- **Get API Key**: https://app.clockify.me/user/settings (Profile Settings → API)
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
---
|
||||
title: "Serena MCP"
|
||||
linkTitle: "Serena MCP"
|
||||
weight: 3
|
||||
description: >
|
||||
Multi-language LSP-based coding assistant with AL Language Server support for Business Central
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
Serena is an AI-first code editor that provides MCP (Model Context Protocol) integration with Language Server Protocol (LSP) support for 20+ programming languages, including Business Central AL. It enables AI assistants to perform accurate code navigation, symbol lookup, and refactoring by leveraging native language servers.
|
||||
|
||||
**Created by**: [oraios](https://github.com/oraios)
|
||||
|
||||
---
|
||||
|
||||
## Key Features
|
||||
|
||||
**AL Language Server Support**:
|
||||
- Automatic setup using VS Code AL extension (`ms-dynamics-smb.al`)
|
||||
- Native AL LSP integration with custom AL commands
|
||||
- Platform detection for Windows/Linux/macOS
|
||||
- Proper AL Language Server initialization
|
||||
|
||||
**20+ Supported Languages**:
|
||||
- AL, Python, TypeScript/JavaScript, Rust, Go, C/C++, C#, Java, Ruby, PHP, Kotlin, Swift, and more
|
||||
- Each language uses native LSP implementation for maximum accuracy
|
||||
|
||||
**Symbolic Operations**:
|
||||
- Find References - Locate all usages across codebase
|
||||
- Go to Definition - Jump to symbol definitions
|
||||
- Document/Workspace Symbols - Search and list symbols
|
||||
- Type & Call Hierarchy - Navigate relationships and call traces
|
||||
|
||||
**Modes**:
|
||||
- Lite Mode - Minimal tool set for focused tasks
|
||||
- Standard Mode - Full tool suite with additional capabilities
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub**: https://github.com/oraios/serena
|
||||
- **PyPI Package**: https://pypi.org/project/serena-mcp/
|
||||
- **Changelog**: https://github.com/oraios/serena/blob/main/CHANGELOG.md
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue