Ako pripojiť AI asistenta (MCP)
AI asistenti ako Claude, ChatGPT, Cursor alebo Copilot vo VS Code sa cez MCP (Model Context Protocol) pripoja k vašim Node.js aplikáciám a webom. Opýtate sa ich napríklad, prečo aplikácia nefunguje alebo koľko berie pamäte, a odpoveď si zistia priamo z hostingu.
Čo asistent vie
- Čítanie: zoznam aplikácií a webov, ich stav a adresy, logy, využitie pamäte a CPU, história a výsledok nasadení a názvy premenných prostredia, nikdy ich hodnoty.
- Nasadenie: nasadiť najnovší commit z Gitu, reštartovať, zastaviť a spustiť aplikáciu.
- Databáza: spustiť dopyt SQL v databáze aplikácie, čítanie aj zápis.
Čo z toho smie, určíte pri pripojení. Na začiatok odporúčame len Čítanie.
Claude.ai
- V Claude.ai otvorte Nastavenia → Konektory a pridajte vlastný konektor.
- Zadajte názov, napríklad Feather-Host, a adresu
https://client.feather-host.eu/api/mcp. Ostatné polia nechajte prázdne. - Kliknite na Pripojiť. Otvorí sa klientska zóna Feather-Host, v prípade potreby sa prihláste.
- Skontrolujte, že sa po povolení vrátite na claude.ai. Vyberte oprávnenia a aplikácie a kliknite na Povoliť prístup.
V novom rozhovore zapnite konektor Feather-Host a pýtajte sa. Pripojenie sa pri používaní samo predlžuje, po 90 dňoch bez použitia ho treba pridať znova.
ChatGPT
Vlastné konektory má ChatGPT v platených plánoch (Plus, Pro, Business a ďalšie) v režime pre vývojárov. Názvy v nastaveniach ChatGPT sa občas menia, postup ostáva rovnaký.
- V ChatGPT otvorte Nastavenia → Aplikácie (v starších verziách Konektory), v časti Rozšírené nastavenia zapnite Režim pre vývojárov a vytvorte nový konektor.
- Zadajte názov, napríklad Feather-Host, adresu
https://client.feather-host.eu/api/mcpa ako overenie zvoľte OAuth. - Po uložení sa otvorí klientska zóna Feather-Host, v prípade potreby sa prihláste. Vyberte oprávnenia a aplikácie a kliknite na Povoliť prístup.
- V rozhovore zapnite konektor Feather-Host (tlačidlo + pri písaní správy) a pýtajte sa.
Claude Code
V Nastaveniach na záložke API tokeny vytvorte token s potrebnými oprávneniami a aplikáciami a pridajte server:
claude mcp add --transport http feather-host https://client.feather-host.eu/api/mcp --header "Authorization: Bearer fh_…"
Príkazom /mcp v Claude Code overíte, že je server pripojený. Nové oprávnenia tokenu sa prejavia po obnovení pripojenia.
Cursor a VS Code
Token vytvorte rovnako ako pre Claude Code. V Cursore pridajte server do súboru ~/.cursor/mcp.json:
{
"mcpServers": {
"feather-host": {
"url": "https://client.feather-host.eu/api/mcp",
"headers": {
"Authorization": "Bearer fh_…"
}
}
}
}
Vo VS Code do súboru .vscode/mcp.json. Na token sa VS Code opýta pri prvom spustení a uloží si ho bezpečne mimo projektu:
{
"inputs": [
{
"type": "promptString",
"id": "feather-token",
"description": "Feather-Host API token",
"password": true
}
],
"servers": {
"feather-host": {
"type": "http",
"url": "https://client.feather-host.eu/api/mcp",
"headers": {
"Authorization": "Bearer ${input:feather-token}"
}
}
}
}
Token nikdy nevkladajte do súboru, ktorý ukladáte do Gitu.
Bezpečnosť
- Každému nástroju dajte vlastný token alebo pripojenie, len s oprávneniami a aplikáciami, ktoré potrebuje.
- Oprávnenia Nasadenie a Databáza dávajte len nástrojom, ktorým veríte, a ich akcie si pred potvrdením prečítajte. Zápis do databázy sa nedá vrátiť inak než obnovením zálohy.
- Hodnoty premenných prostredia, teda heslá a kľúče, asistent nikdy nevidí, len ich názvy.
- Dopyty do databázy zaznamenávame, nájdete ich 30 dní na záložke Databáza aplikácie.
- Pri tokene aj pripojení vidíte, kedy boli naposledy použité. Zmazaním v Nastaveniach na záložke API tokeny prístup okamžite zrušíte.
Keď niečo nefunguje
- Nástroj chýba, napríklad reštart alebo dopyty do databázy: token nemá príslušné oprávnenie. Upravte ho v Nastaveniach a v nástroji obnovte pripojenie.
- Aplikácia v zozname chýba: token k nej nemá prístup.
- Chyba 401 alebo unauthorized: token bol zmazaný, vypršal alebo je zle skopírovaný. V Claude.ai konektor odpojte a pripojte znova.
- Logy sú prázdne: v logoch je len to, čo aplikácia sama vypíše cez console.log alebo console.error.
Rovnaké akcie ponúka aj API, popis s príkladmi nájdete v dokumentácii API.