Почему стоит загружать меньше инструментов
Перед первым вопросом ваш клиент отправляет модели описание каждого перечисленного инструмента. Для всего каталога Didit это десятки тысяч токенов на каждый запрос: примерно от 50 000 до 115 000, в зависимости от токенизатора модели. Некоторые клиенты также ограничивают количество инструментов, которые принимают.
Цена такого подхода: один дополнительный шаг.
Инструмент, которого нет в списке, не теряется, но модель должна найти его с помощью поиска инструментов, прежде чем сможет его запустить. Модель, которая видит все инструменты, выбирает нужный немного чаще, чем модель, которой приходится искать.
Загружайте всё, если диалог охватывает много областей и затраты контекста не имеют значения.
Загружайте
core и наиболее используемые вами наборы инструментов, если затраты контекста имеют значение.
Выбор наборов инструментов
Добавьтеtoolsets к URL сервера со списком через запятую:
core задаёт короткий список, с которого начинается большинство задач.
Он включает организации и приложения, сессии верификации (создание, поиск, решение, объяснение, симуляцию в песочнице и чтение доставок webhook), поиск сценариев, аналитику и баланс, API-ключ вашего приложения и webhook, поиск кейсов, пользователей, компаний и транзакций, а также поиск по документации.
core: короткий список, описанный выше.account: организации, приложения, API-ключи, участники и роли.billing: тариф, кредитный баланс, способы оплаты, чеки и данные для биллинга.sessions: сессии верификации (создание, поиск, принятие решений, проверка, предоставление доступа, импорт, PDF и доставки webhook).workflows: сценарии верификации и анкеты (создание, редактирование, проверка и публикация).lists: пользовательские списки, список блокировки и список разрешённых.vendors: люди и компании, которых вы верифицируете (пользователи и компании вендоров).transactions: мониторинг транзакций (транзакции, скрининг кошельков и правила с бэктестингом).cases: управление кейсами (создание, назначение, эскалация и закрытие кейсов).investigator: Investigator (его очередь проверок, отчёты, решения, вопросы о политике и производительность).webhooks: адреса назначения webhook и оповещения.reports: аналитика, экспорт и журнал аудита.branding: брендинг White label для сценария верификации.verification: отдельные API верификации (документ, удостоверяющий личность, лицо, AML, подтверждение адреса, телефон, электронная почта, проверка по базам данных и проверки бизнеса).travel_rule: Travel Rule (настройки, каталог VASP, сети, адреса, переводы и сообщения).marketplace: маркетплейс провайдеров (каталог, ваши подключения и запросы на интеграцию).networks: сети, связанные с мошенничеством (связанные сессии, пользователи и компании, которые используют одно устройство, документ или контакт).compliance: ассистент по комплаенсу (ваш регуляторный профиль, его требования и сценарии, созданные на их основе).docs: поиск по документации Didit.all: все инструменты, которые разрешены вашей роли. Это значение по умолчанию.
- Наборы инструментов подключаются по желанию. URL без
toolsetsвыводит все инструменты. - При указании имён наборов в списке отображаются инструменты только из этих наборов.
?toolsets=casesвыводит инструменты для кейсов иdidit_context_get, который есть в каждом подключении. Добавьтеcore, чтобы сохранить и короткий список. - Набор определяет, что выводится в списке, а не что вам разрешено запускать. Инструмент вне вашего набора всё равно запускается, когда модель вызывает его по имени, с теми же разрешениями роли, что и обычно.
- Неизвестное серверу имя игнорируется. Подключение продолжает работать, а сервер сообщает модели, какое имя он проигнорировал и какие имена допустимы.
- Роль по-прежнему действует. Набор никогда не выдаёт разрешение: см. роли и разрешения.
Подключение в режиме только для чтения
Добавьтеread_only=true к URL сервера:
read_only.
Как получить доступ к инструментам, которые вы не загрузили
Когда подключение загружает только часть каталога, сервер добавляет четыре инструмента, чтобы ни один инструмент не остался недоступным:didit_tool_search(чтение): находит инструменты по тому, что вы хотите сделать («экспортировать сессии в CSV»), или выводит список одного набора инструментов. Для каждого совпадения указано, что делает инструмент, каковы его параметры и читает ли он данные, записывает их или выполняет деструктивное действие.didit_tool_describe(чтение): возвращает полное описание и схему входных данных для до пяти инструментов.didit_tool_call_read(чтение): запускает инструмент только для чтения, которого нет в списке. Он отказывает в запуске инструмента, который изменяет данные.didit_tool_call_write(деструктивный): запускает инструмент, который создаёт, изменяет или удаляет данные и которого нет в списке. На подключении только для чтения не предлагается.
didit_tool_call_read или didit_tool_call_write проверяется так же, как прямой вызов: действуют права вашей роли, режим только для чтения и все требования confirm: true.
Эти два инструмента разделены, чтобы ваш клиент мог запросить подтверждение перед изменением и пропускать запросы на чтение.
Если загружен core, запрос вроде «пригласить нового участника команды в мою организацию» проходит так:
- Модель вызывает
didit_tool_searchсinvite a teammateи получаетdidit_org_invite_member, помеченный как инструмент для записи. - Она вызывает
didit_tool_call_write, передаваяdidit_org_invite_memberв качествеnameвместе с собственными аргументами этого инструмента. - Ваш клиент просит вас подтвердить вызов, как и для любого инструмента, который изменяет данные.
Настройка в вашем клиенте
Выполните те же шаги, что и в руководстве по установке, только с параметрами, добавленными в URL.- Claude Code
- Codex
- Cursor
- VS Code
- Claude в браузере и Desktop
- Локальный сервер
? и &.X-MCP-Toolsets: core,workflows и X-MCP-Readonly: true.
Значение в URL имеет приоритет над заголовком для наборов инструментов, а режим только для чтения включается, если его запрашивает хотя бы один из способов.
Плагин ChatGPT использует собственный фиксированный сокращённый каталог по адресу
https://mcp.didit.me/mcp/chatgpt.
Наборы инструментов и режим только для чтения на него не распространяются.
См. Подключение ChatGPT.Промпты, инструкции и поиск по документации
Сервер помогает модели начать с правильного места:- Инструкции. При подключении сервер подсказывает модели начать с
didit_context_get, объясняет, как определяютсяorganization_idиapplication_id, какое приложение в песочнице использовать для разработки и какие наборы инструментов загружены для этого подключения. - Промпты. Клиенты, которые поддерживают промпты MCP, показывают пять отправных точек:
integrate_didit,review_queue,explain_session,build_workflowиverification_report. В Claude Code они доступны как слеш-команды. - Поиск по документации.
didit_docs_searchвыполняет поиск по этой документации и возвращает подходящие разделы со ссылками, поэтому ответы на вопросы о работе Didit берутся из актуальных страниц.
Проверьте, что загрузилось при подключении
Спросите клиента:toolsets и read_only перечислены в разделе features.
Следующие шаги
Установка
Подключите Claude, ChatGPT, Cursor, VS Code, Codex или любой MCP-клиент.
Справочник инструментов
Описание каждого инструмента, его типа и необходимого ему разрешения роли.
Аутентификация
Вход с помощью Didit, области доступа и разрешения ролей.
Примеры промптов
Промпты, которые работают с первого дня.