Подключение к MCP-инструментам

Это руководство объясняет, как подключить популярные MCP-клиенты (например, Cursor и Claude Desktop) к вашим инструментам, опубликованным через MCP Trigger в Nodul.

Перед началом

Вам понадобится:

• Сценарий с настроенным MCP Trigger (см. MCP-узлы)

Шаг 2 — Подключитесь через ваш MCP-клиент

Ниже приведены быстрые шаги настройки для популярных клиентов. Названия элементов интерфейса могут отличаться в разных версиях, но идея всегда одна: добавить новый MCP-сервер/коннектор и вставить ваш Server URL.

Cursor

1. Откройте Cursor
2. Перейдите в Settings
3. Найдите MCP (или MCP Servers / Tools)
4. Нажмите Add server
5. Вставьте Server URL, скопированный из Nodul
6. Если запрашивается авторизация, укажите ваш API-ключ
7. Сохраните, затем откройте список инструментов и убедитесь, что ваши инструменты Nodul видны

Claude Desktop

1. Откройте Claude Desktop
2. Откройте Settings
3. Перейдите в Connectors
4. Нажмите Add custom connector
5. Вставьте Server URL из Nodul
6. Если запрашивается авторизация, укажите ваш API-ключ
7. Сохраните, затем проверьте, что коннектор включён

ChatGPT (MCP-совместимый клиент)

Если вы используете настройку ChatGPT с поддержкой MCP-серверов (напрямую или через коннектор/мост), шаги те же:

1. Откройте настройки Connectors / Tools / MCP вашего клиента
2. Добавьте новый MCP-сервер
3. Вставьте Server URL из Nodul
4. Укажите API-ключ, если ваш MCP Trigger требует его
5. Проверьте, что инструменты отображаются и вызываются

OpenAI (Chat) / OpenAI API (MCP-совместимый клиент)

Если ваша настройка OpenAI поддерживает MCP (напрямую или через совместимый MCP-клиент):

1. Добавьте новый MCP-сервер в вашем MCP-клиенте / middleware
2. Вставьте Server URL
3. Настройте аутентификацию при необходимости
4. Проверьте работу обнаружения инструментов, затем вызовите инструмент в тестовом промпте

Vapi (MCP-совместимый клиент)

Если вы используете Vapi через интеграцию с поддержкой MCP:

1. Добавьте ваш MCP-сервер Nodul в настройках интеграции Vapi MCP
2. Вставьте Server URL
3. Укажите API-ключ при необходимости
4. Протестируйте, вызвав инструмент из простого сценария голосового агента

Устранение неполадок

Инструменты не отображаются

• Убедитесь, что Tool Name установлен на узлах, подключённых к MCP Trigger (иначе инструменты не будут обнаружены).
• Подтвердите, что вы скопировали правильный Server URL из MCP Trigger.
• Если ваш сценарий требует авторизации, убедитесь, что клиент действительно отправляет необходимые учётные данные.

Соединение обрывается или истекает таймаут

• MCP использует потоковое соединение (SSE). Обеспечьте стабильное сетевое соединение.
• Делайте выполнение инструментов быстрым и возвращайте только необходимое (используйте MCP Response).

Ошибки аутентификации (401/403)

• Убедитесь, что Authentication включена/выключена, как ожидается, в MCP Trigger.
• Если включена, перегенерируйте/скопируйте заново ваш API-ключ и обновите его в клиенте.