Dify

Оновлено 6 лист. 2026 р. Відкрити як Markdown Налаштування агента

Dify дає агентам і workflow два шляхи до AstroWay. MCP підтягує готові інструменти з описами й схемами, тож агентові нічого не треба пояснювати. Swagger API будує інструмент із невеликої схеми OpenAPI, коли потрібні один-два конкретні виклики й повний контроль над тим, що бачить модель.

Спосіб 1. Hosted MCP

Який сервер підключати

Сервер усього каталогу, https://mcp.astroway.info/mcp, несе 843 інструментів, і їхні описи разом займають 3.4 МБ: забагато, щоб давати моделі в кожному кроці. Підключайте доменний сервер під задачу. Повний список із описами на mcp.astroway.info/domains, наприклад:

Задача	URL
Натальна карта, гороскопи, фаза Місяця	`https://mcp.astroway.info/mcp/core`
Ведична астрологія і Васту	`https://mcp.astroway.info/mcp/vedic`
Таро	`https://mcp.astroway.info/mcp/tarot`
Human Design	`https://mcp.astroway.info/mcp/human-design`
Пошук по документації, без ключа	`https://mcp.astroway.info/mcp/docs`

Підключення

Integrations → Tools → MCP → Add MCP Server (HTTP).
Server URL: адреса з таблиці, Name: AstroWay core, Server Identifier: astroway-core. Застосунки посилаються на сервер саме за ідентифікатором, тож не змінюйте його потім.
Автентифікація, один із двох варіантів:
- OAuth (за замовчуванням). Залиште Dynamic Client Registration увімкненим. Dify сам зареєструється на нашому сервері авторизації й відкриє вікно входу в AstroWay; виклики списуються з кредитів акаунта, який дозволив доступ.
- Ключ. Вимкніть Dynamic Client Registration і в Advanced Options → Custom Headers додайте Authorization зі значенням Bearer aw_live_.... Ключ має бути Тільки сервер: Dify ходить зі своїх серверів. MCP-сервер приймає ключ лише в Authorization: Bearer, заголовок X-Api-Key тут дає 401.
Збережіть. Dify імпортує інструменти, і в агенті чи вузлі Agent можна вибрати лише потрібні, наприклад astroway_western_chart і astroway_calendar_moon_phase.

Кожен інструмент у своєму описі має рядок [Cost: ...] з ціною в кредитах, і модель бачить його до виклику. Інструменти з позначкою Heavy або Premium варто дозволяти агентові лише з підтвердженням користувача.

Спосіб 2. HTTP-інструмент зі схеми OpenAPI

Повна специфікація API занадто велика для інструмента, тому ми зробили мінімальну схему на два ендпоінти, які кредитів не витрачають: гороскоп знака на сьогодні і фаза Місяця.

Integrations → Tools → Swagger API → Create.
Імпортуйте схему за URL https://api.astroway.info/integrations/dify-astroway-openapi.json або вставте її вміст. Dify покаже дві дії: dailyHoroscope і moonPhase.
В авторизації інструмента виберіть API Key у заголовку, назва заголовка X-Api-Key, значення ваш ключ Тільки сервер з областю public/horoscope/* і public/moon-phase.
Перевірте дію dailyHoroscope з sign=leo кнопкою тесту.

Щоб додати інший ендпоінт, допишіть його в схему: шлях і параметри є на сторінці ендпоінта в довіднику API. Для натальної карти передавайте ?fields= з потрібними полями, інакше модель отримає десятки кілобайт: /v1/chart?fields=planets.name,planets.longitude,houses.ascendant повертає близько півкілобайта.