mcp-tomticket

mcp-tomticket

TomTicket v2 API 用の MCP サーバーです。チケットの一覧表示、返信、作業時間の記録、完了に加え、顧客、組織、チャット、部門、ナレッジベースにも対応しています。

ログイン用のエンドポイントはありません。Bearer Token は管理画面の Administração → Configurações da Conta → API → Novo Token で作成します。返信、作業時間の記録、完了を行うには、Pode criar e modificar dados にチェックを入れてください。

トークンは環境変数にのみ設定してください。絶対にコミットしないでください。

要件

• Node.js >= 18
• TomTicket API トークン（Premium/Enterprise アカウント）

インストール

npm 経由（推奨）：

npx mcp-tomticket

Cursor の場合（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "tomticket": {
      "command": "npx",
      "args": ["-y", "mcp-tomticket"],
      "env": {
        "TOMTICKET_TOKEN": "cole-o-token-aqui"
      }
    }
  }
}

ローカルにクローン：

git clone https://github.com/glira/mcp-tomticket.git
cd mcp-tomticket
npm install
cp .env.example .env
# edite .env e cole o TOMTICKET_TOKEN
npm run build

簡易検証（読み取り専用）：

npm run smoke

任意 — 件名が [MCP TESTE] のテストチケットを1件作成し、コメント、返信、完了を行います：

npx tsx scripts/smoke.ts --write

Settings → MCP で MCP を再読み込みしてください。ローカルでの設定例は .cursor/mcp.json.example を参照してください。

主なツール

ツール	操作
tomticket_list_open_tickets	オープンチケット
tomticket_list_tickets	フィルター付きですべて表示
tomticket_get_ticket	詳細 + 返信 + 作業時間
tomticket_reply_ticket	担当者からの返信（start_date/end_date で作業時間を記録）
tomticket_comment_ticket	内部コメント
tomticket_finish_ticket	チケットを完了（time_work は分単位）
tomticket_start_status / tomticket_close_status	ステータスのタイマー
tomticket_create_ticket	チケットを作成
tomticket_transfer_ticket / tomticket_assign_operator	移管 / 担当者を割り当て

顧客、組織、チャット、部門、KB、カスタムフィールド用のツールもあります。書き込み操作では、本番環境が変更されることを通知します。チケットを完了するには、担当者が割り当てられている必要があります（tomticket_assign_operator）。

レート制限

API は毎秒3リクエストを受け付けます。クライアントは最低350ミリ秒の間隔を適用します。

変数

変数	必須	説明
TOMTICKET_TOKEN	はい	管理画面の Bearer Token
TOMTICKET_BASE_URL	いいえ	デフォルトは https://api.tomticket.com/v2.0

ライセンス

MIT