Глоссарий MCP: клиенты, серверы, инструменты, ресурсы, промпты и транспорты

Клиент

Определение: приложение ИИ-ассистента, которое подключается к серверам MCP для доступа к инструментам и данным.

Примеры: Claude Desktop, Cursor, Windsurf, Continue

В контексте Workify: ваш ИИ-ассистент (например, Claude Desktop), который использует Workify MCP для управления задачами и проектами.

Подключить любой клиент →

Сервер

Определение: сервис, предоставляющий инструменты, ресурсы и данные клиентам MCP через протокол MCP.

Примеры: сервер Workify MCP, сервер файловой системы, сервер поиска по коду

В контексте Workify: сервер Workify MCP по адресу https://mcp.workify.ru, предоставляющий инструменты управления задачами и проектами.

Сервер MCP для управления проектами →

Инструмент

Определение: функция, которую предоставляет сервер MCP и которую клиенты могут вызывать для выполнения действий или получения данных.

Примеры: list_tasks, create_task, start_time_tracking

В контексте Workify: инструменты вроде list_tasks для получения ваших задач или create_task для добавления новых задач в Workify.

Инструменты Workify MCP →

Ресурс

Определение: данные или контент только для чтения, которые серверы MCP предоставляют клиентам (реже, чем инструменты).

Примеры: документация, шаблоны, справочные данные

В контексте Workify: хотя Workify MCP в основном использует инструменты, ресурсами могли бы быть шаблоны проектов или документация.

Промпт

Определение: инструкции на естественном языке, которые вы даёте ИИ-ассистенту и на основе которых он решает, какие инструменты MCP вызвать.

Примеры: «Покажи мои задачи со сроком на этой неделе» или «Создай задачу на ревью дизайна API»

В контексте Workify: вы говорите Claude «Покажи мои задачи Workify», и Claude вызывает инструмент list_tasks, чтобы получить ваши задачи.

Набор из 50 промптов →

Транспорт

Определение: способ связи между клиентами и серверами MCP.

Типы:

• STDIO: стандартный ввод/вывод (для локальных серверов)
• HTTP/SSE: HTTP с Server-Sent Events (для удалённых серверов)

В контексте Workify: Workify MCP использует транспорт HTTP/SSE, поскольку это удалённый сервер. Continue использует SSE, а Cursor использует HTTP.

Удалённый или локальный →

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

Определение: когда клиент запрашивает у сервера выполнение инструмента с конкретными параметрами.

Пример: клиент вызывает list_tasks с фильтром due_date: "this_week"

В контексте Workify: когда вы просите Claude показать задачи, Claude делает вызов инструмента list_tasks в Workify.

Обнаружение инструментов

Определение: процесс, при котором клиент запрашивает у сервера список доступных инструментов.

Пример: клиент вызывает tools/list, чтобы узнать, какие инструменты предоставляет сервер

В контексте Workify: при первом подключении ваш клиент обнаруживает инструменты Workify (list_tasks, create_task и т.д.).

Протокол MCP

Определение: стандартизированный протокол связи, определяющий, как клиенты и серверы взаимодействуют.

Компоненты: обнаружение инструментов, вызовы инструментов, обработка ошибок, аутентификация

В контексте Workify: Workify MCP следует стандарту протокола MCP, обеспечивая совместимость со всеми клиентами MCP.

Архитектура MCP →

API-ключ

Определение: токен аутентификации, используемый для авторизации доступа клиента MCP к серверу Workify MCP.

Формат: включается в заголовок Authorization как Bearer YOUR_API_KEY

В контексте Workify: вы создаёте API-ключ в разделе Настройки Workify → Интеграции, затем добавляете его в конфигурацию клиента MCP.

Управление API-ключами →

Рабочее пространство

Определение: ваше рабочее пространство Workify, содержащее проекты, задачи и участников команды.

В контексте Workify: инструменты MCP работают в пределах вашего рабочего пространства, поэтому вы можете управлять задачами и проектами через ИИ-ассистентов.

Удалённый сервер MCP

Определение: сервер MCP, размещённый удалённо (как Workify), а не запущенный локально на вашей машине.

Преимущества: без локальной настройки, всегда доступен, поддержка нескольких пользователей

В контексте Workify: Workify MCP — это удалённый сервер по адресу https://mcp.workify.ru, доступный откуда угодно.

Удалённый или локальный →

Транспорт STDIO

Определение: транспорт через стандартный ввод/вывод для локальных серверов MCP, запускаемых как процессы на вашей машине.

Сценарий: локальные серверы файловой системы, инструменты анализа кода

Примечание: Workify MCP использует HTTP/SSE (удалённо), а не STDIO

SSE (Server-Sent Events)

Определение: способ транспорта, при котором сервер передаёт ответы клиенту в реальном времени.

Сценарий: Continue использует SSE для удалённых серверов MCP, таких как Workify

В контексте Workify: при использовании Continue Workify MCP передаёт ответы через SSE для эффективной связи.

Настройка Continue →

Параметры инструмента

Определение: входные аргументы, передаваемые инструменту при вызове.

Пример: вызов list_tasks с project_id: "123" и status: "open"

В контексте Workify: когда вы просите «задачи со сроком на этой неделе», Claude передаёт инструменту due_date: "this_week".

Ответ инструмента

Определение: данные, возвращаемые инструментом после выполнения, которые клиент использует для ответа на ваш промпт.

Пример: list_tasks возвращает массив объектов задач

В контексте Workify: когда вы запрашиваете задачи, Workify возвращает данные задач (название, статус, срок и т.д.), которые Claude оформляет для вас.