@orbitlogistics/mcp-plain

MCP-сервер для платформы поддержки клиентов Plain. Предоставляет инструменты для управления темами (threads), статьями справочного центра и другими функциями через Model Context Protocol.

Настройка

С Claude Code

Добавьте в файл .claude/settings.json вашего проекта:

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

Затем задайте PLAIN_API_KEY в вашем окружении (например, в .zshrc, .envrc или в менеджере секретов).

С другими MCP-клиентами

Запустите сервер напрямую:

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

Инструменты

Примечание: Этот сервер не покрывает весь Plain API — только те конечные точки, которые мы активно используем. Если вам нужны дополнительные методы, PR приветствуются!

Темы

• list_threads — Список тем с фильтрами (статус, приоритет, метки, клиент, тенант)

• get_thread — Полная информация о теме по ID (включая таймлайн)

• get_thread_by_ref — Получить тему по номеру ссылки (например, T-510)

• get_thread_fields — Получить значения пользовательских полей для темы

• create_thread — Создать новую тему (автоматически создаёт клиента по email, если необходимо)

• reply_to_thread — Отправить ответ через исходный канал

• mark_thread_as_done — Отметить тему как решённую

• upsert_thread_field — Установить/обновить значения пользовательских полей

• add_internal_note — Добавить внутреннюю заметку (не видна клиенту)

• add_labels — Добавить категорийные метки к теме

• get_label_types — Список доступных типов меток

Связи тем

• link_threads — Связать тему с другой темой Plain, задачей Linear, задачей Jira или общим источником

• get_thread_links — Список связей на теме

• unlink_thread — Удалить связь по её ID

get_thread и get_thread_by_ref также возвращают первые 25 связей темы в массиве links.

Вложения

• get_attachment_download_url — Получить временный URL для скачивания

• get_attachment_content — Получить содержимое вложения (текст или base64)

Справочный центр

• list_help_centers — Список всех справочных центров

• get_help_center — Структура справочного центра (группы и статьи)

• list_help_center_articles — Список статей с полным содержимым

• get_help_center_article — Получить статью по ID

• get_help_center_article_by_slug — Получить статью по URL-слагу

• upsert_help_center_article — Создать или обновить статью (всегда сохраняется как ЧЕРНОВИК)

• create_help_center_article_group — Создать группу статей

• delete_help_center_article_group — Удалить пустую группу статей

Разработка

pnpm install
pnpm test
pnpm build

Лицензия

MIT