Обзор MCP

Shayan TaslimОбновлено

Сервер MCP UserJot позволяет инструментам ИИ напрямую подключаться к вашему рабочему пространству UserJot через удалённый HTTP — без установки локального пакета или процесса-посредника.

URL сервера

UserJot предоставляет одну удалённую конечную точку MCP:

text
https://api.userjot.com/v1/mcp

Аутентификация

Большинство современных MCP-клиентов поддерживают вход через OAuth. Вставьте URL сервера (или воспользуйтесь кнопкой установки в один клик либо командой в разделе Настройки → MCP & API; VS Code и Gemini CLI находятся в меню Ещё), войдите в UserJot, выберите рабочую область и нажмите Разрешить.

Клиент

Рекомендуемый способ авторизации

Инструкция по настройке

Claude (веб-версия, компьютер и мобильные устройства)

OAuth (установка в один клик в разделе Настройки → MCP & API)

Общая настройка

Claude Code

OAuth (или токен API)

Claude Code

Cursor

OAuth (установка в один клик в разделе Настройки → MCP & API) или токен API

Cursor

Codex

OAuth (или токен API)

Codex

ChatGPT

OAuth (или токен API в настольной версии)

ChatGPT

VS Code (Copilot)

OAuth (в разделе Ещё в Настройки → MCP & API)

Общая настройка

Gemini CLI

OAuth (в разделе Ещё в Настройки → MCP & API)

Общая настройка

Windsurf и инструменты для headless-режима/CI

Заголовок с токеном API

Windsurf / Общая настройка

Приложения, подключённые через OAuth, отображаются в разделе Подключённые приложения в Настройки → MCP & API; там указано, кто подключил каждое приложение. Нажмите и удерживайте Отозвать доступ, чтобы приложение потеряло доступ при следующем запросе.

Note

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

Для клиентов, которым требуется статический заголовок, или для автоматизированных скриптов создайте токен API в разделе Настройки → MCP & API и передавайте:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Возможности сервера MCP

Удалённый MCP-сервер предоставляет 98 инструментов для работы с данными и процессами вашей рабочей области (две REST-операции — загрузка файлов с помощью createAsset и удаление данных в соответствии с GDPR с помощью deleteMember — доступны только через REST):

  • Рабочее пространство и доски: Просмотр метаданных рабочего пространства, создание, просмотр списка, обновление и удаление досок.

  • Запросы, комментарии, голоса и теги: Просмотр списка, создание, обновление, перемещение, объединение и разделение запросов, поиск похожих запросов, управление подписками, публикация и закрепление комментариев, добавление и удаление голосов, управление тегами и прикрепление изображений.

  • Журнал изменений: Просмотр списка, создание, обновление и удаление записей, а также управление связанными запросами, авторами и тегами.

  • Беседы: Просматривать список бесед и их содержимое, начинать исходящие беседы (createConversation доступно на платных тарифах: 5 в день на Starter и 15 в день на Professional), просматривать историю, публиковать ответы и внутренние заметки, а также обновлять статус или исполнителя.

  • Участники и компании: Поиск, просмотр списка, синхронизация и обновление участников и компаний, а также управление членством в компаниях.

  • Справочный центр: Создание, обновление, удаление, публикация и снятие с публикации, а также поиск коллекций и статей.

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

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

Ограничения частоты запросов и доступность в тарифах

MCP доступен на всех тарифах, включая Free. Вызовы инструментов используют общие для рабочего пространства ограничения частоты запросов REST API: 10 запросов/мин (150/ч) на Free, 60 запросов/мин (1 500/ч) на Starter и 120 запросов/мин (5 000/ч) на Professional. При интенсивной работе агента лимит Free может быстро исчерпаться.

MCP и REST API

Используйте MCP для подключения ИИ-ассистента или инструмента для разработки, поддерживающего протокол Model Context Protocol. Используйте REST API, если создаёте собственную интеграцию с серверной частью, скрипт или код приложения.

Работа с токенами

Если вместо OAuth вы используете токен API, обращайтесь с ним как с любым другим секретом:

  • Не прописывайте его напрямую в файлах конфигурации, добавляемых в систему контроля версий.

  • Используйте переменные окружения или локальное хранилище секретов.

  • Используйте отдельные токены для разных сред или участников команды.

  • Отзовите неиспользуемые токены в разделе Настройки → MCP & API, нажав и удерживая Отозвать доступ.

Дальнейшие шаги

  • Следуйте инструкции Общая настройка, чтобы настроить OAuth, Claude в веб-версии или на компьютере, VS Code, Gemini CLI либо универсальную конфигурацию JSON.

  • Перейдите сразу к инструкциям для Claude Code, Cursor, Codex, ChatGPT или Windsurf.

Эта статья ответила на ваш вопрос?