mcp-b24

🇷🇺 Russisch · 🇬🇧 Englisch

Ein vollständiger MCP-Server auf Basis der Bitrix24-REST-API – übertrifft das schlanke mcp-bitrix24 (nur Tasks) und das offizielle Bitrix24-MCP (nur die Dokumentationsreferenz). Er führt tatsächlich REST-Aufrufe an das Portal aus: CRM, Aufgaben, Chats, Dateien, Kalender, Personal, Smart-Prozesse, E-Mail, Telefonie, Geschäftsprozesse, Ereignisse.

• 30 Tools (28 domänenspezifische + bx24_batch + bx24_call), ~290 Aktionen.

• Autorisierung: eingehender Webhook oder OAuth 2.0 mit automatischer Token-Aktualisierung (client_endpoint).

• Transport: stdio (Claude Desktop, Cursor, Codex) und Streamable HTTP.

• Sicherheit: zweistufige Bestätigung destruktiver Aktionen, JSONL-Audit, Token-Bucket-Rate-Limit, Backoff bei QUERY_LIMIT_EXCEEDED/OPERATION_TIME_LIMIT.

• Lokalisierung RU/EN (BX24_DEFAULT_LANG). 73 Tests, TypeScript ESM, MIT.

Badges: npm v0.2.0 · MIT · Node.js ≥ 18 · MCP 1.x · Bitrix24 REST 1.0 + 3.0.

Dokumentation

Related MCP server: fast-bitrix24-mcp

Schnellstart

npm install -g mcp-b24
# или без установки:
npx -y mcp-b24

Autorisierung (zur Auswahl)

Webhook (einfacher):

export BX24_WEBHOOK_URL="https://ВАШ_ПОРТАЛ.bitrix24.ru/rest/1/КОД_ВЕБХУКА/"

OAuth-Anwendung (portalweit, automatische Aktualisierung):

export BX24_MODE=oauth
export BX24_DOMAIN=ВАШ_ПОРТАЛ.bitrix24.ru
export BX24_CLIENT_ID="..."
export BX24_CLIENT_SECRET="..."
export BX24_REFRESH_TOKEN="..."

Alle Variablen stehen in .env.example.

Konfiguration der MCP-Clients

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_WEBHOOK_URL": "https://ВАШ_ПОРТАЛ.bitrix24.ru/rest/1/КОД_ВЕБХУКА/",
        "BX24_CONFIRM_DESTRUCTIVE": "true"
      }
    }
  }
}

Windows (cmd): "command": "cmd", "args": ["/c", "npx", "-y", "mcp-b24"]..

Cursor (.cursor/mcp.json) – derselbe Block mcpServers. VS Code (.vscode/mcp.json) – Schlüssel servers statt mcpServers. Codex CLI: codex mcp add bitrix24 --env BX24_WEBHOOK_URL=... -- npx -y mcp-b24. Cline / Roo Code – Block mcpServers wie bei Claude Desktop.

Streamable HTTP:

BX24_TRANSPORT=http BX24_HTTP_PORT=3000 BX24_WEBHOOK_URL="..." npx mcp-b24
# http://127.0.0.1:3000/mcp

Docker:

docker build -t mcp-b24 .
docker run --rm -e BX24_WEBHOOK_URL="..." mcp-b24          # stdio
docker compose up                                                   # HTTP (см. docker-compose.yml)

Tools (28 domänenspezifische + 2 generische)

CRM: bx24_crm_leeds, bx24_crm_deals, bx24_crm_contacts, bx24_crm_companies, bx24_crm_invoices, bx24_crm_products, bx24_crm_activities, bx24_crm_requisites, bx24_crm_duplicates, bx24_smart_processes. collab: bx24_tasks, bx24_projects, bx24_disk, bx24_im, bx24_im_chat, bx24_conf, bx24_calendar. org: bx24_users, bx24_departments, bx24_time, bx24_hr. biz: bx24_lists, bx24_mail, bx24_reports, bx24_marketing, bx24_workflows, bx24_telephony, bx24_events. generic: bx24_batch (≤50 Aufrufe), bx24_call (beliebige REST-Methode per Name).

Jedes domänenspezifische Tool ist action-based: Die auszuführende Operation wird über den Parameter action ausgewählt. Das vollständige Verzeichnis der Aktionen findest du in docs/TOOLS_REFERENCE.md.

Examples

• „Erstelle für Iwan einen Lead, Telefon +7…“ → bx24_crm_leads action=add

• „Zeig mir meine heutigen Aufgaben“ → bx24_tasks action=list

• bx24_disk + bx24_im_chat

• „Starte den Genehmigungsprozess für Deal #456“ → bx24_workflows action=start

• „Lösche die GmbH "Alte Firma"“ → bx24_crm_companies action=delete (erfordert eine Bestätigung)

Entwicklung

npm install
npm run build        # tsc → dist/
npm test             # 73 теста
npm run test:coverage
npm start            # node dist/index.js

Ausführlich: docs/DEVELOPER_GUIDE.md.

Lizenz

MIT © Penzin Konstantin (github.com/kostikpenzin