Подключение по MCP

Удалённый MCP-сервер: Streamable HTTP, только чтение, ответы детерминированы. На время беты — без ключа и регистрации.

https://agile-today.org/api/mcp

Настройка

Добавьте адрес в своём клиенте — агент увидит 8 инструментов и три готовых промпта.

Claude

Настройки → Коннекторы → Добавить свой коннектор → вставьте адрес.

URL
https://agile-today.org/api/mcp

Claude Code

Одна команда в терминале:

Терминал
claude mcp add --transport http agile-today https://agile-today.org/api/mcp

Cursor и другие клиенты

Добавьте сервер в конфигурацию MCP (например, .cursor/mcp.json):

mcp.json
{
  "mcpServers": {
    "agile-today": {
      "url": "https://agile-today.org/api/mcp"
    }
  }
}

VS Code

Добавьте сервер в .vscode/mcp.json или командой «MCP: Add Server»:

.vscode/mcp.json
{
  "servers": {
    "agile-today": {
      "type": "http",
      "url": "https://agile-today.org/api/mcp"
    }
  }
}

Инструменты

Все инструменты помечены readOnlyHint. Обычный порядок вызовов:

  1. list_context
  2. plan_project
  3. check_gate
  4. validate_plan
list_context

Вызывается первым: измерения контекста, флаги, этапы, гейты, старшинство исходов.

plan_project

Маршрут для заданного контекста. По умолчанию — компактно (около 6–10 тыс. знаков); по запросу — один этап подробно.

check_gate

Вердикт по гейту: сработавшее правило, вопросы и хэш квитанции.

when_to_use

Подходит ли элемент в этом контексте, насколько и почему; антипаттерны отмечаются.

check_mix

Антипаттерны, конфликты, избыточные альтернативы и недостающие входные данные в наборе.

validate_plan

Порядок и типы шагов, момент заключения договора и антипаттерны в упорядоченном плане.

search_graph

Поиск на английском и русском, устойчивый к опечаткам.

explain_node

Узел со всеми связями и их id (Lxxxx) для цитирования.

Готовые промпты: plan-project, run-gate, review-plan.

Подробности

Формат ответа

Все инструменты отвечают в едином формате — конверте. При ошибке data = null, а в errors — поле, сообщение и did_you_mean.

{
  "graph_version": "2.3.1",
  "content_hash": "43a51781ec9202f0",
  "lang": "en",
  "context": {
    "dom": "software",
    "ap": "hybrid",
    "…": "…"
  },
  "data": {
    "…": "…"
  },
  "warnings": [],
  "errors": []
}
Версии и квитанции

Граф версионируется по SemVer. Мажорная версия — меняются требования гейтов или условия, минорная — новые узлы и связи, патч — формулировки. Идентификаторы связей стабильны, удалённые не используются повторно. check_gate возвращает хэш входных данных: те же входные данные на той же версии дают тот же вердикт.

Разумное использование

Бета бесплатна для людей и агентов. Описательный слой графа открыт по лицензии CC BY 4.0, поэтому собирать его перебором запросов не нужно: скачайте /api/graph или репозиторий agile-today-graph на GitHub. Для агентов: llms.txt.