Arch MCP Tools

@koreai/arch-mcp-tools ist ein Model Context Protocol (MCP)-Server, der Ihren KI-Codierungsassistenten mit der Kore.ai Agent Platform verbindet. Er gibt dem Assistenten eine Reihe von Werkzeugen zum Erstellen, Bewerten, Optimieren, Debuggen und Analysieren von Agents auf der Plattform – Projekte, Agents und Tools erstellen und bearbeiten; Bewertungen ausführen; Live-Sitzungen und Traces untersuchen; und Fehler diagnostizieren – direkt aus Ihrem Editor oder Terminal.

Er funktioniert mit jedem MCP-kompatiblen Client (Claude Code, Cursor, VS Code, Codex CLI und anderen). Der Server wird Clients unter dem Namen arch-agent-platform bereitgestellt, und seine Tools tragen die Präfixe platform_* und debug_*.

1.5.0-Release

@koreai/arch-mcp-tools@1.5.0 ist ein umfangreiches Feature-Release, bleibt aber ein SemVer-Minor-Update innerhalb der 1.x-Kompatibilitätslinie.

Das Release fügt hinzu:

• codegestützte Abdeckung für alle 45 öffentlichen Tools und 179 schema-deklarierten Operationen in 13 Feature-Gruppen;

• operationsbezogene Konfidenz-, Sicherheits-, Voraussetzungs-, Einschränkungs-, Abhängigkeits- und Verifizierungsrichtlinien;

• additive arch://guidance/v1/*-Ressourcen sowie Planungs- und Verifizierungs-Prompts;

• eine schema-gesteuerte Codex/Claude-Fähigkeit, die nur über den eigentumssicheren arch-mcp-guidance-Befehl installiert wird; und

• Clean-Package-, Autorisierungs-/Isolations-, Kompatibilitäts-, Fehlerisolations- und Vier-Metrik-Abdeckungs-Gates.

Das Wissensprotokoll bleibt auf Schema-Version 1; die Paketversion und die Wissensschema-Version sind bewusst unabhängig. Die bestehende 45-Tool-Erkennung, Tool-Namen und -Schemata, Initialisierungsanweisungen, Project-Builder-Payloads/-Reihenfolge und das bisherige Downgrade-Verhalten von Studio bleiben unverändert. Neue Ressourcen und Prompts werden angehängt, und die Guidance-Konstruktion schlägt weich fehl, ohne die Legacy-MCP-Oberfläche zu deaktivieren.

Verbraucher können das Release explizit pinnen:

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

Related MCP server: MCP Architect

Anforderungen

• Node.js 18 oder neuer – der Server läuft über npx, keine separate Installation erforderlich.

• Ein Kore.ai Agent Platform-Konto – Sie authentifizieren sich bei der ersten Verbindung (siehe Authentifizierung).

Installation

@koreai/arch-mcp-tools ist ein standardmäßiger stdio-MCP-Server. Jeder Client startet ihn auf die gleiche Weise:

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

Fügen Sie ihn unter einem Server namens arch-agent-platform mit der Konfiguration Ihres Clients unten hinzu. Die nicht gepinnte Form folgt dem npm-latest-Tag; verwenden Sie @koreai/arch-mcp-tools@1.5.0 für eine reproduzierbare Installation. (Es ist keine Umgebung eingebettet – siehe Umgebung auswählen.)

Claude Code

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

Oder fügen Sie ihn zu .mcp.json (Projekt) oder ~/.claude.json (global) hinzu:

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

Cursor

Fügen Sie zu .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) hinzu:

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

VS Code (GitHub Copilot)

Fügen Sie zu .vscode/mcp.json hinzu – beachten Sie, dass der Top-Level-Schlüssel servers ist (nicht 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

Oder fügen Sie zu ~/.codex/config.toml hinzu – beachten Sie, dass dies TOML ist, nicht JSON:

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

Jeder andere MCP-Client

Konfigurieren Sie einen stdio-Server mit dem Befehl npx und den Argumenten ["-y", "@koreai/arch-mcp-tools"]. Optional können Sie eine AGENTS_URL-Umgebungsvariable setzen, um eine Umgebung festzulegen.

Optionale Codex- oder Claude-Guidance-Fähigkeit

Das Paket enthält eine kanonische arch-platform-Fähigkeit, die auf dem versionierten Operationskatalog des Servers basiert. Die Installation ist explizit und läuft nie als Teil des normalen MCP-Starts:

# 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

Der Installer lehnt unverwaltete oder modifizierte Dateien ab und zeichnet Hashes in einem Eigentumsmanifest auf. Ersetzen Sie install durch uninstall, um nur unveränderte Dateien zu entfernen, die diesem Paket gehören.

Oder fragen Sie einfach Ihren Assistenten

Fügen Sie dies in den Chat Ihres Codierungstools ein, und es wird den Server für Sie einrichten:

Fügen Sie einen MCP-Server namens arch-agent-platform hinzu, der npx -y @koreai/arch-mcp-tools ausführt, und platzieren Sie ihn in der MCP-Konfiguration dieses Projekts. Konfigurationsspeicherort nach Tool – 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]). Setzen Sie optional AGENTS_URL auf meine Umgebung.

Umgebung auswählen

Keine Umgebung ist fest codiert. Bei der ersten Verwendung fragen die Tools, mit welcher Umgebung sie sich verbinden sollen – oder Sie können eine festlegen, indem Sie AGENTS_URL in der env des Servers setzen (oder serverUrl an platform_connect übergeben).

Beispiel mit festgelegter Umgebung (Claude Code / Cursor-Form):

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

Codegestütztes Operations- und Abhängigkeitswissen

Arch stellt additive arch://guidance/v1/*-Ressourcen für das Katalogmanifest, Feature-Familien, alle schema-abgeleiteten Operationen, Abhängigkeitskanten und Detailinformationen pro Feature/Tool bereit. Jedes veröffentlichte Tool erscheint genau einmal; Aktionen stammen aus demselben effektiven Eingabeschema, das MCP-Clients angezeigt wird. Kuratierte Sicherheits-, Umfangs-, Voraussetzungs-, Support-, Einschränkungs- und Verifizierungsreferenzen werden nur akzeptiert, wenn sie sich auf echte Tools/Aktionen beziehen.

Verwenden Sie plan-platform-operation vor Arbeiten mit mehreren Features und verify-platform-operation nach einer bestimmten Aktion. Statische Abhängigkeiten leiten die Reihenfolge; authentifizierte Project-Builder-Berichte bleiben die Autorität für die Live-Projektbereitschaft. Features ohne öffentliche Arch-MCP-Operationen werden nicht als ausführbarer Support dargestellt.

Tools

Arch Build

Erstellen und ändern Sie Plattformprojekte, Workflows, Agents, Tools, Auth-Profile, Integrationen, MCP-Server, Konfiguration, Versionen, Deployments und Importe.

Skalierbares Project-Builder-Protokoll

Die Project-Builder-Oberfläche ist bewusst feature-neutral. Clients lernen die Kernontologie und registrierte Provider durch platform_project_builder(action: "describe"), MCP-Ressourcen und Prompts. Sie rekonstruieren keine featureübergreifenden Abhängigkeiten, indem sie primitive Tools aufrufen und Antworten lokal zusammenführen.

Workflow ist der erste v1.1-Provider. Ein zukünftiges Feature fügt eine Provider-Registrierung mit eigenen qualifizierten Arten, Aktionen, Schemata, Importen/Exporten, Bereitschaftsverantwortlichem und allow-listetem Studio-Routenadapter hinzu; es fügt keine weitere Top-Level-Orchestrierungskonvention hinzu. Live-Anfragen verhandeln jedes Mal die Studio-Vertragsunterstützung und stellen dann eine autoritative Projekt-/Provider-Anfrage. Eine fehlende oder mehrdeutige Fähigkeitsantwort wird als STUDIO_CAPABILITY_UNKNOWN gemeldet; nur ein explizit niedriger beworbener Vertrag ist STUDIO_UPGRADE_REQUIRED.

Verwenden Sie platform_project_builder_operations für dauerhafte Listen-/Lese-/Berichts-/Fortsetzungs-/Abbrechen-/Gewährungs-/Ausführungs-Flows. Seiteneffekte erfordern die exakte Operationsversion und die versuchsgebundene Gewährung, die von Studio zurückgegeben wird. Wiederholen Sie niemals einen verbrauchten Versuch mit unbekanntem Ergebnis und senden Sie niemals rohe Geheimnisse – erstellen oder autorisieren Sie ein Auth-Profil über den sicheren Studio-Flow und übergeben Sie nur undurchsichtige Referenzen.

platform_auth_profiles(create) erstellt nur Profile mit authType: "none". Profile mit Anmeldeinformationen geben absichtlich eine secureSetupRequired-Übergabe zurück, da API-Schlüssel, Client-Geheimnisse, Zertifikate und Token niemals in den MCP-/Modellkontext gelangen dürfen. Nach der sicheren Studio-Einrichtung kann MCP auflisten, untersuchen, Metadaten aktualisieren, validieren, widerrufen, OAuth initiieren (einschließlich nicht geheimer connectionConfig-Vorlagenwerte) und die undurchsichtige Profil-ID an Integrationen oder MCP-Server binden.

Arch Evaluate

Eval-Assets generieren, Eval-Workflows ausführen und CI-Nachweise lesen.

Arch Optimize

Pakete validieren, compiler-sichtbare Modelle untersuchen und Reparatur-Schleifen steuern.

Arch Debug

Verbinden Sie sich mit Live-Sitzungen, verfolgen Sie Fehler und untersuchen Sie den Ausführungszustand.

Analyse des Sitzungsverlaufs

debug_session_history ist die explizite, schreibgeschützte Alternative, wenn eine aufbewahrte Sitzung analysiert werden muss, nachdem ihr Live-MCP-Puffer nicht mehr verfügbar ist. Es funktioniert identisch von Codex, Claude und jedem standardkonformen MCP-Client. Verbinden Sie sich zuerst mit platform_connect mit der gewünschten Runtime, damit die vorhandene Bearer-Identität, der Workspace und die Umgebung maßgeblich bleiben.

Erste Seite auflisten (Standardwerte sind limit: 50, offset: 0, sortBy: lastActivityAt, sortDir: desc):

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

Eine mittlere oder letzte Trace-Seite lesen, indem offset erhöht wird; eine Seite nach der letzten ist eine leere, erfolgreiche Seite, kein Fehler:

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

Die Runtime steuert Aufbewahrung, Autorisierung, Sortierung sowie die zurückgegebenen _meta.source, source_chain, is_truncated, warnings und errors. Das Tool führt eine begrenzte Anfrage aus (2 MiB, 10 Sekunden), testet nie eine andere Route, wiederholt nicht, wandelt ein verborgenes 404 nicht stillschweigend in eine leere Seite um, lädt keine Live-Speicher und greift nicht von historischen Daten auf den MCP-Live-Puffer zurück. Fehler werden als begrenzte MCP-Fehler zurückgegeben; platzieren Sie keine Anmeldeinformationen oder Geheimnisse in Filterwerten.

Arch Analyze

Dokumentation, Diagnosen und Systemzustandssignale erläutern.

Authentifizierung

Die Authentifizierung erfolgt automatisch, wenn Sie platform_connect aufrufen – sie versucht der Reihe nach:

1. Explizites Token – einen authToken-Parameter übergeben.

2. Gespeicherte Anmeldeinformationen – liest denselben verschlüsselten Anmeldeinformationsspeicher, der von artemis-platform-cli login verwendet wird.

3. Geräteautorisierung – öffnet Ihren Browser und fragt ab, bis die Genehmigung im selben platform_connect-Aufruf abgeschlossen ist.

Anmeldeinformationen werden zur Wiederverwendung in zukünftigen Sitzungen gespeichert.

Lizenz

MIT – siehe LICENSE.