# PartnerCore
**MCP Server for Business Central AL Development**
[](https://www.npmjs.com/package/partnercore)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
---
## Overview
PartnerCore brings professional AL development capabilities to AI assistants through the Model Context Protocol (MCP). Connect your AI coding assistant to real BC development tools.
**57+ tools** including:
- AL Language Server with full LSP support
- BC Container management
- Git operations
- File system operations
- Project memory
- Cloud AI services
---
## Installation
```bash
npm install -g partnercore
```
---
## Configuration
### Cursor
Add to `~/.cursor/mcp.json` (Windows: `%USERPROFILE%\.cursor\mcp.json`):
```json
{
"mcpServers": {
"partnercore": {
"command": "partnercore",
"env": {
"API_KEY": "your-api-key"
}
}
}
}
```
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"partnercore": {
"command": "partnercore",
"env": {
"API_KEY": "your-api-key"
}
}
}
}
```
### VS Code + GitHub Copilot
Add to `.vscode/settings.json`:
```json
{
"github.copilot.chat.mcpServers": {
"partnercore": {
"command": "partnercore",
"env": {
"API_KEY": "your-api-key"
}
}
}
}
```
> **Note:** `API_KEY` is required for the MCP server to function.
---
## Getting Started
After configuration, reload MCP servers and ask your AI:
> **"Call al_get_started"**
This returns available tools, workspace status, and recommended workflows.
---
## Features
### AL Language Server
Real compiler integration with diagnostics, code completion, symbol navigation, refactoring, and formatting.
### BC Container Tools
Create, compile, publish, and test AL apps in Business Central Docker containers.
### Git Operations
Full version control: status, diff, commit, push, branches, and stash management.
### File Operations
Read, write, search, and manipulate files with pattern matching and regex support.
### Project Memory
Persist project context across development sessions.
### Cloud AI
Code review, knowledge base search, and code templates.
---
## CLI Commands
```bash
# Start MCP server (runs by default)
partnercore
# Or explicitly
partnercore start
# Check configuration
partnercore check
# Download AL extension
partnercore download-extension
# Show version
partnercore --version
```
---
## Environment Variables
| Variable | Description |
|----------|-------------|
| `API_KEY` | **Required** - API key for MCP server |
| `LOG_LEVEL` | Logging level (debug, info, warn, error) |
---
## Requirements
- Node.js 18.0.0+
- Windows, macOS, or Linux
- Docker (for container tools)
- Git (for version control tools)
---
## Support
- **Website:** [ciellos.com](https://www.ciellos.com)
- **Issues:** [GitHub](https://github.com/ciellosinc/PartnerCore-CLI/issues)
---
## License
MIT © [Ciellos](https://www.ciellos.com)