quickfile-mcp

MCP-сервер для Quickfile REST API v2. Мультиаккаунтный, с изоляцией секретов.

Возможности

• 45 инструментов -- по одному на каждый operationId API, сгенерированы из встроенного spec.json.

• Мультиаккаунтность -- можно настроить несколько аккаунтов Quickfile; каждый инструмент принимает параметр account.

• Оба режима аутентификации -- статические персональные Bearer-токены и OAuth 2.0 (автообновление + сохранение ротированного refresh-токена).

• Изоляция секретов -- токены хранятся в accounts.json (файл в .gitignore), никогда не раскрываются ИИ-агенту. Схемы инструментов открывают только селектор account и параметры эндпоинтов.

Related MCP server: iikoServer MCP Server

Установка

1. npm install

2. cp accounts.example.json accounts.json и заполните учётные данные аккаунта.

3. npm run build

4. Настройте ваш MCP-клиент (Claude Desktop и т. д.):

{
  "mcpServers": {
    "quickfile": {
      "command": "node",
      "args": ["path/to/quickfile-mcp/dist/index.js"],
      "cwd": "path/to/quickfile-mcp"
    }
  }
}

Сервер читает accounts.json из рабочего каталога (или переменной окружения QF_ACCOUNTS_FILE для другого пути). Данные OAuth-токенов (accessToken, refreshToken, expiresAt) хранятся в отдельном внутреннем tokens.json (или QF_TOKENS_FILE), которым управляет сервер — вам никогда не нужно редактировать его вручную.

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

Статический токен (собственный аккаунт)

Сгенерируйте персональный Bearer-токен в QuickFile: Настройки аккаунта -> Сторонняя интеграция -> API. В accounts.json укажите "type": "static" и "token": "<your token>".

OAuth (партнёрское приложение)

1. Зарегистрируйте приложение в QuickFile, чтобы получить clientId / clientSecret. Укажите их в accounts.json с "type": "oauth".

2. Выполните процесс авторизации OAuth и обмена токенов вне основного канала (с помощью небольшого CLI или ручной вставки), чтобы получить первые accessToken, refreshToken и expiresAt.

3. Инициализируйте tokens.json один раз:

   { "beta": { "accessToken": "...", "refreshToken": "...", "expiresAt": 0 } }

   После этого вам никогда не придётся трогать tokens.json — сервер автоматически обновляет истекающие access-токены и сохраняет ротированный refresh-токен обратно в него.

Выбор аккаунта

Каждый инструмент принимает необязательный параметр account (перечисление настроенных меток). Если параметр опущен, используется defaultAccount из accounts.json.

Справочник API

Полные схемы эндпоинтов: src/spec.json (Swagger 2.0, 45 путей). Источник: документация Quickfile API.