docs: rewrite the MCP Server page for v0.1.0 - #182
Merged
Conversation
The page still described the alphas: an `analyze` tool that no longer exists, apply_fix "not writing to disk", six bundled analyzers, and a five-step DevTools resolution with an auto-download that was removed. v0.1.0 makes ALCops MCP a thin code-fix server that also proxies Microsoft's almcp and requires BC Development Tools 18.0+. Rewrite as a concise install → connect → use guide: prerequisites led by the dotnet tool, ready-to-paste configs for Claude Code, VS Code/Copilot, Cursor and Codex, the four native tools plus the proxied al_* set, project-driven analyzer configuration, and a recommended agent loop with the onlyErrors gotcha. Point to the README for the full reference. Fix the one-line descriptions on the home page, getting-started index and quick-start that repeated the old "analyze a file" story. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The MCP Server page still described the pre-release alphas: an
analyzetool that no longer exists,apply_fix"not writing to disk", six bundled analyzers, and a five-step DevTools resolution list including an auto-download that was removed. ALCops MCP v0.1.0 turned the server into a thin code-fix server that also proxies Microsoft'salmcp, and it requires BC Development Tools 18.0+.This rewrites
content/docs/getting-started/ai-tooling.mdas a concise install → connect → use guide and fixes the three one-liners elsewhere on the site that repeated the old "analyze a file" story.What the page now covers
dotnet tool install -g Microsoft.Dynamics.BusinessCentral.Development.Tools, with the AL Language VS Code extension as the auto-detected alternative; v17 and earlier not supported.dotnet tool install -g ALCops.Mcp.serverskey, notmcpServers), Cursor and OpenAI Codex; shapes verified against each vendor's current docs.list_rules,get_fixes,apply_fix,apply_fix_all) and a paragraph on the proxiedal_*tools, linking to the README for the full list;--no-proxyfor clients that already registeralmcp.al.codeAnalyzers/al.ruleSetPath/al.packageCachePathcome from the project and are bridged toalmcp; links to the VS Code page for the analyzer list and the Configuration page for rulesets.AGENTS.md/CLAUDE.mdloop (compile →get_fixes→apply_fix) plus a warning thatal_compiledefaults toonlyErrors: true.Removed: the
analyzetool table, the "always includes ALCops' six built-in analyzers" paragraph, the stale resolution list, and the "Other AI Integrations — Under Investigation" alert.Cross-reference fixes
content/_index.md— home page "AI assistants" feature cardcontent/docs/getting-started/_index.md— AI Tooling bulletcontent/docs/getting-started/quick-start.md— "Ready to Set Up?" bulletcontent/docs/_index.md("connect it to AI assistants through the MCP server") is still accurate and untouched.Verification
hugo --gc --minify --panicOnWarning --printPathWarnings(Hugo 0.165.0 extended, as CI) — cleanmarkdownlint-cli2@0.23.2 "content/**/*.md"— 0 issues../vscode/#manual-setup-without-the-extension,../configuration/#ruleset-files-rulesetjson) resolvehugo server: four tab headers, warning alert, tools table and every code block presentclaude mcp add --scope project alcops -- alcops-mcpin a scratch folder writes the.mcp.jsonshown on the pageanalyzetool on the touched pages🤖 Generated with Claude Code