Підключення до Fealthy MCP

Fealthy MCP — stateless MCP Streamable HTTP, JSON-RPC 2.0, на одному ендпоінті:

POST https://main.api.fealthy.dev/v1/mcp

Будь-який інший метод на цьому шляху (GET, PUT, PATCH, DELETE) повертає 405 Method Not Allowed. Авторизація — заголовок Authorization: Bearer <персональний токен>. Це не той самий токен, яким ви входите в застосунок: він діє лише на цьому ендпоінті, а GraphQL застосунку його не приймає.

Токен доступу

Окремого екрана видачі токенів у застосунку поки немає — токен видає команда Fealthy на запит.

Токен буває одного з двох рівнів:

• Write — усі 70 інструментів, читання й зміни;
• Read — лише list_*/get_* (29 інструментів); викликати інструмент запису з таким токеном не вийде.

Технічно API дозволяє строк дії від 1 години до 365 днів, до 5 активних токенів одночасно. Токен показується один раз у момент видачі — зберігайте його як пароль і не вставляйте в код, що комітиться. Якщо він більше не потрібен або міг потрапити в чужі руки — попросіть команду відкликати його; подробиці на сторінці Безпека.

Claude Code

Додайте сервер однією командою:

claude mcp add -s user -t http fealthy https://main.api.fealthy.dev/v1/mcp -H "Authorization: Bearer fpat_ваш_токен" -H "app-timezone: Europe/Kyiv"

Прапорець -s user записує сервер у ваш особистий ~/.claude.json (він локальний для машини, не в репозиторії). Заголовок app-timezone — це IANA-назва вашого часового поясу (наприклад, Europe/Kyiv); він потрібен, якщо у профілі Fealthy часовий пояс ще не вказано.

Перевірте підключення:

claude mcp list

Ви маєте побачити рядок на кшталт fealthy: … (HTTP) - ✔ Connected.

Відкрийте нову сесію Claude Code. Сервер, доданий посеред уже запущеної сесії, їй не видно — команда /mcp покаже інструменти лише в сесії, запущеній після claude mcp add. У новій сесії /mcp покаже список інструментів: 70 для токена рівня Write, 29 — для Read.

Claude Desktop (через mcp-remote)

Claude Desktop поки не вміє підключатися до Streamable HTTP з довільними заголовками напряму, тому місток — пакет mcp-remote. У claude_desktop_config.json:

{
  "mcpServers": {
    "fealthy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://main.api.fealthy.dev/v1/mcp",
        "--header",
        "Authorization: Bearer fpat_ваш_токен",
        "--header",
        "app-timezone: Europe/Kyiv"
      ]
    }
  }
}

Після збереження файлу перезапустіть Claude Desktop.

Інші клієнти

Підійде будь-який MCP-клієнт, що підтримує транспорт Streamable HTTP і дозволяє задати власні заголовки запиту. Потрібно вказати клієнту три речі: URL ендпоінту, заголовок Authorization: Bearer <токен> і, за бажання, заголовок app-timezone.

Для розробників

Мінімальний хендшейк без жодного клієнта — двома запитами curl. Обидва POST, з Content-Type: application/json і Accept: application/json, text/event-stream (сервер завжди відповідає одним JSON-обʼєктом, а не потоком подій, — але заголовок Accept очікує сам протокол MCP).

initialize:

curl -s https://main.api.fealthy.dev/v1/mcp \
  -H "Authorization: Bearer fpat_ваш_токен" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "curl-example", "version": "1.0.0" }
    }
  }'

Сервер приймає три значення protocolVersion: 2025-11-25, 2025-06-18 і 2025-03-26; для будь-якого невідомого відповідає своєю найновішою версією, а не помилкою. У відповіді на initialize — інструкції, які сервер дає агенту (їх опис на сторінці Безпека).

tools/list (після хендшейку клієнти зазвичай додають заголовок mcp-protocol-version із версією з відповіді на initialize; для будь-якого запиту, крім самого initialize, невідоме чи непідтримуване значення цього заголовка — це 400):

curl -s https://main.api.fealthy.dev/v1/mcp \
  -H "Authorization: Bearer fpat_ваш_токен" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-protocol-version: 2025-06-18" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

Кількість інструментів у відповіді залежить від рівня токена: 70 для Write, 29 для Read.

Перевірка підключення

• claude mcp list (або еквівалент вашого клієнта) показує статус ✔ Connected.
• /mcp у новій сесії або сирий виклик tools/list повертає очікувану кількість інструментів для рівня вашого токена.
• Простий запит на кшталт «покажи мої рахунки» відпрацьовує без помилок.

Типові помилки