> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/bitrix24-mcp.md).

# Bitrix24 MCP

Add your Bitrix24 inbound webhook so your agent can create leads and deals and update contacts.

Bitrix24 MCP gives your AI agent Bitrix24 tools for leads, deals and contacts. For example, it can create a lead, look up a contact before it replies and update a deal stage. You add the MCP server URL and a connection token once in Third party apps.

***

### Prerequisites

* A BotPenguin account with access to the More menu.
* A Bitrix24 portal. \[CHECK: confirm the Bitrix24 role needed.
* Your portal's MCP URL and connection token from Bitrix24.

***

### Key Definitions

| Term           | Meaning                                                                                 |
| -------------- | --------------------------------------------------------------------------------------- |
| MCP            | Model Context Protocol. A standard way for an AI agent to use the tools of another app. |
| MCP server URL | The address of the MCP server.                                                          |
| Tool           | An action that the app publishes. The app decides which tools exist.                    |
| Connection     | One saved account that your agents can use.                                             |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/fPSfJBu0Y8Po76iLu4ly/images/bitrix24-mcp-step-1.png)

2. Type Bitrix24 MCP in the search box, then open the **Bitrix24 MCP** card.

![Search for Bitrix24 MCP and open its card](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Gy6XENZc9h1SQzrj3myN/images/bitrix24-mcp-step-2.png)

3. On the Connected accounts tab, click **Add connection**.

![Click Add connection on the Bitrix24 MCP page](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/TtQV0EK6fNt7hemjzk5U/images/bitrix24-mcp-step-3.png)

4. In the configuration panel, type a **Connection name**.
5. Enter the **MCP server URL**. This field is required. Copy it from your Bitrix24 portal.
6. Enter the **Connection token**. This field is required. Copy it from your Bitrix24 portal.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fm8zvsz7eN83UcxgihW2B%2Fimage.png?alt=media&amp;token=378a03f3-23c0-4b53-bfb3-374fdb8e8a82" alt=""><figcaption></figcaption></figure>

7. Click **Save Configuration**. BotPenguin tests the connection and saves it only if the server answers.&#x20;
8. Check the Connected accounts tab. Your Bitrix24 MCP configuration appears in the list with an Active status.

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>Save Configuration is grey</summary>

Fill in every required field. The URL must start with https\://.

</details>

<details>

<summary>BotPenguin says authentication is required</summary>

The token or header is missing or wrong. Copy the key again from Bitrix24 and save again.

</details>

<details>

<summary>BotPenguin says the server could not be found</summary>

The URL is wrong or the server is down. Check the URL in Bitrix24 and save again.

</details>

<details>

<summary>My agent says the credentials were rejected</summary>

The key was regenerated or deleted in Bitrix24. Add the connection again with the new key.

</details>

<details>

<summary>The tools in my agent changed</summary>

Bitrix24 publishes the tools, not BotPenguin. Sync the tools again in your agent and select the ones you need.

</details>

<details>

<summary>Can I connect more than one Bitrix24 MCP account?</summary>

Yes. Click Add connection again. Give each one a clear name so you can pick the right one when you build an agent.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
