start_here

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

Call this FIRST. Returns the ordered plan + the capability version of the read surface.

Pass your cached serverInfo.version as last_seen_version: if the surface changed, changed is true and whats_new lists what to adopt (new endpoints/fields) BEFORE you act. On a first connect (no cached version) whats_new is the full changelog. Cache the returned capability_version for next time.

Доступ: только чтение — безопасно вызывать повторно, ничего не меняет

Доступен на: /mcp/, /mcp/readonly/

Подсказки, объявленные MCP-клиентам (ToolAnnotations)

Подсказка	Значение
`readOnlyHint`	true
`destructiveHint`	false
`idempotentHint`	true
`openWorldHint`	false

Параметры

Имя	Тип	Обязателен	Описание
`last_seen_version`	`string \| null`	нет	Capability version you cached from a previous connect (serverInfo.version); omit on first use

Пример вызова

Отправляется внутри инициализированной MCP-сессии (см. Подключение). Каждый параметр показан типизированной заглушкой; необязательные можно опустить — но для инструментов дефектов/задач именно QA-поля спасают отчёт от карантина.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "start_here",
    "arguments": {
      "last_seen_version": "<last_seen_version>"
    }
  }
}

Возвращает

Поле	Тип	Описание
`capability_version`	`string`	Current version of the agent read surface
`you_last_seen`	`string \| null`	The version you passed in, echoed back
`changed`	`boolean`	True iff you passed a version and it differs from the current one
`whats_new`	`массив object`	Changelog entries newer than your version (all of them on a first connect)
`whats_new[].version`	`string`	Capability version of this entry (date-anchored, monotonic)
`whats_new[].added`	`массив string`	New endpoints, tools or fields a consumer can adopt
`whats_new[].changed`	`массив string`	Semantics that changed for a consumer
`whats_new[].deprecated`	`массив string`	What is going away and what replaces it
`read_first`	`string \| null`	Resource to read before acting when there is anything to adopt
`plan`	`string`	Ordered bootstrap plan for using the platform
`docs`	`object`	Public documentation entry points
`docs.portal`	`string`	Developer documentation portal (HTML entry)
`docs.llms`	`string`	Curated Markdown index of the portal (llms.txt)
`docs.sections`	`string`	Where the per-section map lives (MCP resource URI)
`docs.note`	`string`	How to use the portal on a user’s behalf

Если не работает

Симптом	Причина	Действие
`401`	Токен отсутствует или истёк	Токены выпускает владелец платформы через `POST /api/v1/auth/agent-token` (только суперпользователь) — попросите перевыпуск. ⚠️ Новый токен заменяет набор грантов
`403` / ошибка capability	У токена нет capability или гранта на контракт	Сначала `my_capabilities`; грант запрашивается у владельца