Arch MCP Tools

@koreai/arch-mcp-tools — это сервер Model Context Protocol (MCP), который подключает вашего ИИ-ассистента для программирования к Kore.ai Agent Platform. Он предоставляет ассистенту набор инструментов для создания, оценки, оптимизации, отладки и анализа агентов на платформе — создание и редактирование проектов, агентов и инструментов; запуск оценок; просмотр живых сессий и трассировок; диагностика сбоев — прямо из вашего редактора или терминала.

Он работает с любым MCP-совместимым клиентом (Claude Code, Cursor, VS Code, Codex CLI и другими). Сервер доступен клиентам под именем arch-agent-platform, а его инструменты имеют префиксы platform_* и debug_*.

Релиз 1.5.0

@koreai/arch-mcp-tools@1.5.0 — это значительный функциональный релиз, остающийся минорным обновлением SemVer в рамках линии совместимости 1.x.

Релиз добавляет:

• покрытие на основе кода для всех 45 публичных инструментов и 179 объявленных в схеме операций в 13 функциональных группах;

• руководства по уверенности, безопасности, предварительным условиям, ограничениям, зависимостям и проверке в разрезе операций;

• аддитивные ресурсы arch://guidance/v1/* плюс промпты для планирования и проверки;

• один скилл Codex/Claude, ограниченный схемой, устанавливаемый только через безопасную с точки зрения владения команду arch-mcp-guidance; и

• чистоту пакета, авторизацию/изоляцию, совместимость, изоляцию сбоев и шлюзы покрытия по четырём метрикам.

Протокол знаний остаётся на версии схемы 1; версия пакета и версия схемы знаний намеренно независимы. Существующее обнаружение 45 инструментов, имена и схемы инструментов, инструкции по инициализации, полезные нагрузки/порядок project-builder и прежнее поведение понижения версии для 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-клиент

Настройте stdio-сервер с командой npx и аргументами ["-y", "@koreai/arch-mcp-tools"]. При желании задайте переменную окружения 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, чтобы удалить только неизменённые файлы, принадлежащие этому пакету.

Или просто спросите своего ассистента

Вставьте это в чат вашего инструмента для программирования, и он подключит сервер за вас:

Добавьте MCP-сервер с именем arch-agent-platform, который запускает npx -y @koreai/arch-mcp-tools, и поместите его в 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 для моей среды.

Выбор среды

Никакая среда не зашита жёстко. При первом использовании инструменты спрашивают, к какой среде подключиться — или вы можете зафиксировать её, задав AGENTS_URL в env сервера (или передав serverUrl в platform_connect).

Пример с зафиксированной средой (форма 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/* для манифеста каталога, семейств функций, всех операций, производных от схемы, рёбер зависимостей и деталей по функциям/инструментам. Каждый опубликованный инструмент появляется ровно один раз; действия берутся из той же эффективной входной схемы, которая рекламируется MCP-клиентам. Курируемые ссылки по безопасности, области действия, предварительным условиям, поддержке, ограничениям и проверке принимаются только тогда, когда они разрешаются в реальные инструменты/действия.

Используйте plan-platform-operation перед многофункциональной работой и verify-platform-operation после конкретного действия. Статические зависимости направляют порядок; аутентифицированные отчёты project-builder остаются авторитетным источником для оценки готовности живого проекта. Функции без публичных операций Arch MCP не представляются как исполняемая поддержка.

Инструменты

Arch Build

Создание и изменение проектов платформы, рабочих процессов, агентов, инструментов, профилей аутентификации, интеграций, MCP-серверов, конфигурации, версий, развёртываний и импорта.

Масштабируемый протокол project-builder

Поверхность project-builder намеренно нейтральна к функциям. Клиенты изучают базовую онтологию и зарегистрированных провайдеров через platform_project_builder(action: "describe"), ресурсы MCP и промпты. Они не реконструируют межфункциональные зависимости, вызывая примитивные инструменты и объединяя ответы локально.

Workflow — первый провайдер v1.1. Будущая функция добавляет одну регистрацию провайдера со своими квалифицированными видами, действиями, схемами, импортом/экспортом, владельцем готовности и разрешённым адаптером маршрута Studio; она не добавляет ещё одно соглашение оркестрации верхнего уровня. Живые запросы каждый раз согласовывают поддержку контракта Studio, а затем делают один авторитетный запрос проекта/провайдера. Отсутствующий или неоднозначный ответ о возможностях сообщается как STUDIO_CAPABILITY_UNKNOWN; только явно более низкий рекламируемый контракт — это STUDIO_UPGRADE_REQUIRED.

Используйте platform_project_builder_operations для долговечных потоков list/read/report/resume/cancel/grant/execute. Побочные эффекты требуют точной версии операции и гранта с ограничением попыток, возвращаемых Studio. Никогда не повторяйте использованную попытку с неизвестным результатом и никогда не отправляйте сырые секреты — создайте или авторизуйте профиль аутентификации через защищённый поток Studio и передавайте только непрозрачные ссылки.

platform_auth_profiles(create) создаёт только профили с authType: "none". Профили с учётными данными намеренно возвращают передачу secureSetupRequired, потому что ключи API, секреты клиентов, сертификаты и токены никогда не должны попадать в контекст MCP/модели. После защищённой настройки Studio MCP может перечислять, просматривать, обновлять метаданные, проверять, отзывать, инициировать OAuth (включая несекретные значения шаблона connectionConfig) и привязывать непрозрачный ID профиля к интеграциям или MCP-серверам.

Arch Evaluate

Генерация eval-ресурсов, запуск eval-рабочих процессов и чтение свидетельств CI.

Arch Optimize

Проверка пакетов, просмотр видимых компилятору моделей и ведение циклов ремонта.

Arch Debug

Подключение к живым сессиям, трассировка сбоев и просмотр состояния выполнения.

Анализ исторических сеансов

debug_session_history — это явная альтернатива только для чтения, когда сохранённый сеанс необходимо проанализировать после того, как его живой буфер MCP стал недоступен. Он работает одинаково из Codex, Claude и любого совместимого со стандартами MCP-клиента. Сначала подключитесь к нужному Runtime с помощью platform_connect, чтобы существующая bearer-идентификация, рабочее пространство и окружение оставались авторитетными.

Получите первую страницу (значения по умолчанию: 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.