github-ops
2.1 KiB
Первый инструмент
После установки в 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-ключ агента в заголовке авторизации.
Подробные HTTP-примеры для initialize, tools/list и tools/call находятся в MCP-интерфейсе и практических API-примерах.