> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/mcp.md).

# MCP

Подключите документацию iEXExchanger к Claude, Codex, Cursor, VS Code или другому MCP-клиенту.

MCP — Model Context Protocol — позволяет подключить документацию iEXExchanger к совместимому MCP-клиенту.

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

{% hint style="info" %}
MCP-сервер предоставляет доступ только к опубликованной документации iEXExchanger. Он не подключается к обменному пункту, административной панели или серверу и не может изменять настройки продукта.
{% endhint %}

## Что потребуется

Для подключения нужны:

* MCP-клиент с поддержкой удалённых серверов;
* транспорт **Streamable HTTP** или **HTTP**;
* исходящий HTTPS-доступ к `docs.iexexchanger.com`.

Для подключения к документации не требуются:

* учётная запись на сайте документации;
* отдельный токен документации;
* логин или пароль от iEXExchanger;
* доступ к административной панели;
* доступ к серверу обменного пункта;
* отдельный API-ключ.

Учётная запись или подходящий тариф могут потребоваться самому MCP-клиенту.

## Адрес MCP-сервера

Используйте следующий адрес:

```http
https://docs.iexexchanger.com/~gitbook/mcp
```

Параметры подключения:

```
Название: iEXExchanger Docs
Транспорт: Streamable HTTP
Авторизация: не требуется
```

Некоторые клиенты называют транспорт просто **HTTP**.

{% hint style="info" %}
Если открыть адрес MCP-сервера как обычную страницу в браузере, может появиться ошибка `405 Method Not Allowed`. Это ожидаемое поведение: адрес предназначен для MCP-запросов, а не для просмотра в браузере.
{% endhint %}

## Подключение

{% tabs %}
{% tab title="Claude" icon="claude" %}

### Claude

Для подключения документации в Claude:

1. Откройте **Customize** — **Connectors**.
2. Нажмите иконку **+**.
3. Выберите **Add custom connector**.
4. Укажите название `iEXExchanger Docs`.
5. Вставьте адрес `https://docs.iexexchanger.com/~gitbook/mcp`.
6. Нажмите **Add**.
7. Откройте новый диалог.
8. Нажмите **+** — **Connectors**.
9. Включите созданный Connector.

В организации Team или Enterprise возможность добавления пользовательских Connectors может зависеть от роли сотрудника и настроек организации.

Подробнее: [подключение удалённых MCP-серверов в Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

### Claude Code

Чтобы подключить документацию для всех проектов текущего пользователя, выполните:

```bash
claude mcp add --transport http iexexchanger-docs --scope user https://docs.iexexchanger.com/~gitbook/mcp
```

Проверьте список подключённых серверов:

```bash
claude mcp list
```

В запущенном Claude Code откройте состояние MCP:

```
/mcp
```

Сервер `iexexchanger-docs` должен отображаться со статусом `connected`.

Чтобы подключить документацию только к текущему проекту, перейдите в каталог проекта и выполните:

```bash
claude mcp add --transport http iexexchanger-docs --scope project https://docs.iexexchanger.com/~gitbook/mcp
```

Проектная конфигурация будет сохранена в файле:

```
.mcp.json
```

Пример ручной конфигурации:

```json
{
  "mcpServers": {
    "iexexchanger-docs": {
      "type": "http",
      "url": "https://docs.iexexchanger.com/~gitbook/mcp"
    }
  }
}
```

Поле `type` обязательно. Если указать `url` без `type`, Claude Code может определить подключение как локальный `stdio`-сервер и не запустить его.

{% hint style="warning" %}
Перед добавлением `.mcp.json` в репозиторий проверьте, что файл не содержит токены, пароли, приватные адреса или заголовки авторизации. Для документации iEXExchanger они не нужны.
{% endhint %}

Подробнее: [MCP в Claude Code](https://code.claude.com/docs/en/mcp).
{% endtab %}

{% tab title="Codex" icon="openai" %}
Добавьте MCP-сервер через Codex CLI:

```bash
codex mcp add iexexchanger-docs --url https://docs.iexexchanger.com/~gitbook/mcp
```

Проверьте список подключённых серверов:

```bash
codex mcp list
```

В интерфейсе Codex откройте состояние MCP:

```
/mcp
```

Сервер `iexexchanger-docs` должен отображаться в списке активных подключений.

Для ручной настройки откройте файл:

```
~/.codex/config.toml
```

Добавьте:

```toml
[mcp_servers.iexexchanger-docs]
url = "https://docs.iexexchanger.com/~gitbook/mcp"
```

После изменения конфигурации перезапустите Codex.

Чтобы подключить документацию только к одному проекту, создайте файл:

```
.codex/config.toml
```

Добавьте в него ту же конфигурацию:

```toml
[mcp_servers.iexexchanger-docs]
url = "https://docs.iexexchanger.com/~gitbook/mcp"
```

Проектная конфигурация используется только для доверенных проектов.

Подробнее: [настройка MCP в Codex](https://developers.openai.com/codex/mcp).
{% endtab %}

{% tab title="Cursor" icon="cursor" %}
Откройте **Settings** — **MCP** и добавьте новый MCP-сервер.

Для подключения документации к текущему проекту создайте файл:

```
.cursor/mcp.json
```

Добавьте:

```json
{
  "mcpServers": {
    "iexexchanger-docs": {
      "url": "https://docs.iexexchanger.com/~gitbook/mcp"
    }
  }
}
```

Для подключения во всех проектах используйте пользовательский файл:

```
~/.cursor/mcp.json
```

После сохранения:

1. Откройте **Settings** — **MCP**.
2. Найдите `iexexchanger-docs`.
3. Включите сервер.
4. Откройте Agent.
5. Проверьте, что инструменты документации доступны в списке.

{% hint style="warning" %}
Проектный файл `.cursor/mcp.json` может попасть в репозиторий. Не добавляйте в него пароли, токены или другие конфиденциальные данные.
{% endhint %}

Подробнее: [MCP в Cursor](https://cursor.com/docs/mcp).
{% endtab %}

{% tab title="VS Code" icon="vscode" %}
Откройте палитру команд и выполните:

```
MCP: Add Server
```

Выберите тип сервера **HTTP** и укажите адрес:

```
https://docs.iexexchanger.com/~gitbook/mcp
```

Сохраните подключение для текущего рабочего пространства или профиля пользователя.

Для ручной настройки текущего проекта создайте файл:

```
.vscode/mcp.json
```

Добавьте:

```json
{
  "servers": {
    "iexexchanger-docs": {
      "type": "http",
      "url": "https://docs.iexexchanger.com/~gitbook/mcp"
    }
  }
}
```

После сохранения:

1. Выполните команду **MCP: List Servers**.
2. Выберите `iexexchanger-docs`.
3. Запустите сервер.
4. Подтвердите доверие к подключению.
5. Откройте Chat.
6. Проверьте список доступных инструментов.

Чтобы открыть пользовательскую конфигурацию, выполните:

```
MCP: Open User Configuration
```

Серверы из пользовательской конфигурации доступны во всех рабочих пространствах текущего профиля.

Подробнее: [добавление MCP-серверов в VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers).
{% endtab %}

{% tab title="Другой клиент" %}
Используйте следующие параметры:

```
Название: iEXExchanger Docs
URL: https://docs.iexexchanger.com/~gitbook/mcp
Транспорт: Streamable HTTP
Авторизация: отсутствует
```

Некоторые клиенты называют транспорт просто **HTTP**.

Пример общей конфигурации:

```json
{
  "name": "iexexchanger-docs",
  "transport": "streamable-http",
  "url": "https://docs.iexexchanger.com/~gitbook/mcp"
}
```

Структура конфигурационного файла зависит от клиента. Названия полей `servers`, `mcpServers`, `type`, `transport` и `url` могут отличаться.

Не копируйте конфигурацию другого клиента без проверки поддерживаемого формата.

Не выбирайте `stdio`. Этот транспорт используется для локальных процессов, а документация iEXExchanger подключается как удалённый сервер через HTTPS.
{% endtab %}
{% endtabs %}

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

После добавления сервера отправьте следующий запрос:

{% prompt description="Проверка MCP документации" icon="plug" %}

```markdown
Используй MCP-сервер iexexchanger-docs.

1. Покажи доступные инструменты этого сервера.
2. Найди страницу «Валюты».
3. Полностью открой страницу:
https://docs.iexexchanger.com/learn/nastroika-obmena/currency-list-and-card
4. Назови точный путь к списку валют в панели управления.
5. Приложи ссылку на использованную страницу.

Не отвечай по памяти и не вызывай sendFeedback во время проверки.
```

{% endprompt %}

Подключение работает, если клиент открыл страницу документации и указал путь:

**«Основное» — «Валюты» — «Список валют»**

На сервере должны быть доступны следующие инструменты:

```
searchDocumentation
getPage
askQuestion
sendFeedback
```

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

## Правила постоянной работы

Добавьте следующий текст в инструкции проекта или используемого клиента:

{% prompt description="Правила работы с документацией iEXExchanger" icon="head-side-circuit" %}

```markdown
Используй MCP-сервер iexexchanger-docs как основной источник информации по iEXExchanger.

Перед ответом выполни поиск по точной задаче. Для подробной инструкции полностью прочитай относящиеся к вопросу страницы через getPage.

Отвечай на русском языке простым техническим языком. Сохраняй точные названия разделов, кнопок, полей, статусов, команд, файлов, переменных и параметров.

Не смешивай разные версии iEXExchanger, операционные системы, панели управления сервером и способы установки.

Если найденные страницы противоречат друг другу, не объединяй инструкции. Перечисли различия и попроси уточнить версию iEXExchanger или используемое окружение.

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

Перед потенциально опасными действиями на рабочем сервере предложи создать резервную копию и выполнить безопасную диагностику.

Для каждого изменения объясни, как проверить результат.

В конце ответа перечисли использованные страницы документации со ссылками.

Не вызывай sendFeedback без моего прямого запроса.
```

{% endprompt %}

Для Codex сохраните правила в файле:

```
AGENTS.md
```

Для Claude Code используйте:

```
CLAUDE.md
```

Для Cursor добавьте правила в настройки текущего проекта.

## Инструменты MCP

| Инструмент            | Назначение                                                                   |
| --------------------- | ---------------------------------------------------------------------------- |
| `searchDocumentation` | Ищет подходящие страницы и возвращает найденные фрагменты со ссылками        |
| `getPage`             | Открывает полное Markdown-содержимое выбранной страницы                      |
| `askQuestion`         | Подготавливает ответ по документации и прикладывает использованные источники |
| `sendFeedback`        | Отправляет команде iEXExchanger сообщение о проблеме в документации          |

Для подробной или потенциально опасной инструкции не ограничивайтесь ответом `askQuestion` или отдельным фрагментом поиска.

Сначала выполните `searchDocumentation`, затем откройте относящиеся к задаче страницы через `getPage`.

`sendFeedback` не редактирует и не публикует страницы. Инструмент отправляет сообщение команде iEXExchanger, поэтому вызывайте его только намеренно и не передавайте через него конфиденциальные данные.

## Возможности MCP

После подключения клиент сможет:

* искать инструкции по вопросу пользователя;
* открывать полное содержимое найденных страниц;
* сопоставлять сведения из связанных документов;
* находить точные названия разделов, настроек и параметров;
* подготавливать ответы на основе документации iEXExchanger;
* прикладывать ссылки на использованные страницы;
* сообщать о найденной проблеме через `sendFeedback`.

Доступ предоставляется к текущей опубликованной версии документации.

Неопубликованные черновики и изменения, которые ещё не появились на сайте документации, через MCP-сервер не передаются.

## Ограничения доступа

MCP документации не предоставляет доступ к:

* административной панели iEXExchanger;
* панели управления сервером;
* SSH и системным службам;
* базе данных;
* рабочему файлу `.env`;
* файлам Frontend и Backend;
* заявкам;
* данным клиентов;
* резервам;
* реквизитам;
* API-ключам и токенам;
* лицензии iEXExchanger;
* персональным и платёжным данным.

Через MCP документации нельзя:

* изменить настройки обменного пункта;
* создать или обработать заявку;
* изменить резерв;
* получить платёжные реквизиты;
* выполнить команду на сервере;
* установить обновление;
* изменить файлы проекта;
* получить закрытые данные.

{% hint style="warning" %}
Claude Code, Codex, Cursor, VS Code и другие клиенты могут отдельно иметь доступ к терминалу, файлам проекта или внешним сервисам.

Эти разрешения не относятся к `iexexchanger-docs`. Проверяйте доступ используемого клиента и отдельно подтверждайте потенциально опасные действия.
{% endhint %}

## Безопасность

Не отправляйте через подключённые клиенты:

* пароли;
* рабочий файл `.env`;
* seed-фразы;
* приватные ключи;
* SSH-ключи;
* API-токены;
* ключи мерчантов;
* пароли базы данных;
* данные SMTP;
* платёжные реквизиты;
* документы клиентов;
* персональные данные;
* реальные данные заявок;
* журналы с токенами;
* заголовки авторизации.

Перед отправкой проверяйте текст запроса, прикреплённые файлы, скриншоты и вывод терминала.

{% hint style="warning" %}
Не размещайте конфиденциальную информацию на опубликованных страницах документации.

Скрытие страницы из меню не является способом защиты данных, если страницу по-прежнему можно открыть по прямой ссылке.
{% endhint %}

## Если клиент не поддерживает MCP

Для работы с документацией можно использовать:

* Markdown-версию отдельной страницы;
* файл `llms.txt`;
* файл `llms-full.txt`.

Основной список страниц:

```
https://docs.iexexchanger.com/llms.txt
```

Полное содержимое документации:

```
https://docs.iexexchanger.com/llms-full.txt
```

`llms.txt` содержит структуру документации и ссылки на страницы.

`llms-full.txt` содержит объединённый текст опубликованных материалов и подходит для клиентов, которые умеют загружать текстовые файлы, но не поддерживают MCP.

## Решение проблем

<details>

<summary>MCP-сервер возвращает ошибку в браузере</summary>

**Симптом:** при открытии адреса MCP-сервера в браузере появляется `405 Method Not Allowed` или другая ошибка метода запроса.

**Причина:** MCP-сервер не предназначен для просмотра как обычная веб-страница.

**Как исправить:** добавьте адрес в совместимый MCP-клиент и выполните проверочный запрос из этой инструкции.

**Проверка результата:** клиент должен показать инструменты сервера и открыть найденную страницу документации.

</details>

<details>

<summary>Сервер не появляется в клиенте</summary>

**Симптом:** после добавления подключения сервер отсутствует в списке или отображается с ошибкой.

**Что проверить:**

* адрес указан без пробелов и дополнительных символов;
* выбран транспорт **Streamable HTTP** или **HTTP**;
* сервер сохранён;
* сервер включён;
* клиент перезапущен после изменения конфигурации;
* подключение не ожидает подтверждения доверия.

Точный адрес:

```
https://docs.iexexchanger.com/~gitbook/mcp
```

Для Claude Code выполните:

```bash
claude mcp list
```

Для Codex выполните:

```bash
codex mcp list
```

Для VS Code выполните:

```
MCP: List Servers
```

**Проверка результата:** сервер должен отображаться без ошибки подключения.

</details>

<details>

<summary>Claude Code сообщает об отсутствующем type</summary>

**Симптом:** Claude Code сообщает, что у MCP-сервера есть `url`, но отсутствует `type`.

**Причина:** в `.mcp.json` указан адрес сервера, но не указан тип транспорта.

**Как исправить:** добавьте поле:

```json
"type": "http"
```

Полная конфигурация:

```json
{
  "mcpServers": {
    "iexexchanger-docs": {
      "type": "http",
      "url": "https://docs.iexexchanger.com/~gitbook/mcp"
    }
  }
}
```

**Проверка результата:** выполните `claude mcp list`. Сервер должен отображаться со статусом `connected`.

</details>

<details>

<summary>Сервер подключён, но не используется</summary>

**Симптом:** клиент отвечает без обращения к документации.

**Причина:** клиент не выбрал инструменты `iexexchanger-docs` или использовал другой источник.

**Как исправить:** явно укажите в запросе:

```
Используй MCP-сервер iexexchanger-docs.
Сначала выполни searchDocumentation, затем открой найденные страницы через getPage.
```

Если подключено несколько MCP-серверов, временно отключите ненужные инструменты и начните новый диалог.

**Проверка результата:** ответ должен содержать сведения из найденной страницы и ссылку на источник.

</details>

<details>

<summary>Инструменты сервера не отображаются</summary>

**Симптом:** сервер подключён, но `searchDocumentation`, `getPage`, `askQuestion` и `sendFeedback` отсутствуют в списке.

**Причина:** клиент не завершил получение списка инструментов или использует сохранённое состояние предыдущего подключения.

**Как исправить:**

1. Отключите `iexexchanger-docs`.
2. Перезапустите MCP-клиент.
3. Включите сервер повторно.
4. Откройте новый диалог.
5. Проверьте список инструментов.

В VS Code можно выбрать сервер через **MCP: List Servers** и выполнить его перезапуск.

**Проверка результата:** в списке должны появиться инструменты документации.

</details>

<details>

<summary>Подключение блокируется сетью</summary>

**Симптом:** клиент не может установить соединение с MCP-сервером.

Проверьте доступ к основному домену документации:

```
https://docs.iexexchanger.com
```

Клиенту нужен исходящий HTTPS-доступ к `docs.iexexchanger.com`.

Соединение могут блокировать:

* VPN;
* Proxy;
* Firewall;
* корпоративная сеть;
* DNS-фильтрация;
* правила безопасности устройства.

После изменения сетевых настроек перезапустите клиент.

**Проверка результата:** сервер должен подключиться и вернуть список инструментов.

</details>

<details>

<summary>Найдены противоречащие друг другу страницы</summary>

**Симптом:** клиент нашёл несколько инструкций с разными командами, путями или параметрами.

**Как исправить:** попросите клиента:

1. Перечислить найденные страницы.
2. Полностью открыть каждую страницу через `getPage`.
3. Указать различающиеся сведения.
4. Не объединять противоречащие инструкции.

Дополнительно укажите используемую версию iEXExchanger, операционную систему и способ установки.

**Проверка результата:** ответ должен разделять инструкции по версиям или окружениям, а не объединять их в один порядок действий.

</details>

<details>

<summary>Страница не находится через поиск</summary>

**Симптом:** `searchDocumentation` не возвращает нужную статью.

**Что проверить:**

* страница опубликована;
* название введено без ошибки;
* запрос содержит точное название функции;
* используется MCP-сервер `iexexchanger-docs`.

Если известен полный адрес страницы, передайте его напрямую в `getPage`.

Пример:

```
Через getPage полностью открой страницу:
https://docs.iexexchanger.com/learn/nastroika-obmena/currency-list-and-card
```

**Проверка результата:** `getPage` должен вернуть полное Markdown-содержимое выбранной страницы.

</details>