Dify

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

Підключення

1. Integrations → Tools → MCP → Add MCP Server (HTTP).
2. Server URL: адреса з таблиці, Name: AstroWay core, Server Identifier: astroway-core. Застосунки посилаються на сервер саме за ідентифікатором, тож не змінюйте його потім.
3. Автентифікація, один із двох варіантів:
   • 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.
4. Збережіть. Dify імпортує інструменти, і в агенті чи вузлі Agent можна вибрати лише потрібні, наприклад astroway_western_chart і astroway_calendar_moon_phase.

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

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

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

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

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

Chú ý

Ключ Free на /v1/public/* рахується в той самий ліміт, що й запит без ключа: 30 запитів на годину з IP. Dify Cloud ходить з адрес, спільних для багатьох клієнтів, тож для інструмента на публічних ендпоінтах у Dify Cloud потрібен ключ платного тарифу або self-hosted Dify. Неправильний ключ тут не дає 401, а мовчки отримує анонімний ліміт.

Ghi chú

Перевірено 2026-11-07 проти продакшену: MCP-сервер /mcp/core прийняв ключ в Authorization: Bearer і виконав astroway_calendar_moon_phase, відповів 401 з WWW-Authenticate без входу і 401 на ключ у X-Api-Key; схема OpenAPI пройшла валідацію, а обидва описані в ній запити повернули 200. Кроки в інтерфейсі Dify написані за його документацією і в цій перевірці не виконувалися.