CLI tool to install and configure Back4App MCP server across different IDEs
npm install @back4app/mcp-installer
CLI tool to install and configure Back4App MCP server across different AI IDEs with a single command.
- 🚀 One-command installation - Install Back4App MCP server in any supported IDE
- 🔧 Multi-IDE support - Works with Cursor, Windsurf, Cline, Claude, VS Code, and more
- ✅ Smart configuration - Automatically manages MCP configuration files
- 📊 Status checking - Check installation status across all IDEs
- 🗑️ Easy removal - Uninstall with a single command
- 🌍 Global installation - All IDEs use global configuration
- Cursor (~/.cursor/mcp.json)
- Windsurf (~/.codeium/windsurf/mcp_config.json)
- Cline (~/.cline/mcp_config.json)
- Claude Desktop (~/.claude/mcp_config.json)
- VS Code (~/.vscode/mcp.json)
- Witsy (~/.witsy/mcp_config.json)
- Enconvo (~/.enconvo/mcp_config.json)
> Note: All IDEs use global configuration files in your home directory for consistent access across all projects.
``bashInstall globally via npm
npm install -g @back4app/mcp-installer
Installation Methods
$3
`bash
npm install -g @back4app/mcp-installer
mcp-installer install --account-key YOUR_ACCOUNT_KEY
`$3
`bash
npx @back4app/mcp-installer install --account-key YOUR_ACCOUNT_KEY
`$3
`bash
npx @back4app/mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY
This creates ~/.vscode/mcp.json in your home directory
`Commands
$3
`bash
mcp-installer install --account-key
`Examples:
`bash
Install for Cursor (global config)
mcp-installer install cursor --account-key sk-1234567890abcdefInstall for VS Code (global config)
mcp-installer install vscode --account-key sk-1234567890abcdef
`$3
`bash
Check specific IDE
mcp-installer status cursorCheck all IDEs
mcp-installer status
`$3
`bash
mcp-installer list
`$3
`bash
mcp-installer uninstall
`Configuration Details
All IDEs use global configuration for consistent access across projects:
- Global installation - Creates configuration files in your home directory (
~/.ide/)
- Cross-project - Configuration works across all your projects
- Persistent - Settings persist across IDE restarts and project switchesWorkflow for all IDEs:
`bash
Install MCP configuration globally
mcp-installer install vscode --account-key YOUR_ACCOUNT_KEYThe configuration is now in ~/.vscode/mcp.json
4. Restart VS Code to load the new MCP server
5. Access Back4App tools in VS Code's AI panel
`Getting Your Account Key
1. Sign up at Back4App
2. Go to your account settings
3. Generate or copy your MCP account key
4. Use it with the
--account-key parameterWhat Gets Installed
The installer adds this configuration to your IDE's MCP settings:
`json
{
"mcpServers": {
"back4app": {
"command": "npx",
"args": [
"-y",
"@back4app/mcp-server-back4app@latest",
"--account-key",
"YOUR_ACCOUNT_KEY"
]
}
}
}
`Troubleshooting
$3
- Restart VS Code after installation
- Check that ~/.vscode/mcp.json exists in your home directory
- Verify your account key is correct$3
- Ensure you have Node.js and npm installed
- Verify your Back4App account key is valid
- Try uninstalling and reinstalling if configuration seems corrupted
- Check that your IDE supports MCP (recent versions required)Development
`bash
Clone and setup
git clone
cd mcp-installer
npm installBuild
npm run buildTest locally
node dist/index.js --help
``Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details.
- Back4App MCP Server - The actual MCP server this tool installs
- Back4App - Backend-as-a-Service platform
- 📖 Documentation
- 🐛 Issues
- 💬 Community
---
Made with ❤️ by the Back4App team