QTM4J MCPサーバー

QMetry Test Management for Jira Cloud (QTM4J) REST APIを、Claude（またはその他のMCP互換クライアント）から呼び出せるツールとして公開するMCPサーバーです。

機能

主要なQTM4Jエンティティ全体で、最も一般的なCRUDフローをカバーするツールを提供します。

すべてのツールはZodで入力を検証し、startAt / maxResults を介してリストエンドポイントをページネーションし、レート制限（HTTP 429）応答に対しては最大3回まで指数バックオフによる自動再試行を行います。

要件

• Node.js 18+ (ネイティブの fetch を使用)

• QMetry APIキー (QMetry → API Keys から取得)

インストール

git clone https://github.com/salehrifai42/qmetrymcp.git
cd qmetrymcp
npm install
npm run build

設定

サーバーは完全に環境変数を通じて設定されます。

実行

QTM4J_API_KEY=your-key npm start

サーバーはstdio経由でMCPと通信します。通常は直接実行するのではなく、MCPクライアント（Claude Desktop、Claude Codeなど）が起動します。

MCPクライアントの設定

すべてのクライアントは node を使用してサーバーを直接実行します。/path/to/qmetrymcp をリポジトリをクローンした絶対パスに置き換えてください。

Claude Desktop

macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json を編集し（他のプラットフォームでは相当するファイル）、Claude Desktopを再起動します。

{
  "mcpServers": {
    "qtm4j": {
      "command": "node",
      "args": ["/path/to/qmetrymcp/dist/index.js"],
      "env": {
        "QTM4J_API_KEY": "your-api-key-here",
        "QTM4J_REGION": "US"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add コマンドを使用します。

claude mcp add qtm4j \
  -e QTM4J_API_KEY=your-api-key-here \
  -e QTM4J_REGION=US \
  -- node /path/to/qmetrymcp/dist/index.js

これはユーザースコープの設定ファイル (~/.claude.json) に書き込まれます。単一のリポジトリにスコープを限定したい場合は、プロジェクトのルートに上記のClaude Desktopの例と同じ mcpServers 構造を持つ .mcp.json を配置してください。Claude Codeが自動的に読み取ります。

登録されていることを確認します。

claude mcp list

セッション内で /mcp を実行して、接続されているサーバーとそのツールを確認することもできます。

GitHub Copilot (VS Code)

Copilotのエージェントモードは、ワークスペース内の .vscode/mcp.json ファイル（またはユーザーの settings.json 内の github.copilot.chat.mcp.servers に相当するブロック）を介してMCPをサポートしています。注意：Copilotのスキーマは servers を使用し（mcpServers ではありません）、明示的な type を期待します。

// .vscode/mcp.json
{
  "servers": {
    "qtm4j": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/qmetrymcp/dist/index.js"],
      "env": {
        "QTM4J_API_KEY": "your-api-key-here",
        "QTM4J_REGION": "US"
      }
    }
  }
}

保存後、Copilot Chatパネルを開き、Agentモードに切り替えると、ツールピッカーに qtm4j ツールが表示されます。APIキーをコミットしたくない場合は、VS Codeのシークレット入力を使用してください。

{
  "inputs": [
    { "id": "qtm4jKey", "type": "promptString", "description": "QTM4J API Key", "password": true }
  ],
  "servers": {
    "qtm4j": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/qmetrymcp/dist/index.js"],
      "env": {
        "QTM4J_API_KEY": "${input:qtm4jKey}",
        "QTM4J_REGION": "US"
      }
    }
  }
}

試してみる