@back4app/mcp-installer


CLI tool to install and configure Back4App MCP server across different AI IDEs with a single command.

Features

- 🚀 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

Supported IDEs

- 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.

Quick Start

``bash


Install globally via npm

npm install -g @back4app/mcp-installer

Install for specific IDE

mcp-installer install cursor --account-key YOUR_ACCOUNT_KEY
mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY # Creates ~/.vscode/mcp.json
`

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-1234567890abcdef

Install for VS Code (global config)

mcp-installer install vscode --account-key sk-1234567890abcdef
`

$3

`bash

Check specific IDE

mcp-installer status cursor

Check 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 switches

Workflow for all IDEs:
`bash


Install MCP configuration globally

mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY

The 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 parameter

What 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 install

Build

npm run build

Test locally

node dist/index.js --help
``

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Related Projects

- Back4App MCP Server - The actual MCP server this tool installs
- Back4App - Backend-as-a-Service platform

Support

- 📖 Documentation
- 🐛 Issues
- 💬 Community

---

Made with ❤️ by the Back4App team