bxmcp: connect Claude to your 1C-Bitrix website
bxmcp connects Claude to a website built on 1C-Bitrix: Site Management, the CMS that runs many business websites and online stores across Russian-speaking markets: Kazakhstan, Uzbekistan, Kyrgyzstan, Armenia, Georgia, Azerbaijan, Moldova, the Baltic states and beyond. You ask in plain language, and Claude does the routine admin work: prices, stock, products, SEO fields, page texts, orders and form submissions. Every change is previewed first, runs only after you confirm it, and most changes can be undone for 30 days.
The connector address is https://mcp.bxmcp.ru/mcp. Sign-in uses OAuth with your bxmcp account. Tool output and messages are in Russian. Claude answers in the language you write in.
What you need
- A website on 1C-Bitrix: Site Management (PHP 8.1 or newer). Prices and stock need the Commercial Catalog module, orders need the Online Store module.
- A bxmcp account. Sign up at https://mcp.bxmcp.ru/cabinet/signup with an e-mail and a password; no card is needed. You get 14 days of full access from the moment you connect a site. After that there is a free tier (up to 10 changes a month) or a paid plan (from 990 RUB a month per site).
- Claude on a plan that allows connectors. Claude is available only in the countries and regions Anthropic supports.
Set up
- Install the module on your website. In the bxmcp dashboard, click “Download module”. In the Bitrix admin panel, open Content → Site structure → Files and folders, go to
/local/modules/, upload the archive and choose “Unpack”. Then open Settings → Product settings → Modules, find “bxmcp” and click “Install”. - Choose what the assistant may touch. In the module settings, on the “Data access” tab, tick the sections (information blocks) the assistant may read and change. Everything is closed by default. Orders and form submissions have their own switches.
- Connect the site. On the “Connection” tab, click “Connect to the AI assistant” and confirm in the dashboard. No keys need to be copied.
- Add the connector in Claude. Open Settings → Connectors and find bxmcp in the directory, or go straight to claude.ai/directory/connectors/bxmcp. Click Connect and sign in with the e-mail and password of your bxmcp dashboard. If the directory is not available on your plan, click “Add custom connector” and enter
https://mcp.bxmcp.ru/mcp, leaving the OAuth fields empty. - Or add it in ChatGPT. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode, then create an app with the address
https://mcp.bxmcp.ru/mcpand OAuth sign-in, leaving the client ID and secret empty. Sign in with the e-mail and password of your bxmcp dashboard. - Check it. In a new chat, turn the connector on and ask: “Check the connection to my site.” The assistant calls
bitrix_pingand reports that the site is connected and which module version it runs.
Example prompts
- “Raise prices in the ‘Garden tools’ section by 7% and round them up to the nearest 10.” Claude shows a table of old and new prices and applies them after your “yes”.
- “Which active products have no image, no price or no description?”
- “Show today's new orders and mark order 1042 as shipped.”
- “Replace the old phone number +998 71 000-00-00 with +998 71 111-22-33 everywhere on the site.”
- “Write a meta description for the product ‘Pruning shears X200’ and set it.”
- “Hide all products that are out of stock in the ‘Jackets’ section.”
- “Show the latest submissions of the feedback form.”
- “Undo the last change.”
How changes work
- Preview first. Every tool that adds, changes or deletes something works in two calls. The first call changes nothing and returns a preview (what is there now and what it will become) and a one-time confirmation token. The change runs only on the second call, after you say yes. One confirmation covers one change.
- Undo. Most changes return a change id and can be undone for 30 days: “undo the last change”, or the button in the dashboard history. Undo is refused if the same data was changed again later. Deleting products and uploading files cannot be undone.
- Bulk operations (prices of a whole section, a price list from a table, a property of many products, statuses of many orders) always run as a dry run first and list the items they would skip.
- Structure tools marked BETA (creating information blocks and properties, editing properties) cannot be undone and need a third step: a phrase you type yourself.
- Limits. The assistant sees only the sections you allowed in the module. A site can be connected read-only. Team members get their own sign-in and a role (editor or viewer). The site's PHP code, templates and system files are never changed.
Tools
Read-only: bitrix_ping, bitrix_list_sites, bitrix_get_iblocks, bitrix_get_iblock_schema, bitrix_list_elements, bitrix_get_element, bitrix_list_sections, bitrix_get_section, bitrix_list_offers, bitrix_get_stock, bitrix_get_seo, bitrix_get_page_content, bitrix_list_orders, bitrix_get_order, bitrix_list_forms, bitrix_list_form_results, bitrix_get_form_result, bitrix_list_changes, bitrix_catalog_health, bitrix_find_duplicates, bitrix_export_table.
Add new data: bitrix_create_element, bitrix_create_section, bitrix_upload_file, bitrix_create_iblock, bitrix_create_iblock_property, bitrix_add_property_values.
Change or delete data: bitrix_update_element, bitrix_delete_element, bitrix_set_element_active, bitrix_update_section, bitrix_delete_section, bitrix_update_price, bitrix_bulk_update_prices, bitrix_update_offer, bitrix_set_stock, bitrix_update_seo, bitrix_replace_page_text, bitrix_update_page_content, bitrix_find_and_replace_text, bitrix_change_order_status, bitrix_bulk_change_order_status, bitrix_set_form_result_status, bitrix_bulk_update_properties, bitrix_apply_price_table, bitrix_update_iblock_property, bitrix_undo_change.
Order tools change only the status of an order. They never take payments, issue refunds or move money.
Troubleshooting and support
- “Couldn't reach the MCP server” or sign-in fails. Remove the connector, add it again and sign in with the dashboard e-mail and password. If you were invited to a team, use your own e-mail and password, not the owner's.
- “Site not found” or “no access”. Check in the dashboard that the site is connected and active, and in the module settings that the section is ticked.
- A price or stock value is not written. With warehouse accounting turned on, Bitrix calculates stock from warehouses; the assistant reports this instead of writing.
- The module asks for an update. Download the latest module from the dashboard and install it over the old one.
- Still stuck? Write to support@bxmcp.ru with the site address and the time of the request.
Try it without signing up
A public demo connector at https://mcp.bxmcp.ru/demo/mcp works without sign-in. It is a shared demo store with the safe, undoable tools only; changes are reset to the original data within about an hour.
Data and privacy
bxmcp does not receive your conversations with Claude, only the tool calls and their parameters. Data from your site that Claude asked for passes through the gateway and is not stored, except a log of actions and, for 30 days, the previous values needed to undo a change. Details: Privacy Policy.