MCP-сервер

Model Context Protocol в Timelix — как агенты взаимодействуют с системой

MCP (Model Context Protocol) — открытый стандарт от Anthropic для взаимодействия AI-моделей с внешними инструментами и данными. В Timelix MCP-сервер — это мост, через который агенты выполняют реальные действия: читают задачи и документы, создают планы, обновляют метрики и отправляют уведомления.

Зачем это нужно

Без MCP агент — это только текстовая модель. С MCP он получает доступ к живым данным и действиям в системе:

Без MCP	С MCP
Отвечает на вопросы	Читает актуальные задачи
Генерирует текст	Создаёт задачи и блоки
Ничего не знает о системе	Обновляет метрики, читает docs и отправляет уведомления

Endpoint

GET/POST/DELETE /api/agent/mcp

Поддерживает два формата авторизации:

# Рекомендуемый: токен
/api/agent/mcp?token=YOUR_MCP_TOKEN

# Legacy: прямые параметры
/api/agent/mcp?userId=xxx&agentId=yyy&todoListId=zzz

Сервер использует Streamable HTTP транспорт и возвращает ответы в формате NDJSON (Newline-Delimited JSON). Это позволяет Claude Desktop, Cursor и другим MCP-клиентам получать данные потоком.

Как работает запрос

MCP-клиент (Claude Desktop / Cursor / N8N)
         ↓ POST /api/agent/mcp?token=xxx
Timelix MCP Server
    1. Проверяет токен → получает userId, agentId, todoListId
    2. Загружает список инструментов для этого агента
    3. Регистрирует инструменты в MCP-сессии
    4. Выполняет запрошенный инструмент
         ↓ NDJSON streaming
MCP-клиент получает результат

Подключение к Claude Desktop

Добавьте в конфигурацию Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "timelix": {
      "url": "https://app.timelix.ru/api/agent/mcp?token=YOUR_TOKEN",
      "transport": "http"
    }
  }
}

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

В настройках Cursor → MCP → Add Server:

Name: Timelix
URL: https://app.timelix.ru/api/agent/mcp?token=YOUR_TOKEN
Transport: HTTP

Динамическая загрузка инструментов

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

// Пример: агент с ограниченным набором built-in инструментов
const agentTools = [
  'readTodos',
  'createTodo',
  'updateTodo',
  'getDoc',
  'appendDoc',
  'sendTelegramMessage',
];

По умолчанию новый агент получает базовый mcpPreset. Дополнительные built-in MCP-инструменты, такие как readEpics и getEpicDetails, можно включить отдельно в конфигурации роли.

Зачем это нужно

Endpoint

Как работает запрос

Подключение к Claude Desktop

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

Динамическая загрузка инструментов

Дальше

MCP-сервер Timelix

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

Инструменты

Задачи и MCP

On this page