# Dify

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

## Спосіб 1. Hosted MCP

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

Сервер усього каталогу, https://mcp.astroway.info/mcp, несе 843 інструментів, і їхні описи разом займають 3.4 МБ: забагато, щоб давати моделі в кожному кроці. Підключайте доменний сервер під задачу. Повний список із описами на [mcp.astroway.info/domains](https://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` або вставте [її вміст](/integrations/dify-astroway-openapi.json). Dify покаже дві дії: `dailyHoroscope` і `moonPhase`.
3. В авторизації інструмента виберіть API Key у заголовку, назва заголовка `X-Api-Key`, значення ваш ключ **Тільки сервер** з областю `public/horoscope/*` і `public/moon-phase`.
4. Перевірте дію `dailyHoroscope` з `sign=leo` кнопкою тесту.

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

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

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