DaData MCP

DaData MCP подключает AI-помощника Битрикс24 к сервису DaData

После подключения вы сможете писать помощнику обычными словами: найти компанию по названию или ИНН, проверить реквизиты контрагента, узнать статус организации, найти банк по БИК/SWIFT/ИНН, проверить баланс DaData, посмотреть версии справочников или подготовить черновик реквизитов для карточки компании в Битрикс24.

Приложение особенно полезно для быстрых проверок CRM-данных: ИНН, КПП, ОГРН, ОКПО, ОКВЭД, адрес, статус компании, руководитель и банковские реквизиты. Помощник сам вызывает нужные инструменты DaData и возвращает результат в чат.

Для работы используется API-ключ и Секретный ключ DaData, который пользователь указывает в настройках приложения. API-ключ и Секретный ключ не передаются третьим лицам и используется только для запросов к DaData.

Важно! Некоторые возможности DaData зависят от тарифа, а также от предоставления Секретного ключа. Вы можете указать в поле ApiKey в настройках MCP-подключения Битрикс24 как API-ключ, так и связку API-ключ + Секретный ключ (через двоеточие), например:

• API-ключ
  
• API-ключ:Секретный ключ
  

Ключевые возможности:

1. Проверка подключения

Помощник может проверить, что API-ключ DaData настроен и доступен для запросов.

Пример:

• Проверь подключение к DaData
  

2. Данные компании или ИП

Можно найти компанию или ИП по названию или ИНН и получить основные реквизиты: ИНН, КПП, ОГРН, ОКПО, ОКВЭД, статус, адрес и руководителя.

Примеры:

• Найди компанию ООО "Ромашка"
  
• Проверь компанию по ИНН 7777088888
  

3. Поиск компаний

Помощник может подобрать компании по названию, части ИНН или другим реквизитам. Доступны фильтры по статусу, типу организации, филиальности и региону.

Пример:

• Найди действующие компании Ромашка
  
• Найди ИП по фамилии Иванов
  

4. Аффилированные компании

Можно проверить связанные компании по ИНН или названию компании. Если пользователь передал название, MCP сначала найдет компанию в DaData, возьмет ИНН и затем попробует проверить аффилированность.

Важно: данный функционал доступен не на всех тарифах DaData!

Пример:

• Проверь на аффилированность компанию ООО "Ромашка"
  

5. Банки

Помощник может найти банк по БИК, SWIFT, ИНН, КПП или регистрационному номеру. В ответе доступны название банка, БИК, SWIFT, корреспондентский счет, ИНН, КПП и статус.

Пример:

• Найди банк по БИК 044525225
  
• Найди банк по SWIFT SABRRUMM
  

6. Поиск банков

Можно подобрать банки по названию или части реквизитов.

Пример:

• Найди банк ТБанк
  

7. Реквизиты для Битрикс24

Помощник может подготовить черновик полей для карточки компании Битрикс24: название, ИНН, КПП, ОГРН, ОКПО, ОКВЭД, адрес и дополнительные сведения.

Важно: MCP не записывает данные в CRM сам. Он возвращает подготовленный черновик, который можно использовать в дальнейших сценариях или проверить перед сохранением.

Пример:

• Подготовь реквизиты для карточки Битрикс24 по ИНН 7777088888
  

8. Баланс и дневная статистика

Если в подключении указан API-ключ вместе с Секретный ключ, помощник может показать баланс аккаунта DaData и дневную статистику использования.

Пример:

• Покажи баланс DaData
  
• Покажи статистику DaData за сегодня
  

9. Версии справочников

Помощник может получить фактические версии и даты обновления справочников DaData: ЕГРЮЛ, банки, ФИАС/ГАР и другие ресурсы.

Примеры:

• Какие версии справочников DaData сейчас используются?
  
• Когда обновлялся справочник ЕГРЮЛ в DaData?
  

Что MCP-сервер не делает:

• Не записывает найденные данные напрямую в Битрикс24
  
• Не создает и не изменяет компании, контакты, сделки или реквизиты в Битрикс24
  
• Не гарантирует доступность проверки аффилированности на любом тарифе DaData
  
• Не обходит лимиты, тарифные ограничения и ограничения частоты запросов DaData
  
• Не управляет оплатой тарифа DaData