Подключите MCP-клиент и дайте агенту оценивать себя

Один эндпоинт, Streamable HTTP

Сервер говорит на JSON-RPC 2.0 поверх Streamable HTTP на одном эндпоинте. Вызовите tools/list, чтобы узнать инструменты, реально доступные вашему токену, вместо доверия списку, скопированному со страницы вроде этой.

# JSON-RPC 2.0 over Streamable HTTP, one endpoint.
curl -X POST https://api.qannasapi.com/mcp \
  -H "Authorization: Bearer $QANNAS_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

# Trust this over any tool list copied from a page — it reflects
# the scopes your token actually carries.

Создайте токен с ограниченной областью

Токены показываются один раз при создании и несут области только на чтение с запретом по умолчанию. Нет области записи, которую надо было бы придержать: токен может искать и никогда не может изменить, отправить или удалить что-либо. Отзыв мгновенный.

// Any client with a custom-headers field connects today.
{
  "mcpServers": {
    "qannas": {
      "url": "https://api.qannasapi.com/mcp",
      "headers": {
        "Authorization": "Bearer qm_…"
      }
    }
  }
}

// The token is shown once at creation. Store it then.

Заставьте агента сначала оценивать

Инструменты сценариев принимают оценку dry_run, и запрос оценки ничего не стоит. Впишите указание в системный промпт — сначала оценка, затем ожидание подтверждения — чтобы агент предлагал стоимость до того, как что-то потратит.

# Put this in the agent's system prompt.
# A dry_run quote is free, so there is no reason not to.

Before running any QannasAPI workflow tool, call it once with
dry_run: true, show me the credit quote, and wait for my
approval before running it for real.

Знайте, чего в MCP нет

Отслеживание дельты доступно только в REST: since_cursor и track_delta не выведены в MCP. Согласованные поиски контактов тоже только в REST. И вызовы MCP всегда тарифицируются реальными кредитами — режима тестового ключа на этой поверхности нет.

Итоги

Чек-лист перед продакшеном

• Вызывайте tools/list на своём токене вместо жёстко зашитого списка инструментов.
• Впишите «сначала оценка, ждать подтверждения» в системный промпт агента.
• Создавайте по токену на агента, чтобы отзыв одного не мешал остальным.
• Сохраните токен при создании — повторно он не показывается никогда.

Дальше