Arch MCP Tools

@koreai/arch-mcp-tools は、AIコーディングアシスタントを Kore.ai Agent Platform に接続する Model Context Protocol (MCP) サーバーです。アシスタントに、プラットフォーム上のエージェントを 構築、評価、最適化、デバッグ、分析 するための一連のツールを提供します。プロジェクト、エージェント、ツールの作成・編集、評価の実行、ライブセッションとトレースの検査、障害の診断を、エディタやターミナルから直接行えます。

MCP互換の任意のクライアント（Claude Code、Cursor、VS Code、Codex CLI など）で動作します。サーバーはクライアントに対して arch-agent-platform という名前で公開され、そのツールには platform_* と debug_* というプレフィックスが付いています。

1.5.0 リリース

@koreai/arch-mcp-tools@1.5.0 は、1.x 互換ライン内の SemVer マイナーアップデートでありながら、実質的な機能リリースです。

このリリースでは以下が追加されています:

• 13のフィーチャーグループにわたる全45の公開ツールと179のスキーマ宣言操作に対するコード由来のカバレッジ;

• 操作スコープの信頼性、安全性、前提条件、制限、依存関係、検証ガイダンス;

• 追加の arch://guidance/v1/* リソースと、計画および検証プロンプト;

• 所有権安全な arch-mcp-guidance コマンドでのみインストールされる、スキーマゲートされた Codex/Claude スキル; および

• クリーンパッケージ、認可/分離、互換性、障害分離、および4メトリックカバレッジゲート。

ナレッジプロトコルはスキーマバージョン 1 のままです。パッケージバージョンとナレッジスキーマバージョンは意図的に独立しています。既存の45ツールのディスカバリ、ツール名とスキーマ、初期化手順、プロジェクトビルダーのペイロード/順序、および以前の Studio ダウングレード動作は変更されません。新しいリソースとプロンプトが追加され、ガイダンス構築はレガシー MCP サーフェスを無効にせずにソフトに失敗します。

利用者はリリースを明示的に固定できます:

npx -y @koreai/arch-mcp-tools@1.5.0

Related MCP server: MCP Architect

要件

• Node.js 18 以降 — サーバーは npx で実行され、別途インストールは不要です。

• Kore.ai Agent Platform アカウント — 初回接続時に認証します（認証 を参照）。

インストール

@koreai/arch-mcp-tools は標準の stdio MCP サーバー です。すべてのクライアントは同じ方法で起動します:

command:  npx
args:     -y  @koreai/arch-mcp-tools

以下のクライアント設定を使用して、arch-agent-platform という名前のサーバーとして追加します。ピン留めされていない形式は npm の latest タグに従います。再現可能なインストールには @koreai/arch-mcp-tools@1.5.0 を使用してください。（環境は組み込まれていません — 環境の選択 を参照。）

Claude Code

claude mcp add arch-agent-platform -- npx -y @koreai/arch-mcp-tools

または、.mcp.json（プロジェクト）または ~/.claude.json（グローバル）に追加します:

{
  "mcpServers": {
    "arch-agent-platform": {
      "command": "npx",
      "args": ["-y", "@koreai/arch-mcp-tools"]
    }
  }
}

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加します:

{
  "mcpServers": {
    "arch-agent-platform": {
      "command": "npx",
      "args": ["-y", "@koreai/arch-mcp-tools"]
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json に追加します — トップレベルのキーは servers（mcpServers ではない）ことに注意してください:

{
  "servers": {
    "arch-agent-platform": {
      "command": "npx",
      "args": ["-y", "@koreai/arch-mcp-tools"]
    }
  }
}

Codex CLI

codex mcp add arch-agent-platform -- npx -y @koreai/arch-mcp-tools

または、~/.codex/config.toml に追加します — これは TOML であり、JSON ではないことに注意してください:

[mcp_servers.arch-agent-platform]
command = "npx"
args = ["-y", "@koreai/arch-mcp-tools"]

その他の MCP クライアント

コマンド npx と引数 ["-y", "@koreai/arch-mcp-tools"] で stdio サーバーを構成します。オプションで AGENTS_URL 環境変数を設定して環境を固定できます。

オプションの Codex または Claude ガイダンススキル

パッケージには、サーバーのバージョン管理された操作カタログに基づく正規の arch-platform スキルが同梱されています。インストールは明示的であり、通常の MCP 起動の一部として実行されることはありません:

# User scope
npx -y -p @koreai/arch-mcp-tools arch-mcp-guidance install --client codex --scope user
npx -y -p @koreai/arch-mcp-tools arch-mcp-guidance install --client claude --scope user

# Project scope (run in the project root)
npx -y -p @koreai/arch-mcp-tools arch-mcp-guidance install --client codex --scope project
npx -y -p @koreai/arch-mcp-tools arch-mcp-guidance install --client claude --scope project

インストーラーは、管理外または変更されたファイルを拒否し、所有権マニフェストにハッシュを記録します。install を uninstall に置き換えると、このパッケージが所有する未変更のファイルのみが削除されます。

または、アシスタントに依頼する

これをコーディングツールのチャットに貼り付けると、サーバーをセットアップしてくれます:

npx -y @koreai/arch-mcp-tools を実行する arch-agent-platform という名前の MCP サーバーを追加し、このプロジェクトの MCP 設定に配置してください。 ツール別の設定場所 — Claude Code: .mcp.json (mcpServers) · Cursor: .cursor/mcp.json (mcpServers) · VS Code: .vscode/mcp.json (servers) · Codex: ~/.codex/config.toml ([mcp_servers.arch-agent-platform])。 オプションで AGENTS_URL を自分の環境に設定してください。

環境の選択

環境はハードコードされていません。初回使用時に、ツールは接続先の環境を尋ねます。または、サーバーの env で AGENTS_URL を設定する（または platform_connect に serverUrl を渡す）ことで環境を固定できます。

環境を固定した例（Claude Code / Cursor 形式）:

{
  "mcpServers": {
    "arch-agent-platform": {
      "command": "npx",
      "args": ["-y", "@koreai/arch-mcp-tools"],
      "env": {
        "AGENTS_URL": "https://agents.kore.ai"
      }
    }
  }
}

コードに基づく操作と依存関係の知識

Arch は、カタログマニフェスト、フィーチャーファミリー、すべてのスキーマ由来の操作、依存関係エッジ、およびフィーチャー/ツールごとの詳細について、追加の arch://guidance/v1/* リソースを公開します。公開されているすべてのツールは正確に1回出現します。アクションは、MCP クライアントに通知される同じ実効入力スキーマから取得されます。キュレーションされた安全性、スコープ、前提条件、サポート、制限、検証リファレンスは、実際のツール/アクションに解決される場合にのみ受け入れられます。

複数フィーチャーの作業の前に plan-platform-operation を使用し、特定のアクションの後に verify-platform-operation を使用します。静的依存関係が順序を導きます。認証されたプロジェクトビルダーレポートは、ライブプロジェクトの準備状況の権威であり続けます。公開された Arch MCP 操作がないフィーチャーは、実行可能なサポートとして提示されません。

ツール

Arch Build

プラットフォームのプロジェクト、ワークフロー、エージェント、ツール、認証プロファイル、統合、MCP サーバー、構成、バージョン、デプロイメント、インポートを作成および変更します。

スケーラブルなプロジェクトビルダープロトコル

プロジェクトビルダーサーフェスは意図的にフィーチャー中立です。クライアントは、platform_project_builder(action: "describe")、MCP リソース、およびプロンプトを通じて、コアオントロジーと登録済みプロバイダーを学習します。プリミティブツールを呼び出してレスポンスをローカルで結合することにより、クロスフィーチャー依存関係を再構築することはありません。

Workflow は最初の v1.1 プロバイダーです。将来のフィーチャーは、独自の修飾された種類、アクション、スキーマ、インポート/エクスポート、準備状況オーナー、および許可リストされた Studio ルートアダプターを持つ1つのプロバイダー登録を追加します。別のトップレベルのオーケストレーション規約は追加されません。ライブリクエストは毎回 Studio 契約サポートをネゴシエートし、その後1つの権威あるプロジェクト/プロバイダーリクエストを行います。存在しない、またはあいまいな機能レスポンスは STUDIO_CAPABILITY_UNKNOWN として報告されます。明示的に低いアドバタイズされた契約のみが STUDIO_UPGRADE_REQUIRED です。

永続的な list/read/report/resume/cancel/grant/execute フローには platform_project_builder_operations を使用します。副作用には、Studio が返す正確な操作バージョンと試行バインドされた許可が必要です。未知の結果で消費された試行を再試行しないでください。また、生のシークレットを送信しないでください。安全な Studio フローを通じて認証プロファイルを作成または承認し、不透明な参照のみを渡してください。

platform_auth_profiles(create) は authType: "none" プロファイルのみを作成します。資格情報を含むプロファイルは、API キー、クライアントシークレット、証明書、トークンが MCP/モデルコンテキストに入ることを決して許してはならないため、意図的に secureSetupRequired ハンドオフを返します。安全な Studio セットアップ後、MCP は一覧表示、検査、メタデータの更新、検証、失効、OAuth の開始（非シークレットの connectionConfig テンプレート値を含む）、および不透明なプロファイル ID を統合または MCP サーバーにバインドできます。

Arch Evaluate

評価アセットを生成し、評価ワークフローを実行し、CI エビデンスを読み取ります。

Arch Optimize

パッケージを検証し、コンパイラ可視モデルを検査し、修復ループを駆動します。

Arch Debug

ライブセッションに接続し、障害をトレースし、実行状態を検査します。

履歴セッション分析

debug_session_history は、保持されているセッションを、ライブの MCP バッファが利用できなくなった後に分析する必要がある場合の、明示的な読み取り専用の代替手段です。Codex、Claude、および標準準拠の MCP クライアントから同じように動作します。まず platform_connect で対象の Runtime に接続して、既存のベアラー ID、ワークスペース、環境が権威あるものとして維持されるようにしてください。

最初のページを一覧表示します (デフォルトは limit: 50、offset: 0、sortBy: lastActivityAt、sortDir: desc):

{ "action": "list", "projectId": "project-id", "status": ["completed"], "range": "7d" }

offset を進めて中間または最終のトレースページを読み取ります。最終ページを超えたページは、エラーではなく空の成功ページです:

{
  "action": "get",
  "projectId": "project-id",
  "sessionId": "session-id",
  "limit": 200,
  "offset": 200,
  "types": ["llm_call", "tool_call"]
}

Runtime は、保持、認可、順序、および返される _meta.source、source_chain、is_truncated、warnings、errors を制御します。このツールは、単一の制限付きリクエスト (2 MiB、10 秒) を行い、他のルートを調査したり、再試行したり、隠れた 404 を黙って空のページに変換したり、ライブストアをハイドレートしたり、履歴データから MCP ライブバッファにフォールバックしたりすることはありません。エラーは制限付きの MCP エラーとして返されます。フィルタ値に資格情報やシークレットを入れないでください。

Arch Analyze

ドキュメント、診断、システムヘルスシグナルを説明します。

認証

platform_connect を呼び出すと、認証は自動的に行われます — 次の順序で試行されます:

1. 明示的トークン — authToken パラメータを渡します。

2. 保存済み資格情報 — artemis-platform-cli login が使用するのと同じ暗号化資格情報ストアを読み取ります。

3. デバイス認可 — ブラウザを開き、同じ platform_connect 呼び出し内で承認が完了するまでポーリングします。

資格情報は、将来のセッションで再利用できるように保存されます。

ライセンス

MIT — LICENSE を参照してください。