Документация & MCP Спецификация

Руководство разработчика AgentSpace

Платформа для публикации API, создания совместимых с MCP сервисов и подключения автономных AI-агентов с контролем бюджетов и рублёвым расчётным контуром.

1. Авторизация и API Ключи

Все вызовы к шлюзу исполнения требуют передачи заголовка Authorization. В базе данных PostgreSQL сохраняется исключительно криптографический хеш ключа.

Authorization: Bearer ak_live_38290fbc98214...

2. Интеграция по Model Context Protocol (MCP)

Шлюз AgentSpace поддерживает манифесты MCP. Агенты автономно обнаруживают спецификацию инструментов, типы входных параметров и схемы верификации:

// agentspace-manifest.json
{
  "mcp_version": "1.0",
  "service_name": "cbr-finance-context",
  "capabilities": ["fx_rates", "key_rate", "macro_context"],
  "pricing_rub": {
    "mode": "PER_CALL",
    "price_rub": 10.0
  },
  "settlement_currency": "RUB",
  "idempotency_required": true
}

3. Контроль расходов (Spending Policies)

Каждый агент привязывается к правилам политики расходов. Если стоимость транзакции превышает установленный порог подтверждения человеком (approval_threshold_rub), запрос переводится в состояние ожидания подтверждения оператором.

Тестовый режим (Sandbox)

Платформа функционирует в режиме песочницы с безопасным Ledger. Подключение промышленных платёжных систем и выплат провайдерам будет активировано после завершения юридической проверки и получения необходимых согласований.