agent-second-brain/docs/mcp-cli-setup.md

4.9 KiB
Raw Blame History

MCP через mcp-cli

Стабильное подключение к MCP серверам через mcp-cli вместо прямого протокола.

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

MCP протокол напрямую иногда отваливается. mcp-cli решает эту проблему:

  • Connection pooling - daemon держит соединения
  • Auto-retry - автоматические повторы при сетевых ошибках
  • Стабильность - работа через bash надёжнее чем MCP протокол напрямую

Как это работает

До:
Claude → MCP Protocol → Todoist MCP Server → Todoist API
         (отваливается)

После:
Claude → Bash → mcp-cli → Todoist MCP Server → Todoist API
                (daemon, retry, pooling)

Установка

1. Установите mcp-cli

curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash

Проверка:

~/.local/bin/mcp-cli --version
# mcp-cli v0.3.0

2. Создайте конфиг

mkdir -p ~/.config/mcp
cat > ~/.config/mcp/mcp_servers.json << 'EOF'
{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@doist/todoist-ai"],
      "env": {
        "TODOIST_API_KEY": "${TODOIST_API_KEY}"
      }
    }
  }
}
EOF

3. Добавьте токены в shell

# Добавить в ~/.bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export TODOIST_API_KEY="ваш_токен"' >> ~/.bashrc
source ~/.bashrc

4. Уберите прямое MCP подключение из Claude

# Удалить прямое MCP подключение
claude mcp remove todoist

Проверить что удалено:

claude mcp list
# todoist НЕ должен быть в списке

Теперь Claude работает через mcp-cli (bash), а не через MCP протокол напрямую.


Проверка

# Список инструментов (24 шт)
mcp-cli info todoist

# Тест - задачи на сегодня
mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'

# Обзор всех проектов
mcp-cli call todoist get-overview '{}'

Todoist Tools (24)

Задачи

Tool Описание
add-tasks Создать задачи
update-tasks Обновить задачи
complete-tasks Завершить задачи
find-tasks Поиск по тексту/проекту/label
find-tasks-by-date Задачи по дате
find-completed-tasks Завершённые задачи

Проекты и секции

Tool Описание
add-projects Создать проекты
update-projects Обновить проекты
find-projects Поиск проектов
add-sections Создать секции
update-sections Обновить секции
find-sections Секции проекта

Комментарии и коллаборация

Tool Описание
add-comments Добавить комментарии
update-comments Обновить комментарии
find-comments Найти комментарии
find-project-collaborators Участники проекта
manage-assignments Bulk назначение

Общее

Tool Описание
get-overview Обзор (markdown)
find-activity Лог активности
delete-object Удалить объект
fetch-object Получить объект
user-info Инфо о пользователе
search Универсальный поиск
fetch Получить по ID

Примеры команд

Задачи на сегодня

mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'

Создать задачу

mcp-cli call todoist add-tasks '{"tasks": [{"content": "Тест задача", "dueString": "tomorrow", "priority": 2}]}'

Завершить задачу

mcp-cli call todoist complete-tasks '{"ids": ["task_id_here"]}'

Поиск задач

mcp-cli call todoist find-tasks '{"searchText": "проект"}'

Обзор проекта

mcp-cli call todoist get-overview '{"projectId": "project_id"}'

Найти проекты

mcp-cli call todoist find-projects '{"search": "Work"}'

Отладка

MCP_DEBUG=1 mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'

Требования

  • Node.js 18+ (для npx)
  • Todoist API Token (Settings → Integrations → Developer)