MMCPMarkets
VB

vrtalex/bitrix24-skill

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

25 stars 품질 59 트렌드 15Unlicense
Repository Install

Bitrix24 AI Agent skill: webhook/OAuth, events, retries, safety guardrails, and ops patterns

개요

Compact, production-oriented skill pack for connecting AI agents to Bitrix24 REST. - Fast start for real API calls. - Safe-by-default execution with allowlist, risk confirmations, and audit log. - Modular capability packs instead of one oversized monolith. - Works with webhook and OAuth flows. - Universal online docs: https://apidocs.bitrix24.com - Main documentation repo: https://github.com/bitrix24/b24restdocs - Developer hub (SDKs, tools): https://github.com/bitrix24/bitrix24-dev-hub - MCP docs: https://github.com/bitrix24/b24restdocs/blob/main/sdk/mcp.md Short rule: - Runtime writes: webhook or OAuth. - Cross-portal product: OAuth. - Event trigger entrypoint: outgoing webhook + your queue. - Better agent method accuracy: MCP. Source: https://helpdesk.bitrix24.com/open/25866707/ Additional setup reference: https://helpdesk.bitrix24.com/open/21133100/ 1. Enable external AI connections in Bitrix24 (admin only): - Open account menu -> Settings -> MCP servers.

README

원문 README의 일부입니다. 원문 보기.

Bitrix24 Agent Skill Pack

Compact, production-oriented skill pack for connecting AI agents to Bitrix24 REST.

Why this pack

  • Fast start for real API calls.
  • Safe-by-default execution with allowlist, risk confirmations, and audit log.
  • Modular capability packs instead of one oversized monolith.
  • Works with webhook and OAuth flows.

Official docs source

Project layout

skills/bitrix24-agent/
  SKILL.md
  references/
    bitrix24.md
    packs.md
    catalog-*.md
    chains-*.md
  scripts/
    bitrix24_client.py
    offline_sync_worker.py
  agents/openai.yaml

Auth model: when to use what

Option Use when Not ideal when
Incoming webhook One portal, quick internal automation Multi-tenant app model, app-context-only methods
OAuth app Multi-portal scaling, app lifecycle, controlled token rotation Very small one-portal scripts where setup speed matters most
Outgoing webhook Need push trigger from portal events to your handler You need guaranteed retry/replay out of the box
MCP server Need better method/field discovery for agent generation quality You treat MCP as transactional runtime for business writes

Short rule:

  • Runtime writes: webhook or OAuth.
  • Cross-portal product: OAuth.
  • Event trigger entrypoint: outgoing webhook + your queue.
  • Better agent method accuracy: MCP.

Bitrix24 setup for external systems (quick admin manual)

Source: https://helpdesk.bitrix24.com/open/25866707/ Additional setup reference: https://helpdesk.bitrix24.com/open/21133100/

  1. Enable external AI connections in Bitrix24 (admin only):
  • Open account menu -> Settings -> MCP servers.
  • Turn on Allow connection of external AIs to Bitrix24.
  • Save.
  1. Connect an external assistant:
  • The MCP endpoint is region/deployment-specific — read it from your portal’s Settings -> MCP servers page rather than hardcoding a global host (the https://mcp.bitrix24.com/mcp/ form is the cloud default; .ru/.eu/other regions, data-residency and on-premise differ).
  • OAuth path (assistant supports OAuth): create connector/app in assistant UI, set the MCP URL from your portal, choose OAuth.
  • Token path (assistant has no OAuth): in Bitrix24 open Apps -> MCP connections -> Get connection token, copy token to assistant connector, use the MCP URL from your portal.

Use the official MCP for method/field discovery; use this skill’s governed CLI for safe transactional writes (allowlist, confirm gates, plan/execute, idempotency, audit).

  1. Validate access model:
  • Commands run on explicit user request.
  • Actions follow the connected user’s Bitrix24 permissions.
  1. Disable or revoke when needed:
GitHub에서 전체 README 보기

추천 도구

다른 키워드를 입력하거나 필터를 제거해 보세요.

설치

npx skillfish add vrtalex/bitrix24-skill
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →