planfix-mcp

📦 WWmcp — Emerging Markets MCP の一部 — 非西洋圏の API 向け MCP サーバー 46 個（ブラジル／MENA／湾岸諸国／東南アジア／アフリカ／CIS）。

Planfix 用 MCP サーバー — AI を通じたタスク、プロジェクト、CRM の連絡先管理

Planfix をニューラルネットワークに接続し、インターフェイスを開かずにタスクを作成したり、プロジェクトを確認したりする方法をお探しなら、これが役立ちます。ツール 20 個とスキル 2 個を備え、タスク、プロジェクト、連絡先、コメント、従業員、ファイルを扱えます。「イワノフさんに金曜日までのタスクを設定して」と入力すると、Planfix にタスクが作成されます。

@theYahia によるシリーズ WWmcp（サーバー 46 個）の一部です。

インストール

Claude Desktop

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

Claude Code

claude mcp add planfix \
  -e PLANFIX_API_KEY=your-api-key \
  -e PLANFIX_ACCOUNT=your-subdomain \
  -- npx -y @theyahia/planfix-mcp

Streamable HTTP（リモートサーバー）

PLANFIX_API_KEY=your-key PLANFIX_ACCOUNT=your-sub npx @theyahia/planfix-mcp --http 8080

エンドポイント：http://localhost:8080/mcp ヘルスチェック：http://localhost:8080/health

Smithery

npx -y @smithery/cli install @theyahia/planfix-mcp --client claude

VS Code / Cursor

{
  "servers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

認証

変数	必須	説明
PLANFIX_API_KEY	はい	API キーです。アカウント管理 → API アクセス → REST API で作成します
PLANFIX_ACCOUNT	はい	サブドメインです（例：mycompany.planfix.com の mycompany）。REST API には共通ホストがないため必須です
PLANFIX_HOST	いいえ	地域別インストール用のホストです（デフォルトは planfix.com、例：planfix.ru）
PLANFIX_TOKEN	いいえ	非推奨の方式です。PLANFIX_API_KEY を使用してください

ベース URL：https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/。認証には Authorization: Bearer <key> ヘッダーを使用します。

ツール（20）

タスク

ツール	説明
get_tasks	タスク一覧（ページネーション、fields、filterId、アドホックな filters）
get_task	ID を指定して単一のタスクを取得
create_task	タスクを作成（プロジェクトと担当者を指定できます。list_users を参照）
update_task	タスクを更新（名前、説明、ステータス、担当者）

連絡先

ツール	説明
get_contacts	連絡先一覧
get_contact	ID を指定して単一の連絡先を取得
create_contact	連絡先または会社を作成
update_contact	連絡先を更新（名前、メールアドレス、電話番号）

プロジェクト、コメント

ツール	説明
get_projects	プロジェクト一覧
get_project	ID を指定して単一のプロジェクトを取得
get_comments	タスクのコメントを取得
add_comment	タスクにコメントを追加

従業員、ディレクトリ、フィールド、ファイル

ツール	説明
list_users	従業員一覧 — 名前から担当者の ID を検索するには、これを使用してください
get_user	ID を指定して単一の従業員を取得
list_directories	ディレクトリ（タスクのステータスセットはディレクトリとして保存されます）
list_directory_entries	ディレクトリ ID を指定してエントリを取得（例：ステータスの選択肢）
list_custom_fields	オブジェクトの種類（task/contact/project/user/main）別のカスタムフィールド
list_datatags	日付タグ
upload_file_from_url	直接リンクからファイルをアップロード
get_file	ID を指定してファイルのメタデータを取得

スキル（Skills / Prompts）（2）

スキル	説明
skill-my-tasks	「今日の自分のタスク」— 期限が今日のタスク、または期限切れのタスクを表示します
skill-create-task	「プロジェクトにタスクを作成」— プロジェクトを選択しながらタスクを作成する手順を案内します

Статусы задач

Отдельного эндпоинта /taskstatus/list в Planfix нет. Системные статусы — фиксированный набор констант: DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED. Кастомные наборы статусов настраиваются как справочники — перечислить их можно через list_directories → list_directory_entries.

Примеры

Покажи мои задачи в Planfix
Найди сотрудника Иванов и создай задачу "Подготовить отчёт" в проекте 123 с ним как исполнителем
Список контактов
Покажи проекты
Добавь комментарий к задаче 456: "Готово"

🚀 Демо-промпты

Сценарий: "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"

🤖 Хорошо сочетается с:

• @theyahia/kaiten-mcp
• @theyahia/megaplan-mcp
• @theyahia/yandex-tracker-mcp

Ограничения

• priority в create_task передаётся как строка «как есть» — точные допустимые значения не верифицированы против live API.
• Прямая загрузка файлов с диска (multipart POST /file/) и эндпоинты time-tracking/actions не реализованы (REST-контракт не подтверждён). Доступна загрузка файла по ссылке (upload_file_from_url).

Разработка

npm install
npm test        # Vitest (32 теста)
npm run dev     # tsx watch
npm run build   # TypeScript compile

Planfix — реферальная программа

35% бессрочный recurring от всех платежей приведённых клиентов.

• Без сертификации — просто зарегистрируйтесь в партнёрской программе
• Recurring: получаете 35% каждый месяц, пока клиент платит
• Бессрочно: нет ограничений по времени выплат

Подробнее: planfix.com/partners

Лицензия

MIT

---

⭐ Поставьте звезду, если строите на Planfix — так сервер найдут другие разработчики.

---

Часть WWmcp · Telegram: @vhodvai