crank/docs/quickstart.md

Первый инструмент

После установки в Crank уже есть демо-пример Frankfurter. Он показывает полный путь от REST endpoint-а до MCP-инструмента.

1. Откройте операции

Перейдите в раздел Операции. В списке должна быть операция:

frankfurter_latest_rate

Она вызывает публичный API:

GET https://api.frankfurter.dev/v1/latest

Входные параметры:

{
  "base": "USD",
  "quote": "EUR"
}

Crank преобразует их в query-параметры:

base=USD&symbols=EUR

2. Проверьте операцию

Откройте операцию и перейдите к тестированию. Используйте пример:

{
  "base": "USD",
  "quote": "EUR"
}

Успешный ответ Frankfurter выглядит так:

{
  "amount": 1.0,
  "base": "USD",
  "date": "2026-06-19",
  "rates": {
    "EUR": 0.87207
  }
}

3. Откройте агента

Перейдите в раздел Агенты. Демо создает агента:

currency-rates

Этот агент публикует только инструмент frankfurter_latest_rate.

4. Создайте API-ключ

Перейдите в раздел API ключи, выберите агента currency-rates и создайте ключ. Полное значение ключа показывается только один раз.

5. Подключите MCP-клиент

MCP endpoint агента имеет вид:

https://your-crank-host/mcp/v1/default/currency-rates

Клиент должен передавать API-ключ агента в заголовке авторизации.