Arch MCP Tools

@koreai/arch-mcp-tools es un servidor Model Context Protocol (MCP) que conecta tu asistente de codificación con IA a la Kore.ai Agent Platform. Proporciona al asistente un conjunto de herramientas para crear, evaluar, optimizar, depurar y analizar agentes en la plataforma: crear y editar proyectos, agentes y herramientas; ejecutar evaluaciones; inspeccionar sesiones y trazas en vivo; y diagnosticar fallos, directamente desde tu editor o terminal.

Funciona con cualquier cliente compatible con MCP (Claude Code, Cursor, VS Code, Codex CLI y otros). El servidor se expone a los clientes con el nombre arch-agent-platform, y sus herramientas llevan el prefijo platform_* y debug_*.

Lanzamiento 1.5.0

@koreai/arch-mcp-tools@1.5.0 es una versión de funcionalidades sustancial que sigue siendo una actualización menor SemVer dentro de la línea de compatibilidad 1.x.

Esta versión añade:

• cobertura derivada del código para las 45 herramientas públicas y 179 operaciones declaradas en el esquema en 13 grupos de funcionalidades;

• orientación de confianza, seguridad, requisitos previos, limitaciones, dependencias y verificación por operación;

• recursos aditivos arch://guidance/v1/* además de prompts de planificación y verificación;

• una skill de Codex/Claude restringida por esquema que solo se instala mediante el comando arch-mcp-guidance, seguro en cuanto a la propiedad; y

• compuertas de cobertura de paquete limpio, autorización/aislamiento, compatibilidad, aislamiento de fallos y cuatro métricas.

El protocolo de conocimiento sigue siendo la versión 1 del esquema; la versión del paquete y la versión del esquema de conocimiento son intencionadamente independientes. El descubrimiento existente de 45 herramientas, los nombres y esquemas de las herramientas, las instrucciones de inicialización, las cargas útiles/el orden del project-builder y el comportamiento de degradación anterior de Studio permanecen sin cambios. Los nuevos recursos y prompts se añaden, y la construcción de la guía falla de forma suave sin deshabilitar la superficie MCP heredada.

Los consumidores pueden fijar la versión explícitamente:

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

Related MCP server: MCP Architect

Requisitos

• Node.js 18 o superior — el servidor se ejecuta mediante npx, sin necesidad de instalación adicional.

• Una cuenta de Kore.ai Agent Platform — te autenticas en la primera conexión (consulta Autenticación).

Instalación

@koreai/arch-mcp-tools es un servidor MCP stdio estándar. Todos los clientes lo lanzan de la misma manera:

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

Añádelo bajo un servidor llamado arch-agent-platform usando la configuración de tu cliente a continuación. La forma sin fijar sigue la etiqueta latest de npm; usa @koreai/arch-mcp-tools@1.5.0 para una instalación reproducible. (No hay ningún entorno integrado de fábrica; consulta Elección del entorno).

Claude Code

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

O añádelo a .mcp.json (proyecto) o a ~/.claude.json (global):

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

Cursor

Añádelo a .cursor/mcp.json (proyecto) o a ~/.cursor/mcp.json (global):

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

VS Code (GitHub Copilot)

Añádelo a .vscode/mcp.json — ten en cuenta que la clave de nivel superior es servers (no 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

O añádelo a ~/.codex/config.toml — ten en cuenta que esto es TOML, no JSON:

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

Cualquier otro cliente MCP

Configura un servidor stdio con el comando npx y los argumentos ["-y", "@koreai/arch-mcp-tools"]. Opcionalmente, define una variable de entorno AGENTS_URL para fijar un entorno.

Skill de guía opcional para Codex o Claude

El paquete incluye una skill canónica arch-platform basada en el catálogo de operaciones versionado del servidor. La instalación es explícita y nunca se ejecuta como parte del inicio normal de 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

El instalador rechaza archivos no gestionados o modificados y registra los hash en un manifiesto de propiedad. Sustituye install por uninstall para eliminar solo los archivos sin cambios propiedad de este paquete.

O simplemente pídeselo a tu asistente

Pega esto en el chat de tu herramienta de codificación y configurará el servidor por ti:

Añade un servidor MCP llamado arch-agent-platform que ejecute npx -y @koreai/arch-mcp-tools, y colócalo en la configuración MCP de este proyecto. Ubicación de la configuración según la herramienta: 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]). Opcionalmente, define AGENTS_URL con mi entorno.

Elección del entorno

Ningún entorno está codificado de fábrica. En el primer uso, las herramientas preguntan a qué entorno conectarse; o puedes fijar uno definiendo AGENTS_URL en el env del servidor (o pasando serverUrl a platform_connect).

Ejemplo con un entorno fijado (formato de Claude Code / Cursor):

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

Conocimiento de operaciones y dependencias respaldado por código

Arch expone recursos aditivos arch://guidance/v1/* para el manifiesto del catálogo, las familias de funcionalidades, todas las operaciones derivadas del esquema, las aristas de dependencias y el detalle por funcionalidad/herramienta. Cada herramienta publicada aparece exactamente una vez; las acciones provienen del mismo esquema de entrada efectivo anunciado a los clientes MCP. Las referencias seleccionadas de seguridad, alcance, requisitos previos, soporte, limitaciones y verificación solo se aceptan cuando resuelven a herramientas/acciones reales.

Usa plan-platform-operation antes de trabajos con múltiples funcionalidades y verify-platform-operation después de una acción concreta. Las dependencias estáticas guían el orden; los informes autenticados del project-builder siguen siendo la autoridad para la preparación de proyectos en vivo. Las funcionalidades sin operaciones públicas de Arch MCP no se presentan como soporte ejecutable.

Herramientas

Arch Build

Crea y modifica proyectos de la plataforma, flujos de trabajo, agentes, herramientas, perfiles de autenticación, integraciones, servidores MCP, configuración, versiones, despliegues e importaciones.

Protocolo de project-builder escalable

La superficie del project-builder es intencionadamente neutra en cuanto a funcionalidades. Los clientes aprenden la ontología principal y los proveedores registrados a través de platform_project_builder(action: "describe"), los recursos MCP y los prompts. No reconstruyen dependencias entre funcionalidades llamando a herramientas primitivas y combinando respuestas localmente.

Workflow es el primer proveedor v1.1. Una funcionalidad futura añadirá un registro de proveedor con sus propios tipos cualificados, acciones, esquemas, importaciones/exportaciones, propietario de la preparación y adaptador de ruta de Studio en lista blanca; no añade otra convención de orquestación de nivel superior. Las solicitudes en vivo negocian el soporte del contrato de Studio cada vez y luego realizan una única solicitud autoritativa de proyecto/proveedor. Una respuesta de capacidad ausente o ambigua se notifica como STUDIO_CAPABILITY_UNKNOWN; solo un contrato anunciado explícitamente inferior es STUDIO_UPGRADE_REQUIRED.

Usa platform_project_builder_operations para flujos duraderos de listado/lectura/informe/reanudación/cancelación/concesión/ejecución. Los efectos secundarios requieren la versión exacta de la operación y la concesión vinculada al intento devueltas por Studio. Nunca reintentes un intento consumido con un resultado desconocido, y nunca envíes secretos en bruto: crea o autoriza un perfil de autenticación mediante el flujo seguro de Studio y pasa solo referencias opacas.

platform_auth_profiles(create) crea únicamente perfiles con authType: "none". Los perfiles que contienen credenciales devuelven intencionadamente una transferencia secureSetupRequired, porque las claves de API, los secretos de cliente, los certificados y los tokens nunca deben entrar en el contexto MCP/modelo. Tras la configuración segura de Studio, MCP puede listar, inspeccionar, actualizar metadatos, validar, revocar, iniciar OAuth (incluidos los valores de plantilla no secretos de connectionConfig) y vincular el ID de perfil opaco a integraciones o servidores MCP.

Arch Evaluate

Genera activos de evaluación, ejecuta flujos de trabajo de evaluación y lee evidencia de CI.

Arch Optimize

Valida paquetes, inspecciona modelos visibles para el compilador y dirige bucles de reparación.

Arch Debug

Conéctate a sesiones en vivo, rastrea fallos e inspecciona el estado de ejecución.

Análisis de sesiones históricas

debug_session_history es la alternativa explícita y de solo lectura cuando una sesión retenida debe analizarse después de que su búfer MCP en vivo no esté disponible. Funciona igual desde Codex, Claude y cualquier cliente MCP compatible con estándares. Conéctese primero al Runtime deseado con platform_connect para que la identidad de portador, el espacio de trabajo y el entorno existentes sigan siendo la referencia.

Liste una primera página (los valores predeterminados son limit: 50, offset: 0, sortBy: lastActivityAt, sortDir: desc):

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

Lea una página de traza intermedia o final avanzando offset; una página posterior a la última es una página vacía correcta, no un error:

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

El Runtime controla la retención, la autorización, la ordenación y los valores devueltos _meta.source, source_chain, is_truncated, warnings y errors. La herramienta realiza una única solicitud limitada (2 MiB, 10 segundos); nunca sondea otra ruta, reintenta, convierte silenciosamente un 404 oculto en una página vacía, hidrata almacenes en vivo ni recurre al búfer MCP en vivo como alternativa a los datos históricos. Los errores se devuelven como errores MCP limitados; no coloque credenciales ni secretos en los valores de los filtros.

Arch Analyze

Explicar documentación, diagnósticos y señales de salud del sistema.

Autenticación

La autenticación es automática cuando se llama a platform_connect — intenta, en orden:

1. Token explícito — pase un parámetro authToken.

2. Credenciales almacenadas — lee el mismo almacén de credenciales cifrado que utiliza artemis-platform-cli login.

3. Autorización de dispositivo — abre su navegador y sondea hasta que la aprobación se complete en la misma llamada a platform_connect.

Las credenciales se guardan para reutilizarlas en sesiones futuras.

Licencia

MIT — consulte LICENSE.