a↗angels.BETA
DEVELOPER DOCUMENTATION

Один MCP.
Весь каталог Angels.

Подключите Angels к клиенту с поддержкой удалённого MCP по Streamable HTTP и заголовков авторизации.

1. Создайте ключ

Войдите в рабочее пространство, откройте «API ключи» и создайте ключ для вашего агента. Сохраните его в секретах приложения.

Открыть API ключи

2. Подключите общий MCP

{
  "mcpServers": {
    "angels": {
      "url": "https://mcp.angls.ru/mcp",
      "headers": {
        "Authorization": "Bearer <ANGELS_API_KEY>"
      }
    }
  }
}

Формат конфигурационного файла зависит от клиента. Endpoint и заголовок остаются такими же.

3. Найдите сервис и вызовите инструмент

  1. search_services — описание задачи, категории, география и возможности.
  2. get_service — карточка сервиса и адрес полного прокси.
  3. list_service_tools — точные схемы и schema_revision.
  4. invoke_tool — вызов с ID сервиса, названием инструмента, аргументами и ревизией.
{
  "service_id": "<SERVICE_UUID>",
  "tool_name": "search_products",
  "schema_revision": "<REVISION_UUID>",
  "arguments": {
    "query": "headphones"
  }
}

Полный MCP-прокси

Для ресурсов, промптов, подписок и интерактивных сценариев добавьте отдельный MCP с адресом:

https://mcp.angls.ru/mcp/services/<SERVICE_UUID>

Используйте тот же ключ Angels. При необходимости сохраните собственный ключ внешнего сервиса в разделе «Подключения».

Версии и ограничения

Поддерживаем Streamable HTTP: 2025-03-26, 2025-06-18, 2025-11-25 и 2026-07-28. Сервисный прокси передаёт согласованный протокол без преобразования несовместимых возможностей. OAuth, отдельный старый HTTP+SSE transport, stdio, Apps и Tasks в MVP не подключаются.

По умолчанию: 60 запросов в минуту и 10 одновременных операций на ключ. Обычный вызов ограничен 60 секундами.

Если результат неизвестен

При ошибке OUTCOME_UNKNOWN операция могла выполниться во внешнем сервисе. Не повторяйте покупку, запись или другое действие автоматически. Сначала проверьте результат в самом сервисе.