Pripoj svoj Ultrahuman Ring k Claude

Tento MCP server umožňuje Claude pristupovať k dátam z tvojho Ultrahuman prsteňa — spánok, HRV, recovery, kroky a ďalšie.

Ako to funguje?

1. Zaregistruj sa s emailom z tvojho Ultrahuman účtu

2. Požiadaj Ultrahuman o API token (stačí email na support@ultrahuman.com) a zadaj ho v Dashboarde

3. Skopíruj svoju osobnú MCP URL do Claude.ai → Settings → Connectors

Ako získať API token · GDPR · Podmienky používania

Ako sa potom môžeš pýtať Claude?

Otázky píš prirodzene — Claude automaticky vyberie správny nástroj.

Ranný check-in
Ako som dnes na tom?
Ako som sa dnes v noci vyspal?
Tréning
Mám dnes ísť tvrdo cvičiť?
Som dostatočne zotavený na dlhý beh?
Trendy a porovnania
Ukáž mi trend recovery za posledných 7 dní
Zlepšilo sa moje VO2 Max za posledný mesiac?
Špecifické situácie
Pil som včera víno — ako to ovplyvnilo môj spánok?
Necítim sa dobre, zisti niečo z dát

Viac príkladov a kompletný popis funkcií nájdeš v Dokumentácii.

Registrácia nového účtu

Vytvorte si účet pre prístup k Ultrahuman MCP serveru.

⚠ Musí to byť emailová adresa vášho osobného konta na ultrahuman.com!

Prihlásenie

Zadajte emailovú adresu a pošleme vám prihlasovací link.

Tvoja MCP URL

Túto URL vlož do Claude.ai → Settings → Connectors → Add custom connector

Načítavam...

Ultrahuman Auth Token

Váš osobný API token pre prístup k Ultrahuman dátam. Token je šifrovaný a nikto iný ho nevidí.

Načítavam...

Token získate bezplatne emailom na support@ultrahuman.com. Ukáž mi ako →

Návod na pripojenie

1. Skopírujte MCP URL vyššie

2. V Claude.ai kliknite na profil → Settings → Connectors

3. Kliknite "Add custom connector" a vložte URL

4. V novom chate zapnite connector cez tlačidlo "+" → Connectors

Správa používateľov

Email Rola Stav Registrácia Akcia
Načítavam...

1. Ako sa pýtať Claude na vaše dáta

Po pripojení MCP connectora v Claude.ai môžete Claude klásť otázky v prirodzenej reči. Claude sám rozhodne, ktorý MCP nástroj použije. Tu je niekoľko osvedčených otázok, roztriedených podľa scenára.

Ranný check-in
Ako som dnes na tom?
Aké je moje recovery dnes?
Ako som sa dnes v noci vyspal?
Tréning a aktivita
Mám dnes ísť tvrdo cvičiť?
Som dostatočne zotavený na dlhý beh?
Mám zajtra polmaratón — som na neho pripravený?
HRV a stres
Môj HRV je dnes 38 — je to v poriadku?
Ako sa mi vyvíja HRV za posledný týždeň?
Trendy a porovnania
Ukáž mi trend recovery za posledných 7 dní
Porovnaj môj spánok minulý týždeň s tento týždňom
Zlepšilo sa moje VO2 Max za posledný mesiac?
Špecifické situácie
Pil som včera víno — ako to ovplyvnilo môj spánok?
Necítim sa dobre, zisti niečo z dát
Letel som cez 6 časových pásiem — koľko dní mi trvalo sa zotaviť?
Glukóza (pre Ultrahuman M1 CGM)
Aká bola moja priemerná glukóza včera?
Kedy som mal najvyšší glukózový spike?
Tip Claude rozumie aj neformálnym otázkam typu „no tak čo, ako mi to išlo?" alebo „fakt sa necítim dobre, pozri sa na to". Nemusíte sa držať presných formuliek.

2. Ako funguje MCP server

Čo je MCP?

Model Context Protocol (MCP) je otvorený štandard od Anthropic, ktorý umožňuje AI modelom ako Claude pripojiť sa k externým nástrojom a dátovým zdrojom. Fungue ako univerzálny konektor — podobne ako USB-C, ale pre AI.

Čo robí tento MCP server?

Tento server pôsobí ako bezpečný sprostredkovateľ medzi Claude a Ultrahuman Partner API. Keď sa v Claude spýtate na svoje dáta:

1
Claude zavolá váš osobný MCP endpoint (URL vo formáte /api/mcp/[váš-token])
2
Server overí váš token, dešifruje váš Ultrahuman API kľúč a pošle požiadavku na Ultrahuman
3
Ultrahuman API vráti všetky vaše metriky pre požadovaný dátum
4
Server vyfiltruje relevantnú časť odpovede a pošle ju späť do Claude, ktorý vám ju zrozumiteľne interpretuje

Oficiálne Ultrahuman API

Tento MCP server používa oficiálne Ultrahuman Partner API. Dokumentáciu nájdete tu:

API používa jediný endpoint: GET https://partner.ultrahuman.com/api/v1/metrics?email=...&date=YYYY-MM-DD s autorizačným kľúčom v HTTP hlavičke. Vracia kompletné dáta pre daný dátum v jednej odpovedi.

Bezpečnosť

Váš Ultrahuman API token je v databáze uložený šifrovane (AES-256-GCM). Nikto — ani správca systému — ho nevidí v čitateľnej forme. Pri každom volaní sa token dešifruje len v pamäti servera na dobu potrebnú na zavolanie Ultrahuman API.

Vaša MCP URL obsahuje 48-znakový náhodný token. Ktokoľvek, kto by tento URL získal, by mohol čítať vaše Ultrahuman dáta — preto ju nezdieľajte.

3. Ako získať Ultrahuman API token

Ultrahuman Partner API je k dispozícii bezplatne na vyžiadanie. Postup je jednoduchý:

1
Pošlite email na support@ultrahuman.com
Alternatívne môžete použiť aj chat podpory priamo v Ultrahuman mobilnej aplikácii (Profile → Support).
2
V emaile požiadajte o API Authorization Key a Partner ID. Nezabudnite uviesť email, ktorý používate pre Ultrahuman konto — urýchli to spracovanie žiadosti.
3
Po obdržaní odpovede otvorte Ultrahuman mobilnú aplikáciu → záložka Profile → ikona nastavení (ozubené koliesko) vľavo hore → nájdite Partner ID a zadajte ho
4
Zadaný API Authorization Key skopírujte a vložte do poľa „Nový token" v Dashboarde tejto aplikácie

Vzorový email pre Ultrahuman (anglický)

Skopírujte a upravte podľa seba — nahraďte žlté polia svojimi údajmi:

Otvoriť v emailovom klientovi
Poznámka k Partner ID Partner ID zadáte priamo v Ultrahuman mobilnej aplikácii (Profile → Settings → Partner ID). Tento krok dáva spoločnosti Ultrahuman súhlas, aby mohla sprístupňovať vaše dáta cez Partner API. Bez neho API volania vrátia chybu aj napriek platnému tokenu.
Ako dlho platí token? Podľa oficiálnej dokumentácie platí access token približne 1 týždeň. V prípade exspirácie alebo problémov s prístupom kontaktujte Ultrahuman podporu znova.

4. Čo obsahuje MCP server

Server sprístupňuje Claude 11 nástrojov (tools). Claude ich volá automaticky na základe vašej otázky — nemusíte ich volať manuálne.

Nástroj Čo vracia
get_all_metrics Kompletné dáta za daný deň — všetky metriky naraz
get_sleep Spánok: skóre, fázy (hlboký/ľahký/REM/prebúdzanie), efektivita, graf HR/HRV počas spánku, AI insights
get_heart_rate Tepová frekvencia: priebeh počas dňa, pokojový tep v noci (night_rhr)
get_hrv Heart Rate Variability — denný priebeh a priemer
get_steps Kroky — priebeh a denný priemer
get_temperature Teplota kože počas spánku v °C
get_recovery Recovery Score (0–10) a Recovery Index (0–100)
get_movement Pohyb a Movement Index (0–100)
get_vo2max Odhad VO2 Max (kardiorespiračná zdatnosť)
get_glucose Glukóza, metabolický skóre, HbA1c, time in target (vyžaduje Ultrahuman M1 CGM)
get_date_range Všetky metriky za rozsah dátumov (max 14 dní) — pre trendy a porovnania
Optimalizácia Server má zabudovaný 60-sekundový cache. Ak sa Claude v rámci jednej otázky pýta na viacero metrík za rovnaký dátum (napr. get_sleep + get_hrv), Ultrahuman API sa zavolá len raz.

5. Skill pre interpretáciu dát

Čo je Claude Skill?

Skill je balík inštrukcií, ktorý Claude načíta, keď sa mu zíde — v tomto prípade pri otázkach o zdravotných dátach. MCP server poskytuje dáta, skill poskytuje know-how, ako ich interpretovať.

Bez skillu Claude interpretuje Ultrahuman dáta na základe všeobecných znalostí. So skillom má konzistentnejšie odporúčania, pozná typické prahy pre HRV/RHR, vie používať workflow šablóny a dodržiava bezpečnostné pravidlá (nediagnostikuje, pri extrémoch odporúča lekára).

Čo obsahuje skill ultrahuman-interpretation?

SKILL.md (hlavný súbor)

  • Kľúčový princíp: osobná baseline prevažuje nad absolútnymi hodnotami
  • Prehľad metrík a ich typov v API odpovedi
  • Bezpečnostné pravidlá (nediagnostikovať, neprepísať lieky, neradiť extrémne intervencie)
  • 5 hlavných workflow šablón: ranný check-in, tréningové rozhodovanie, sleep review, weekly review, detekcia choroby

references/metrics-guide.md

  • Detailné interpretačné rozsahy pre každú metriku
  • Typické hodnoty podľa veku a fitness úrovne
  • VO2 Max tabuľka podľa veku a pohlavia
  • Výklad jednotlivých komponentov v sleep summary

references/safety.md

  • Red-flag vzory (akútna choroba, overtraining, spánková porucha, metabolická dysfunkcia)
  • Zoznam čo povedať a čo nehovoriť
  • Pravidlá pre tehotenstvo a citlivé situácie
  • Ako reagovať, keď dáta protirečia pocitu používateľa

references/workflows.md

  • Rozšírené scenáre: kontrola po alkohole, jetlag, menštruačný cyklus
  • Training load review, pred-súťažný taper
  • Nový používateľ, dlhodobé trendy
  • Interpretácia glukózových dát

Inštalácia skillu do Claude.ai

1
Stiahnite súbor ultrahuman-interpretation.skill.
2
V Claude.ai kliknite na ikonu profilu → Settings
3
V bočnom menu nájdite Capabilities → Skills (alebo priamo Skills, podľa verzie)
4
Kliknite Upload skill a nahrajte stiahnutý .skill súbor
5
Hotovo. Skill sa aktivuje automaticky, keď sa pýtate na Ultrahuman dáta — nemusíte ho manuálne zapínať

Ako sa skill používa?

Skill funguje v pozadí. Keď napíšete otázku, ktorá spadá do jeho oblasti (spánok, recovery, HRV, tréningové rozhodnutia), Claude:

  1. Zavolá príslušný MCP nástroj (napr. get_sleep)
  2. Načíta skill inštrukcie
  3. Ak je otázka zložitá, načíta aj relevantný reference súbor (napr. metrics-guide.md)
  4. Interpretuje dáta podľa pravidiel skillu a odpovie vám

Výsledok: namiesto generických textov dostanete konkrétne čísla, porovnania s vašou baseline a konkrétne odporúčanie.

Úprava skillu podľa vlastných potrieb

Skill je len obyčajný ZIP archív s Markdown súbormi. Môžete si ho prispôsobiť:

1
Premenujte súbor z .skill na .zip a rozbaľte
2
Upravte obsah podľa potreby — môžete napríklad:
  • Zmeniť tón (viac formálny / uvoľnenejší)
  • Pridať vlastné trénerské inštrukcie do workflows.md
  • Upraviť interpretačné rozsahy v metrics-guide.md podľa vašich špecifík (napr. ak ste extrémny športovec a bežné rozsahy nesedia)
  • Rozšíriť bezpečnostné pravidlá v safety.md
3
Zbalte späť do ZIP archívu — dôležité: adresár ultrahuman-interpretation/ musí byť v koreni ZIP-u
4
Premenujte späť na .skill a nainštalujte podľa krokov vyššie (pôvodnú verziu predtým odstráňte)
Poznámka pre vývojárov Štruktúra skillu musí zachovať YAML frontmatter v SKILL.md (name a description). Popis (description) rozhoduje o tom, kedy sa skill spustí — ak ho zmeníte príliš úzko, skill sa nemusí aktivovať pri relevantných otázkach.

Obmedzenia

  • Skill je potrebné nainštalovať individuálne v každom Claude účte — nedá sa zdieľať cez MCP server
  • Skill beží len v Claude.ai (web, desktop, mobile) — nie v Claude API pokiaľ nie je volaný cez Skills v API
  • Interpretácia je orientačná — nenahrádza lekársku konzultáciu