Katalon True Platform MCP

まずはこちら · クイックスタート · スキル · ライフサイクル · インストール · MCP · コントリビューション

コーディングエージェントに要件を読み込ませ、テストケースを設計し、AI で実行してレポートをアップロードし、リリースしても安全かどうかを判断してもらいましょう。スキルは Katalon MCP を通じてプラットフォーム上の作業を行うため、エージェントは推測で済ませるのではなく、実際のプロジェクトを操作します。

_{セッションの例です。要件キー、スイート、判定結果は、ご利用のワークスペースに基づきます。}

クイックスタート

1. スキルをインストールします。 skills CLI が現在お使いのエージェント（70 以上に対応）を検出し、ネイティブのディレクトリにスキルを配置します。

npx skills add katalon-labs/true-skills

2. Katalon ワークスペースを指定します。 MCP サーバーをエージェントの設定ファイルに追加します（どのファイルを使うかはインストールのセクションをご覧ください）。

{
  "mcpServers": {
    "katalon-prod-mcp": {
      "type": "http",
      "url": "https://platform.katalon.io/mcp"
    }
  }
}

初回接続時にはブラウザーで OAuth フローが開き、ワークスペースを選択できます。入力も、貼り付けるトークンも、保存するキーも必要ありません。

3. 実際に使ってみましょう。

Set up Katalon MCP and verify my projects.
Create manual tests from requirement CEL-6 and link them.
Which requirements in this sprint have no test coverage?
Run that suite with AI and summarize what broke.
Generate a Playwright script from test case TC-1042.
Upload my Playwright report to Katalon and verify the run.
Is release 3.2 safe to ship?

または、一連の作業をまとめて依頼できます。「CEL-6 を分析し、ケースを設計してインポートし、スイートを作成して AI で実行し、リリースできるかどうか教えてください。」

今いる場所から始めましょう

4つの役割があります。状況を自分の言葉で伝えると、エージェントがスキルを選びます。

まだ接続していない場合は、全員が一度実行する platform-setup から始めてください。

自分の役割がわからない場合や、依頼が複数の役割にまたがる場合は、true-platform-testing に尋ねてください。役割と段階に応じて振り分けてくれます。意図からスキルまでの全体マップと、まだ構築されていない部分で代わりに使うものは、lifecycle-map.md に記載されています。

スキル

スキルは19個あり、それぞれ skills/ の下に個別のフォルダーがあります。エージェントは説明に基づいて適切なスキルを選ぶため、自分でスキル名を指定することはほとんどありません。

ライフサイクル

7 つのステージがあり、それぞれを 1 つのスキルが担当します。メンテナンスで見つかったギャップの一覧が計画にフィードバックされると、ループが完了します。

platform-setup は 7 つのステージすべてに先立って配置され、MCP を接続します。各スキルには、使用する Katalon MCP ツールとプラットフォームの対応範囲が記載されています。全ステージのマップは lifecycle-map.md にあります。すべてのツールを 1 行ずつ記載した一覧は mcp-tool-index.md にあります。人が閲覧できる、単体で完結したビジュアルは docs/lifecycle.html にあります。

対応範囲

各スキルでは、プラットフォームで実行できない作業をエージェントが約束しないよう、最初に制限事項を明示しています。

MCP 経由で可能： プロジェクトとリポジトリの一覧表示、要件の読み取り、テストケースの作成・更新・リンク、スイートとフォルダーの管理、手動実行の作成、Run with AI の開始、AI セッションのポーリング、結果の読み取り、品質メトリクスの取得、ALM にリンクされた不具合の登録。

MCP 経由では不可： 要件の作成、正式な Test Plan エンティティの作成、AI 実行の完了保証、ブラウザーツールを使わずに実行中のアプリの UI を調査すること。Test Plan エンティティの代わりに、名前付きのスイートとリリースまたはスプリントとの関連付けを使用します。

一部の作業は API 呼び出しではなく、製品の UI 上で行います。Studio でのオブジェクトのキャプチャと回復力の設計、TestOps UI でのカスタムフィールド・Git 設定・ガバナンス、セルフヒーリング・Time Capsule・TrueTest の再生成、再実行・終了・Live Monitor が該当します。全一覧は unavailable-capabilities.md にあります。

インストール

どの方法でも、Katalon MCP の接続の設定が必要です。

npx skills add katalon-labs/true-skills                          # all skills, this project
npx skills add katalon-labs/true-skills --skill platform-setup   # just one
npx skills add katalon-labs/true-skills -g                       # user-global, every agent
npx skills update                                                # pull the latest

claude plugin marketplace add katalon-labs/true-skills
claude plugin install katalon-true-platform@katalon-true-platform-marketplace

claude --plugin-dir plugins/katalon-true-platform

codex plugin marketplace add katalon-labs/true-skills

mkdir -p .github .vscode \
  && cp -R <checkout>/.github/skills .github/ \
  && cp -R <checkout>/.github/prompts .github/ \
  && cp <checkout>/.github/copilot-instructions.md .github/ \
  && cp <checkout>/.github/mcp.json .github/ \
  && cp <checkout>/.vscode/mcp.json .vscode/

cp -R <checkout>/.cursor .cursor

cp -R <checkout>/.kiro .kiro

# local/developer install: point Kiro Crew at the app directory
apps/katalon-testing-skills/

cp -R <checkout>/.windsurf .windsurf

cp -R <checkout>/.clinerules .clinerules

cp -R <checkout>/.continue .continue

Katalon MCP に接続する

すべてのワークスペースで、単一のエンドポイント https://platform.katalon.io/mcp を使用します。サインイン時にワークスペース選択画面が表示されるため、サブドメインを調べる必要はありません。標準的な設定形式は .mcp.json にあります。

{
  "mcpServers": {
    "katalon-prod-mcp": {
      "type": "http",
      "url": "https://platform.katalon.io/mcp"
    }
  }
}

ネイティブのリモート MCP に対応していないエージェント（Kiro、Continue、Codex）では、同じエンドポイントに対して mcp-remote ラッパーを使用します。

npx -y mcp-remote https://platform.katalon.io/mcp --transport http-first

1. 初回接続時に開くブラウザーの OAuth フローを完了します。
2. ワークスペースを選択します。
3. ツールが表示されない場合は、エージェントを再読み込みします。

Katalon 専用ドメインを使用している場合は、https://<your-sub-domain>.katalon.io/mcp に置き換えてください。

認証にはブラウザーの OAuth のみを使用してください。 パスワード、API トークン、Cookie、JWT、MFA コード、OAuth コールバック URL をチャットに貼り付けたり、コミットしたりしないでください。スキルによってこれらの操作は禁止されています。

構築方法

スキルの本文は一元管理されています。各エージェントに必要なものはすべて本文から生成されるため、アダプター間で内容が食い違うことはありません。

  skills/                      13 SKILL.md files plus references/
     |
     |  node scripts/build-adapters.mjs      deterministic, checked in CI
     v
  Claude Code · Codex · Copilot · Cursor · Kiro · Windsurf · Cline · Continue · AGENTS.md
     |
     |  every adapter points at the same server
     v
  Katalon MCP  ->  requirements, test cases, suites, Run with AI, results, defects

skills/                              source of truth, 19 skills
scripts/build-adapters.mjs           generates every agent config
plugins/katalon-true-platform/       Claude Code and Codex plugin      (generated)
.claude-plugin/  .agents/            plugin marketplaces               (generated)
.cursor/  .kiro/  .github/           Cursor, Kiro, Copilot             (generated)
.windsurf/  .clinerules/  .continue/ Windsurf, Cline, Continue         (generated)
apps/katalon-testing-skills/         Kiro Crew app                     (generated)
.mcp.json  .vscode/mcp.json          MCP config                        (generated)
AGENTS.md  llms.txt                  agent-readable index              (generated)

貢献

skills/ のみを編集してください。それ以外はすべて生成されます。その後、次を実行します。

node scripts/validate-skills.mjs    # skills/ matches scripts/skills.config.mjs
node scripts/build-adapters.mjs     # regenerate every agent config

ビルドは決定論的です。スキルを変更せずに再実行しても差分は発生せず、同期されていないアダプターは CI で拒否されます。詳しくは CONTRIBUTING.md をご覧ください。

ChatGPT プラグインパッケージのソースは chatgpt/ 配下にあり（ChatGPT の plugin.json、スキルごとの agents/openai.yaml オーバーレイ、カードのツールマップ、リスティング用アセット）、独自のビルドもあります。このビルドでは、許可リストにあるファイルのみを dist/chatgpt/ に配置し、OpenAI のプラグインディレクトリで拒否されるものはすべて拒否します。

python3 scripts/build-chatgpt-plugin.py      # dist/chatgpt/katalon-true-platform/ and the ZIP
python3 -m unittest discover -s tests        # one bad fixture per forbidden item

リスティングのコピー、レビューケース、提出チェックリストは docs/chatgpt/ にあります。

サポート

• バグ、質問、スキルのリクエスト：イシューを作成
• Katalon プラットフォームおよび MCP のサポート：support.katalon.com、または Katalon カスタマーサクセスマネージャーにお問い合わせください
• MCP サーバーのドキュメント：docs.katalon.com

プライバシー

スキルは、すでにお使いのエージェント内で実行されるプレーンな Markdown です。このリポジトリは何も収集しません。プラットフォームの操作は OAuth 経由でお客様自身の Katalon ワークスペースに送られます。Katalon によるデータの取り扱いについては、Katalon プライバシーポリシーに記載されています。

ライセンス

MIT © Katalon。「Katalon」および「Katalon True Platform」は Katalon, Inc. の商標です。