Repository navigation
Configuration Agent Integration
Bricklayer generates configuration files for multiple AI coding agents, enabling MCP communication and providing Magento-specific development guidelines.
| Agent | MCP Config | Guidelines File | Status |
|---|---|---|---|
| Claude Code | .mcp.json |
CLAUDE.md |
Fully Supported |
| Cursor | .mcp.json |
.cursorrules |
Fully Supported |
| GitHub Copilot | .mcp.json |
.github/copilot-instructions.md |
Supported |
| JetBrains AI (PhpStorm) | .mcp.json |
.junie/guidelines.md |
Supported |
| Gemini CLI | .mcp.json |
AGENTS.md |
Supported |
The shared MCP configuration file tells agents how to start the Bricklayer MCP server:
{
"mcpServers": {
"magento-bricklayer": {
"command": "vendor/bin/bricklayer-mcp",
"args": []
}
}
}For containerized environments (DDEV, Warden), the command is adjusted automatically:
{
"mcpServers": {
"magento-bricklayer": {
"command": "ddev",
"args": ["exec", "vendor/bin/bricklayer-mcp"]
}
}
}Each agent's guidelines file contains:
- MCP server instructions with behavioral triggers (check runtime state before modifying code)
- "Before Modifying Magento Code" decision matrix (task → tool → development-context category)
-
development-contexttool category reference table - Token efficiency patterns for the agent
- Shell command reference (DDEV/Warden-aware)
# Generate all config files
vendor/bin/bricklayer install
# Regenerate after bundled content or project-local overrides change
vendor/bin/bricklayer updateupdate regenerates every agent file that already exists in the project and applies any overrides/additions from .bricklayer/ (see Project-Local Overrides).
McpConfigWriter generates agent files based on the agents array in .bricklayer.json:
{
"agents": ["claude-code", "cursor"]
}Only specified agents will have their guideline files generated.
Getting Started
Architecture
Tools Reference
- Overview (84 Tools)
- Introspection
- Catalog
- Orders
- Customers
- Database
- Logs & Diagnostics
- GraphQL
- Development
Configuration
Guidelines & Skills
Code Generation
Diagnostics
Security