> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Наборы инструментов Didit MCP и режим только для чтения

> Подключайте только нужные инструменты Didit MCP через наборы, работайте в режиме только для чтения и находите остальные инструменты через поиск.

Наборы инструментов позволяют подключению Didit MCP загружать короткий список инструментов вместо всего каталога, а режим только для чтения даёт подключение, которое никогда не может изменить данные.
Оба варианта задаются параметром в URL сервера:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true
```

Без параметра сервер показывает все инструменты, которые разрешены вашей роли, поэтому для уже существующего подключения ничего не меняется.

## Почему стоит загружать меньше инструментов

Перед первым вопросом ваш клиент отправляет модели описание каждого перечисленного инструмента.
Для всего каталога Didit это десятки тысяч токенов на каждый запрос: примерно от 50 000 до 115 000, в зависимости от токенизатора модели.
Некоторые клиенты также ограничивают количество инструментов, которые принимают.

| Что загружает подключение | Перечисленных инструментов | Доля этих токенов |
| - | - | - |
| Всё (без параметра) | Каждый инструмент, который может использовать ваша роль | Все |
| Короткий список, `core` | Около 30 | Около десятой части |
| Короткий список, только для чтения | Около 20 | Менее десятой части |

Цена такого подхода: один дополнительный шаг.
Инструмент, которого нет в списке, не теряется, но модель должна найти его с помощью [поиска инструментов](#как-получить-доступ-к-инструментам-которые-вы-не-загрузили), прежде чем сможет его запустить. Модель, которая видит все инструменты, выбирает нужный немного чаще, чем модель, которой приходится искать.
Загружайте всё, если диалог охватывает много областей и затраты контекста не имеют значения.
Загружайте `core` и наиболее используемые вами наборы инструментов, если затраты контекста имеют значение.

## Выбор наборов инструментов

Добавьте `toolsets` к URL сервера со списком через запятую:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases
```

Набор `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`: все инструменты, которые разрешены вашей роли. Это значение по умолчанию.

[Справочник инструментов](https://docs.didit.me/ru/integration/mcp/tools.md) перечисляет каждый инструмент с его типом и разрешением роли, которое ему нужно.

Как работает выбор:

* **Наборы инструментов подключаются по желанию.** URL без `toolsets` выводит все инструменты.
* **При указании имён наборов в списке отображаются инструменты только из этих наборов.** `?toolsets=cases` выводит инструменты для кейсов и `didit_context_get`, который есть в каждом подключении. Добавьте `core`, чтобы сохранить и короткий список.
* **Набор определяет, что выводится в списке, а не что вам разрешено запускать.** Инструмент вне вашего набора всё равно запускается, когда модель вызывает его по имени, с теми же разрешениями роли, что и обычно.
* **Неизвестное серверу имя игнорируется.** Подключение продолжает работать, а сервер сообщает модели, какое имя он проигнорировал и какие имена допустимы.
* **Роль по-прежнему действует.** Набор никогда не выдаёт разрешение: см. [роли и разрешения](https://docs.didit.me/ru/integration/mcp/authentication.md#роли-и-разрешения).

## Подключение в режиме только для чтения

Добавьте `read_only=true` к URL сервера:

```text theme={null}
https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&read_only=true
```

Подключение в режиме только для чтения предоставляет только инструменты для чтения, а сервер отклоняет каждый вызов, который создаёт, изменяет или удаляет что-либо.
Сервер отклоняет каждый вызов, поэтому это ограничение действует, даже если ваш клиент помнит инструмент из предыдущего подключения.
Такой режим подходит для формирования отчётов, для изучения учётной записи или для агента, которому вы не хотите позволять действовать самостоятельно.

Чтобы снова разрешить изменения, подключитесь без `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`, запрос вроде «пригласить нового участника команды в мою организацию» проходит так:

1. Модель вызывает `didit_tool_search` с `invite a teammate` и получает `didit_org_invite_member`, помеченный как инструмент для записи.
2. Она вызывает `didit_tool_call_write`, передавая `didit_org_invite_member` в качестве `name` вместе с собственными аргументами этого инструмента.
3. Ваш клиент просит вас подтвердить вызов, как и для любого инструмента, который изменяет данные.

Когда загружено всё, обнаруживать больше нечего, поэтому эти четыре инструмента не показываются в списке.

## Настройка в вашем клиенте

Выполните те же шаги, что и в [руководстве по установке](https://docs.didit.me/ru/integration/mcp/installation.md), только с параметрами, добавленными в URL.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> Оставьте кавычки: иначе оболочка сама обработает `?` и `&`.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"
> ```

> [tab] Cursor
>
> В файле `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> В файле `.vscode/mcp.json`:
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] Claude в браузере и Desktop
>
> Откройте **Settings**, затем **Connectors**, затем **Add custom connector**, и вставьте URL с параметрами:
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] Локальный сервер
>
> Локальный сервер принимает флаги или переменные окружения:
>
> ```bash theme={null}
> npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only
> ```
>
> ```bash theme={null}
> DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server
> ```

Если ваш клиент позволяет задавать заголовки, но не редактировать URL, передайте `X-MCP-Toolsets: core,workflows` и `X-MCP-Readonly: true`.
Значение в URL имеет приоритет над заголовком для наборов инструментов, а режим только для чтения включается, если его запрашивает хотя бы один из способов.

> [!NOTE]
>
> Плагин ChatGPT использует собственный фиксированный сокращённый каталог по адресу `https://mcp.didit.me/mcp/chatgpt`.
> Наборы инструментов и режим только для чтения на него не распространяются.
> См. [Подключение ChatGPT](https://docs.didit.me/ru/integration/mcp/chatgpt.md).

## Промпты, инструкции и поиск по документации

Сервер помогает модели начать с правильного места:

* **Инструкции.** При подключении сервер подсказывает модели начать с `didit_context_get`, объясняет, как определяются `organization_id` и `application_id`, какое приложение в песочнице использовать для разработки и какие наборы инструментов загружены для этого подключения.
* **Промпты.** Клиенты, которые поддерживают промпты MCP, показывают пять отправных точек: `integrate_didit`, `review_queue`, `explain_session`, `build_workflow` и `verification_report`. В Claude Code они доступны как слеш-команды.
* **Поиск по документации.** `didit_docs_search` выполняет поиск по этой документации и возвращает подходящие разделы со ссылками, поэтому ответы на вопросы о работе Didit берутся из актуальных страниц.

## Проверьте, что загрузилось при подключении

Спросите клиента:

```text theme={null}
Which Didit toolsets does this connection load, and is it read-only?
```

Модель отвечает на основе инструкций сервера.
Чтобы убедиться, что сервер поддерживает наборы инструментов, прежде чем на них полагаться, запросите его эндпоинт состояния:

```bash theme={null}
curl https://mcp.didit.me/healthz
```

В ответе `toolsets` и `read_only` перечислены в разделе `features`.

## Следующие шаги

> [card] [Установка](https://docs.didit.me/ru/integration/mcp/installation.md)
>
> Подключите Claude, ChatGPT, Cursor, VS Code, Codex или любой MCP-клиент.

> [card] [Справочник инструментов](https://docs.didit.me/ru/integration/mcp/tools.md)
>
> Описание каждого инструмента, его типа и необходимого ему разрешения роли.

> [card] [Аутентификация](https://docs.didit.me/ru/integration/mcp/authentication.md)
>
> Вход с помощью Didit, области доступа и разрешения ролей.

> [card] [Примеры промптов](https://docs.didit.me/ru/integration/mcp/examples.md)
>
> Промпты, которые работают с первого дня.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.