Налаштування агента

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

Підключіть API AstroWay до AI-агентів через MCP (Model Context Protocol). Каталог доступний двома способами, обидва з вашими ключами aw_test_* / aw_live_*:

Hosted (HTTP): https://mcp.astroway.info/mcp, без встановлення, автентифікація через Bearer-токен.
Stdio (npx): npx @astroway/mcp, локальний підпроцес, автентифікація через env-змінну, працює офлайн.

Отримайте безкоштовний ключ у дашборді, далі оберіть свій клієнт.

Один домен замість усього каталогу

843 інструменти в одній відповіді це 3.4 МБ, які агент зобов’язаний прочитати, перш ніж вибрати один. Більшість клієнтів здається задовго до цього.

https://mcp.astroway.info/mcp/<домен> віддає один предмет замість усього. Конфіг той самий, змінюється тільки URL.

Домен	URL	Інструментів	Розмір `tools/list`
Ядро астрології	`/mcp/core`	108	458 КБ
Ведична	`/mcp/vedic`	236	1.2 МБ
Китайська метафізика	`/mcp/chinese`	62	212 КБ
Еллінізм і традиція	`/mcp/hellenistic`	83	336 КБ
Таро	`/mcp/tarot`	86	244 КБ
Нумерологія	`/mcp/numerology`	88	253 КБ
Human Design	`/mcp/human-design`	27	122 КБ
Прогностика	`/mcp/forecast`	45	207 КБ
Стосунки	`/mcp/relationships`	45	249 КБ
Психологічна	`/mcp/psychological`	45	165 КБ
Ворожіння й езотерика	`/mcp/divination`	79	195 КБ
Прикладні читання	`/mcp/applied`	47	163 КБ
Звіти	`/mcp/reports`	43	227 КБ
Платформа	`/mcp/platform`	45	132 КБ

Виміряно на проді 2026-11-07.

/mcp і далі віддає весь каталог, тож нічого налаштованого раніше не зламалося. Перевірка балансу й оцінка вартості виклику є в кожному домені, бо агент, обмежений ведичною астрологією, все одно має знати, скільки коштує виклик.

GET /domains повертає цей самий список як JSON, без ключа. Невідомий домен це 404 з переліком справжніх, а не мовчазне повернення всіх 843.

Документація без ключа: `/mcp/docs`

Перше питання агента ніколи не “порахуй карту”. Воно звучить як “що вміє цей API, як виглядає виклик і скільки це мені коштуватиме”. Відповідати на всі три можна без ключа: https://mcp.astroway.info/mcp/docs не витрачає жодного кредиту, тож і авторизації не просить.

Інструмент	Що робить
`find_endpoint`	Шукає серед усіх 770 операцій. Для кожної віддає метод, URL, ціну в кредитах, тариф, обов’язкові поля тіла й посилання на довідку
`search_docs`	Шукає по 281 сторінці посібників, українських і англійських, з переліком розділів кожної
`read_doc`	Віддає одну сторінку як markdown
`list_docs`	Увесь покажчик, згрупований за розділами

Ціну мають 700 із 770 операцій, ще 37 позначені як такі, що відповідають без ключа. Тобто вартість сценарію можна порахувати до того, як з’явився акаунт.

curl https://mcp.astroway.info/mcp/docs \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_endpoint","arguments":{"query":"solar return","limit":2}}}'

read_doc читає тільки ті сторінки, що є в покажчику. Будь-який інший шлях отримує відмову, і запит назовні при цьому не йде.

Просіть менше, ніж уся відповідь

Кожен інструмент приймає два параметри поверх своїх: fields (список шляхів через кому, відносно data) і precision (скільки знаків після коми лишити). Вони йдуть у той самий API, що й через REST, і різниця в токенах не риторична.

Виклик натальної карти через MCP	Байтів
без параметрів, як було до 21.09.2026	91 737
без параметрів, сьогодні	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` плюс `precision: 2`	1 182

Виміряно на проді 2026-09-21. Кредити однакові в усіх чотирьох рядках: платить за різницю той, хто читає відповідь.

Шлях, який не збігся з жодним полем, приходить назад у _fields_unmatched. Список, де не збіглося нічого, це 400 FIELDS_UNKNOWN з переліком, а не порожня відповідь. Повний опис обох параметрів: угоди API.

Оберіть свій клієнт

Claude Desktop Розширення в один клік або конфіг

Claude Code Одна CLI-команда

Cursor Hosted MCP через конфіг

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline npx stdio-пакет

Codex CLI npx stdio-пакет

Чат-застосунки: claude.ai

Ключ не потрібен: застосунок входить у ваш акаунт AstroWay сам.

У claude.ai відкрийте Settings → Connectors → Add custom connector.
Вставте URL https://mcp.astroway.info/mcp, у розділі Authentication виберіть Sign in when needed і натисніть Add.
У чаті ввімкніть конектор (кнопка ”+” → Connectors) і попросіть, наприклад, натальну карту.
На першому виклику застосунок відкриє вхід в AstroWay і сторінку дозволу. Після “Дозволити” виклик виконається.

Сервер віддає список інструментів без входу, тому claude.ai пропонує “No sign-in”. З ним конектор додасться, але кожен виклик отримає 401 без вікна входу.

Виклики списуються з кредитів вашого акаунта, як і з ключем. Підключені застосунки видно на сторінці ключів у кабінеті, там же їх відключають.

CI / raw HTTP

Зовсім без клієнта - hosted-ендпоінт розмовляє JSON-RPC поверх HTTP. Перелік інструментів з Bearer-токеном:

curl https://mcp.astroway.info/mcp \
-H "Authorization: Bearer aw_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Function calling без MCP

Якщо ваш агент говорить мовою function calling від OpenAI чи Anthropic, а не MCP, попросіть в API готові визначення інструментів і передайте їх моделі напряму. Вони генеруються з OpenAPI-документа, тож схема, яку заповнює модель, це та сама схема, яку перевіряє ендпоінт.

curl "https://api.astroway.info/v1/agent/tools?format=openai" \
-H "X-Api-Key: aw_live_YOUR_KEY"

Відповідь має дві половини. tools точно відповідає контракту вендора і не несе нічого нашого, тож його можна класти у виклик моделі як є: зайвий ключ усередині об’єкта інструмента це 400 на їхньому боці. executors каже, як виконати кожен інструмент, і має ті самі ключі, які поверне модель:

{
"tools": [
  { "type": "function", "function": { "name": "astroway_post_chart", "description": "Natal chart...",
    "parameters": { "type": "object", "required": ["date", "time", "latitude", "longitude"], "properties": { "...": {} } } } }
],
"executors": {
  "astroway_post_chart": { "method": "POST", "path": "/v1/chart", "credits": 20, "group": "Core" }
},
"count": 26, "totalMatched": 26, "totalAvailable": 751, "truncated": false
}

Ваш виконавець після цього це п’ять рядків: знайти ім’я в executors, надіслати аргументи моделі як JSON-тіло на цей шлях зі своїм X-Api-Key, повернути відповідь моделі. Жоден інструмент не містить облікових даних, тому цей список безпечно кешувати.

Ви обираєте, що бачить модель. За замовчуванням це курований стартовий набір із 26 інструментів, а не весь каталог: OpenAI обмежує запит 128 функціями, а моделі починають гірше обирати задовго до цієї межі. Звужуйте або розширюйте через select=all, select=group:Vedic, select=paths:/chart,/synastry, фільтруйте всередині через q=, обмежуйте через limit= (максимум 128). Нічого не зникає мовчки: totalMatched і notes кажуть, що лишилося за межами. Додайте format=anthropic, щоб отримати { name, description, input_schema }.

Виклик безкоштовний і не витрачає кредити.

Свій ключ до моделі

На ендпоінтах, де ми генеруємо текст, ви можете платити за токени самі. Два заголовки, або обидва, або жодного:

curl https://api.astroway.info/v1/ai/explain-aspect \
-H "X-Api-Key: aw_live_YOUR_KEY" \
-H "X-Provider: anthropic" \
-H "X-Provider-Key: sk-ant-YOUR_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"planet1":"Saturn","planet2":"Moon","aspectType":"Square"}'

X-Provider це один із openai, anthropic, google, groq, mistral, openrouter, deepseek, together; адреса для кожного зафіксована на нашому боці й ніколи не береться із запиту. X-Provider-Model необов’язковий і перекриває модель за замовчуванням.

Відкату на наш ланцюжок немає. Якщо ваш ключ не спрацював, ви отримаєте статус і повідомлення провайдера, а не відповідь, за яку заплатили ми: мовчазний відкат витрачав би наші токени на запит, який ви вважали своїм, і помітити це було б неможливо.

Такий виклик коштує 5 кредитів замість ціни ендпоінта. Ми все одно рахуємо карту, збираємо промт і проганяємо запобіжники; завершення купили ви.

Ваш ключ ніде не логується, не зберігається і не кешується. Він іде заголовком, бо тіло запиту хешується у два ключі кешу, а наш журнал запитів заголовків не пише взагалі. Помилка провайдера, яка процитувала ваш ключ, редагується до того, як потрапить у наші логи чи вашу відповідь. Виклик із вашим ключем обходить обидва кеші в обидва боки: він ніколи не отримає відповідь, яку зробили ми, і його відповідь ніколи не дістанеться комусь іншому.

Заголовки є у специфікації. Кожен шлях, який їх приймає, оголошує X-Provider, X-Provider-Key і X-Provider-Model у /v1/openapi.json, тож згенерований клієнт підключить їх як будь-який інший параметр, і ця сторінка йому не потрібна. Оголошені вони лише там, де ми справді викликаємо модель: надіслати їх на /chart можна, але нічого не станеться, і ви заплатите звичайну ціну ендпоінта.

Машиночитані специфікації

Бажаєте під’єднати REST API напряму або згодувати специфікацію власному агенту?

AGENTS.md: /AGENTS.md, інструкції для агента (що можна викликати без ключа, контракт запиту, конверт відповіді, заголовки лімітів)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · повний текст /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP, Go, C#

Часті питання

Hosted чи npx? Hosted нічого не потребує встановлювати, і лише він приймає fields і precision. Пакет через npx тримає ключ у локальній змінній оточення і підходить клієнтам, які запускають тільки локальні команди.

Який URL дати клієнту? Домен вашої теми з таблиці вище. На /mcp усі 843 інструменти, і більшість клієнтів читає такий список повільно або обрізає.

Як дізнатися ціну виклику? Опис кожного інструменту закінчується рядком [Cost: ...]. astroway_cost_estimate рахує кілька викликів, не виконуючи їх, а find_endpoint на /mcp/docs відповідає на те саме взагалі без ключа.

Чи можна спробувати, не витрачаючи кредитів? Так, із sandbox-ключем aw_test_* з дашборду.

Навіщо Claude Desktop потрібен mcp-remote? Його конфіг запускає лише локальні команди і пропускає запис із самим url. Блок є на сторінці Claude Desktop.

AstroWay є в MCP Registry? Так: кожен сервер вище є в офіційному реєстрі як info.astroway/*, тож клієнти, що вміють шукати в реєстрі, знаходять його за назвою.