Release v2.0.0 - Complete rewrite with official SDK
🎉 Major Release: v2.0.0
This is a complete rewrite of the Bitrix24 MCP Server with focus on:
- Production-ready features
- Official SDK integration
- Comprehensive documentation
- Safety mechanisms
- Built on @bitrix24/b24jssdk v0.4.10
- Full TypeScript support
- Type-safe API calls
- Protect production data from accidental modifications
- Configurable per environment (prod/stage/dev)
- Blocks: add, create, update, delete operations
- Allows: list, get, search, fields, count operations
- Direct access to Bitrix24's MCP documentation server
- Get exact parameter specifications
- Always up-to-date API information
- Call ANY of 500+ Bitrix24 REST API methods
- Auto-pagination for large datasets
- Batch operations (up to 50 methods in one request)
- **QUICK_SETUP_PHPSTORM.md** - 3-step quick setup
- **CONFIGURATION_EXAMPLES.md** - Ready-to-use JSON configs
- **PHPSTORM_SETUP.md** - Detailed setup with troubleshooting
- **PHPSTORM_USAGE.md** - Usage examples and patterns
- **CHEATSHEET.md** - Quick reference guide
- **DOCS_INDEX.md** - Complete documentation index
- Automatic request recognition
- Multi-language support (Russian/English)
- Smart environment detection (prod/stage/dev)
- Pre-configured rules for PhpStorm AI
```json
{
"mcpServers": {
"bitrix24-prod": {
"command": "node",
"args": ["/path/to/build/index.js"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-domain.bitrix24.com/rest/1/key/",
"READ_ONLY": "true"
}
}
}
}
```
```json
{
"mcpServers": {
"bitrix24-dev": {
"command": "node",
"args": ["/path/to/build/index.js"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://dev.bitrix24.com/rest/1/key/",
"LOG_LEVEL": "debug"
}
}
}
}
```
1. **bitrix24_call_method** - Universal API method caller
2. **bitrix24_call_batch** - Execute multiple methods at once
3. **bitrix24_call_list_method** - Auto-pagination for large datasets
4. **bitrix24_search_docs** - Search built-in documentation
5. **bitrix24_get_official_docs** - Get official Bitrix24 docs
- **Code reduction**: -86% (from ~20K to ~3K lines)
- **Dependencies**: Only 4 packages
- **Build time**: ~1 second
- **TypeScript**: Full type safety
- **Architecture**: Clean, maintainable, extensible
This is a complete rewrite. Migration from v1.0:
- New configuration format
- New tool names
- New documentation structure
- See MIGRATION_V2.md for details
**Provident Estate Dubai** - Premium Real Estate in Dubai
https://providentestate.com
Built with:
- @bitrix24/b24jssdk - Official Bitrix24 SDK
- @modelcontextprotocol/sdk - MCP Protocol implementation
- TypeScript - Type-safe development
- Claude AI - Development assistance
```bash
npm install
npm run build
```
See [QUICK_SETUP_PHPSTORM.md](QUICK_SETUP_PHPSTORM.md) for setup instructions.
- Documentation: https://gitlab.com/bitrix24team/bitrix24-mcp-server/-/blob/main/DOCS_INDEX.md
- Issues: https://gitlab.com/bitrix24team/bitrix24-mcp-server/-/issues
- Bitrix24 REST API: https://dev.1c-bitrix.ru/rest_help/
---
**Full Changelog**: https://gitlab.com/bitrix24team/bitrix24-mcp-server/-/blob/main/CHANGELOG.md