Как внешние AI-клиенты (клиенты MCP, скрипты, другие инструменты) интегрируются с AITM через серверы MCP и REST/GraphQL API.

AITM MCP & API

Серверы MCP

AITM предоставляет два сервера MCP:

• aitm-core (35 инструментов) — проекты (onboarding, list_projects, get_project_status), CRUD Task (create_task, list_tasks, get_task, update_task, delete_task, search_tasks), жизненный цикл (run_task, stop_task, stop_project_tasks, stop_all_tasks, resume_task, skip_step, requeue_task — деструктивно, archive_task, restore_task, reorder_task), данные Task (get_task_result, get_task_console, get_task_logs, get_pipeline_status), оптимизация промптов (optimize_prompt, apply_optimization), поиск по архиву (search_archive), настройки (get_settings, update_settings), лицензия (license_status, license_activate, license_deactivate, license_upload_offline_token, license_remove_offline_token) и server_restart/server_stop.
• aitm-extended (43 инструмента) — тестовая среда (test_env_status, test_app_build, test_app_start, test_app_stop, test_project_pull, get_test_history), скриншоты (get_screenshot_manifest, get_screenshot, get_screenshot_history), Contracts (search_contracts, get_contract_detail, get_module_summary, find_precedent_tasks, get_danger_zones, investigate_variable, blast_radius, context_for, contracts_health, contracts_resync), документация и переменные (search_docs, get_docs_for_variable, get_behavior_chain, search_variables, get_variable_tree, get_dom_page, search_dom), самопроверка (run_selfcheck) и резервное копирование (create_backup), диалоги (list_conversations, get_conversation, delete_conversation), сообщения Chat/Brainstorm (send_chat_message, send_brainstorm_message), Skills (list_skills, skill_create, skill_list, skill_search, skill_get, skill_update, skill_delete), Merge queue (get_merge_queue), resolve_conflict и состояние сервисов (get_service_health).

Транспорты: stdio (локальный, по умолчанию для обоих серверов) и Streamable HTTP на порту 3335 (по умолчанию, переопределяется через --mcp-port) с обязательным bearer-токеном (AITM_MCP_TOKEN или config.mcp.httpAuthToken, fail-closed — сервер отказывается запускаться в режиме HTTP без него) и необязательным TLS (--tls-cert/--tls-key). В стандартном .mcp.json этого репозитория (stdio) зарегистрирован только aitm-core; aitm-extended запускается отдельно (при необходимости с --http).

Пример: подключение клиента MCP (stdio)

{
  "mcpServers": {
    "aitm-core": {
      "command": "npx",
      "args": ["tsx", "src/mcp/AitmCoreMcpServer.ts", "--rest-url", "http://localhost:3333"]
    }
  }
}

Пример: удалённый клиент MCP (HTTP)

{
  "mcpServers": {
    "aitm-core-remote": {
      "url": "https://your-host:3335",
      "headers": { "Authorization": "Bearer <AITM_MCP_TOKEN>" }
    }
  }
}

REST API

База http://localhost:3333, JSON. Порты: 3333 REST/GraphQL/UI, 3334 HTTPS, 3335 MCP Streamable HTTP.

Это отобранный набор наиболее используемых endpoint'ов, а не полный список — у REST API более 100 endpoint'ов в src/rest/RestApi.ts и отдельных маршрутизаторах (Skills, Contracts, теги DOM, i18n, скриншоты, тестовая инфраструктура, релизы и другие).

Справочник параметров — наиболее используемые операции

Пример: создание Task

curl -X POST http://localhost:3333/api/tasks \
  -H 'Content-Type: application/json' \
  -d '{"title":"Fix auth bug","prompt":"READ CLAUDE.md first...","tabId":"ctm","projectId":"ctm-dashboard","priority":"high","useWorktree":true,"usePipeline":true,"autoMergeDev":true}'

Примечание: title не более 60 символов, prompt не более 50 КБ; значения по умолчанию useWorktree/usePipeline/autoMergeDev равны true, priority по умолчанию — medium.

Пример: цепочка зависимых Task

curl -X POST http://localhost:3333/api/tasks/chain \
  -H 'Content-Type: application/json' \
  -d '[
    {"title":"Add DB column","prompt":"...","tabId":"ctm","projectId":"ctm-dashboard"},
    {"title":"Use column in API","prompt":"...","tabId":"ctm","projectId":"ctm-dashboard"}
  ]'

Второй Task ждёт, пока первый не будет влит в dev, поскольку каждый последующий элемент автоматически получает dependsOn:[previous id].

Пример: остановка и возобновление Task

curl -X POST http://localhost:3333/api/tasks/42/stop \
  -H 'Content-Type: application/json' -d '{"reason":"manual stop"}'

curl -X POST http://localhost:3333/api/tasks/42/resume \
  -H 'Content-Type: application/json' -d '{}'