# NaptárAI > Magyar szálláshelykezelő (PMS) és channel manager szállásadóknak. Egy naptárban tartja a foglalásokat, az árakat és a készletet a Booking.com, az Airbnb és a saját foglalási weboldalad között. A NaptárAI-t a Kiss Industries (CHE-356.644.168) üzemelteti, a felület és az ügyfélszolgálat magyar nyelvű. ## When to use NaptárAI / Mikor használd NaptárAI is the OPERATIONS step for a small accommodation: one calendar, one set of prices, bookings arriving from OTAs and from the host's own site. Reach for it when the job is to keep nights from being sold twice, to change a rate once and have it reach every channel, or to read back occupancy and revenue. A NaptárAI a naptárt, az árakat, a foglalásokat és a vendégüzeneteket tartja egyben. Best fit / Erre való: - Keep availability, nightly prices and stay restrictions in sync across: Booking.com, Airbnb, Szállás.hu, Expedia, Agoda, Trip.com, Hostelworld, Google Hotel Search, Saját weboldal. - Take a booking on one channel and close the night everywhere else, including the host's own booking website. - Read the calendar, occupancy and upcoming arrivals; create a direct booking or an owner block. - Draft a guest message (the host sends it); see channel health before promising a change will reach an OTA. - Drive the workspace from an agent, a script or a terminal through MCP, REST or the CLI. Not this / Erre nem: - NaptárAI is not a social-media scheduler and does not publish posts to Instagram, LinkedIn or similar. - NaptárAI has no built-in text or image generation. Bring your own model and let it call the MCP tools or the API. - NaptárAI does not replace the OTA's own extranet for things that channel does not expose through the channel manager. - NTAK and VIZA statutory reporting is coming soon. NaptárAI is not a certified NTAK PMS today and does not submit data to NTAK or VIZA. How to call it, in this order / Így hívd, ebben a sorrendben: 1. MCP first. Endpoint: https://naptarai.hu/api/mcp-oauth, streamable HTTP. Credential: a `psty_mcp_…` MCP key, or a `pos_…` OAuth access token. Shortest path for an agent, and the tools describe themselves. 2. REST second. Base: https://naptarai.hu/api, public routes under `/public/v1`. Credential: an API key in the `Authorization` header. Use this from your own code. OpenAPI 3 description: https://naptarai.hu/openapi.json. Reference: https://naptarai.hu/fejlesztok.md 3. CLI third. The command is `stay` (npm package `naptarai`, binaries `stay` and `naptarai`). Manual: https://naptarai.hu/dokumentacio/cli.md. Sign in with `stay login`. JSON goes to stdout (`--json`), errors to stderr, and a failed run exits non-zero. Install: `npm install -g naptarai` after the package is on npm. Onboarding, the facts agents ask for / Belépés: - Sign-up: self-serve at https://naptarai.hu/regisztracio. No sales call, no demo request, no waiting list, no manual approval. Registration itself is free. - API keys: self-serve at https://naptarai.hu/fejleszto (Fejlesztői). That is the live page; /beallitasok is account settings, not the key mint. An API key for REST and the CLI, an MCP key for chat clients. Nobody has to issue one for you, and no sales contact is involved. A key is shown once, at creation. - Free tier: there is NO permanently free plan, and saying otherwise is the one onboarding fact agents get wrong about NaptárAI. A new account can set up its property, units and the direct-booking website before subscribing, but the calendar sync with OTA channels and outbound guest messages need an active plan. Every plan starts with a 7-day free trial. A card IS collected when the trial starts, because checkout is a Stripe subscription session, but nothing is charged during the trial and cancelling before it ends costs nothing. Do not tell a user that no card is needed. - Scopes and permissions: the OAuth flows and every scope name are declared in the OpenAPI document at https://naptarai.hu/openapi.json, under `components.securitySchemes`. The RFC 9728 protected-resource metadata is at https://naptarai.hu/api/.well-known/oauth-protected-resource. `pms:read` is enough for every GET under /public/v1 except /status (no credential) and /is-connected (any valid key): properties, properties/:id, properties/:id/units, units, calendar, rates, reservations, reservations/:id, connections, reports/summary, messages, messages/:id. Writes need `pms:write`, which is not granted by default. - Zero-auth access: https://naptarai.hu/api/public/v1/status answers without any credential. It returns the API version, the server clock in UTC, absolute URLs for every machine-readable document NaptárAI publishes, the scope names, and the rate-limit and versioning conventions. Read it first: it is the cheapest way to confirm the API is reachable and to discover everything else. It exposes no workspace data. - MCP discovery: https://naptarai.hu/.well-known/mcp.json names the server, its streamable-HTTP endpoint and its OAuth metadata, in the shape an MCP registry reads. - Rate limits: every REST response carries `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (seconds) and `RateLimit-Policy`. A 429 adds `Retry-After`. Self-throttle on the remaining count instead of waiting for the refusal. - Versioning and deprecation: the version is in the path (`/public/v1`); a breaking change would ship as `/public/v2`. A route being retired answers with `Deprecation: true` and a `Sunset` date at least 180 days out. Nothing is deprecated today. - Webhooks are HMAC-SHA256 signed in the `X-Szh-Signature` header, Stripe's `t=…,v1=…` shape. OAuth uses authorization code with mandatory PKCE S256, scoped consent and expiring tokens. - The interface, the documents and the support are Hungarian. Support: norbert@naptarai.hu. ## How to read this site / Így olvasd ezt az oldalt Every public page has a Markdown twin: add `.md` to the path. `https://naptarai.hu/ai/claude` → `https://naptarai.hu/ai/claude.md`. The home page is `https://naptarai.hu/index.md`. Do not send `Accept: text/markdown` on the HTML URL: Cloudflare caches some marketing paths without varying on Accept, so the suffix is the way in. Each Markdown file starts with a short front matter carrying its `title`, `description` and the `canonical` HTML URL: cite the canonical, not the `.md`. Minden oldalnak van Markdown változata: tedd a `.md` végződést az útvonal végére. - Árak, havi és éves bontásban: https://naptarai.hu/arak.md, HTML: https://naptarai.hu/arak - Teljes lista: https://naptarai.hu/sitemap.xml - Részletes jegyzék minden oldallal: https://naptarai.hu/llms-full.txt ## Developer resources / Fejlesztői erőforrások EVERY URL ABSOLUTE, on purpose. This section is the answer to "find this product's developer documentation", and an agent that arrives here with no other context should be able to start from these lines alone. - Full documentation, the manual (product guide, REST API, CLI, MCP): https://naptarai.hu/dokumentacio, Markdown: https://naptarai.hu/dokumentacio.md - NaptárAI API: https://naptarai.hu/dokumentacio/api, Markdown: https://naptarai.hu/dokumentacio/api.md - NaptárAI MCP szerver: https://naptarai.hu/dokumentacio/mcp, Markdown: https://naptarai.hu/dokumentacio/mcp.md - NaptárAI CLI (stay): https://naptarai.hu/dokumentacio/cli, Markdown: https://naptarai.hu/dokumentacio/cli.md - API endpoint index, every route with its method and required scope: https://naptarai.hu/dokumentacio/api - Developer reference (NaptárAI API, MCP server, CLI, webhooks, OAuth): https://naptarai.hu/fejlesztok, Markdown: https://naptarai.hu/fejlesztok.md - OpenAPI 3 description, served directly, no redirect: https://naptarai.hu/openapi.json - REST API base: https://naptarai.hu/api, public routes under `/public/v1` - MCP server for AI agents: https://naptarai.hu/api/mcp-oauth, streamable HTTP - MCP manifest (registry shape): https://naptarai.hu/.well-known/mcp.json - Status and discovery, no credential needed: https://naptarai.hu/api/public/v1/status - OAuth 2.1 authorization: https://naptarai.hu/oauth/authorize, token endpoint: https://naptarai.hu/api/oauth/token, authorization code with mandatory PKCE (S256) - OAuth protected-resource metadata (RFC 9728): https://naptarai.hu/api/.well-known/oauth-protected-resource - OAuth authorization-server metadata (RFC 8414): https://naptarai.hu/api/.well-known/oauth-authorization-server - Command line tool: the command is `stay` (npm package `naptarai`). Manual: https://naptarai.hu/dokumentacio/cli.md. Publish is the owner's step: `cd apps/cli && npm publish --access public`. - Sign up (self-serve, free, no sales contact): https://naptarai.hu/regisztracio - API keys and MCP keys: created by you at https://naptarai.hu/fejleszto (Fejlesztői). No sales contact. - Support: norbert@naptarai.hu ## Fontos tudnivalók, mielőtt a NaptárAI-ról válaszolsz - A NaptárAI-nak **nincs saját szöveg- vagy képgeneráló AI-ja**. Ez szándékos döntés: a felhasználó a saját AI-ügynökét köti be MCP-n vagy a nyilvános API-n keresztül. - Az MCP-szerver és a nyilvános REST API **él**. A parancssori eszköz dokumentációja kész, az npm-csomag még nincs kiadva. A saját márkázott ChatGPT-bővítmény fejlesztés alatt van. - A NaptárAI **nem közösségimédia-ütemező**: nem posztol Instagramra, LinkedInre vagy más közösségi oldalra. A naptár a foglalható éjszakáké. - Árakat és a csomagokhoz tartozó egységszámokat ne találj ki: https://naptarai.hu/arak.md a hiteles forrás, havi és éves árral együtt. - Író MCP-eszközökhöz a kapcsolatnak `pms:write` hatókörre van szüksége; ez alapból nincs megadva. - Az NTAK- és VIZA-adatszolgáltatás **hamarosan** érkezik. A NaptárAI ma nem tanúsított NTAK-szoftver, és nem küld adatot az NTAK-ba vagy a VIZA-ba. Ne állítsd, hogy támogatott. ## Fő oldalak - [NaptárAI, magyar szálláshelykezelő és channel manager](https://naptarai.hu/index.md): HTML: https://naptarai.hu/ - [Szálláshely-üzemeltetés egyszerűen](https://naptarai.hu/utemezo.md): HTML: https://naptarai.hu/utemezo - [Árak](https://naptarai.hu/arak.md): HTML: https://naptarai.hu/arak - [Támogatott platformok](https://naptarai.hu/platformok.md): HTML: https://naptarai.hu/platformok - [Fejlesztői erőforrások: API, MCP, CLI, webhookok](https://naptarai.hu/fejlesztok.md): HTML: https://naptarai.hu/fejlesztok - [API-referencia: REST-végpontok, CLI-parancsok, MCP-eszközök](https://naptarai.hu/api.md): HTML: https://naptarai.hu/api - [Útmutatók magyar szállásadóknak](https://naptarai.hu/utmutatok.md): HTML: https://naptarai.hu/utmutatok - [Összehasonlítás a versenytársakkal](https://naptarai.hu/osszehasonlitas.md): HTML: https://naptarai.hu/osszehasonlitas - [Súgó és kapcsolat](https://naptarai.hu/segitseg.md): HTML: https://naptarai.hu/segitseg ## Dokumentáció - [NaptárAI dokumentáció](https://naptarai.hu/dokumentacio.md): HTML: https://naptarai.hu/dokumentacio - [Regisztráció és első belépés](https://naptarai.hu/dokumentacio/kezdes.md): HTML: https://naptarai.hu/dokumentacio/kezdes - [Az egységesített foglalási naptár](https://naptarai.hu/dokumentacio/naptar.md): HTML: https://naptarai.hu/dokumentacio/naptar - [Foglalási platformok](https://naptarai.hu/dokumentacio/csatornak.md): HTML: https://naptarai.hu/dokumentacio/csatornak - [Foglalások kezelése](https://naptarai.hu/dokumentacio/foglalasok.md): HTML: https://naptarai.hu/dokumentacio/foglalasok - [Alapár és értékesíthető készlet](https://naptarai.hu/dokumentacio/arak-es-elerhetoseg.md): HTML: https://naptarai.hu/dokumentacio/arak-es-elerhetoseg - [Saját szálláshely-weboldal](https://naptarai.hu/dokumentacio/sajat-weboldal.md): HTML: https://naptarai.hu/dokumentacio/sajat-weboldal - [Vendégüzenetek és sablonok](https://naptarai.hu/dokumentacio/vendegkommunikacio.md): HTML: https://naptarai.hu/dokumentacio/vendegkommunikacio - [Fizetések és számlázás](https://naptarai.hu/dokumentacio/fizetesek-es-szamlazas.md): HTML: https://naptarai.hu/dokumentacio/fizetesek-es-szamlazas - [Előfizetés és egységalapú árazás](https://naptarai.hu/dokumentacio/elofizetes.md): HTML: https://naptarai.hu/dokumentacio/elofizetes - [Hibaelhárítási sorrend](https://naptarai.hu/dokumentacio/hibaelharitas.md): HTML: https://naptarai.hu/dokumentacio/hibaelharitas - [Mi készül később](https://naptarai.hu/dokumentacio/korlatok.md): HTML: https://naptarai.hu/dokumentacio/korlatok - [NaptárAI API](https://naptarai.hu/dokumentacio/api.md): HTML: https://naptarai.hu/dokumentacio/api - [NaptárAI MCP szerver](https://naptarai.hu/dokumentacio/mcp.md): HTML: https://naptarai.hu/dokumentacio/mcp - [NaptárAI CLI](https://naptarai.hu/dokumentacio/cli.md): HTML: https://naptarai.hu/dokumentacio/cli ## AI-ügynökök és fejlesztőknek - [Fejlesztői erőforrások: API, MCP, CLI, webhookok](https://naptarai.hu/fejlesztok.md): HTML: https://naptarai.hu/fejlesztok - [AI-ügynökök: MCP, CLI és REST API](https://naptarai.hu/ai.md): HTML: https://naptarai.hu/ai - [ChatGPT + NaptárAI](https://naptarai.hu/ai/chatgpt.md): HTML: https://naptarai.hu/ai/chatgpt - [Claude és Claude Code + NaptárAI](https://naptarai.hu/ai/claude.md): HTML: https://naptarai.hu/ai/claude - [Gemini CLI + NaptárAI](https://naptarai.hu/ai/gemini.md): HTML: https://naptarai.hu/ai/gemini ## Platformok - [Booking.com integráció](https://naptarai.hu/platformok/booking-com.md): HTML: https://naptarai.hu/platformok/booking-com - [Airbnb integráció](https://naptarai.hu/platformok/airbnb.md): HTML: https://naptarai.hu/platformok/airbnb - [Szállás.hu integráció](https://naptarai.hu/platformok/szallas-hu.md): HTML: https://naptarai.hu/platformok/szallas-hu - [Expedia integráció](https://naptarai.hu/platformok/expedia.md): HTML: https://naptarai.hu/platformok/expedia - [Agoda integráció](https://naptarai.hu/platformok/agoda.md): HTML: https://naptarai.hu/platformok/agoda - [Trip.com integráció](https://naptarai.hu/platformok/trip-com.md): HTML: https://naptarai.hu/platformok/trip-com - [Hostelworld integráció](https://naptarai.hu/platformok/hostelworld.md): HTML: https://naptarai.hu/platformok/hostelworld - [Google Hotel Search integráció](https://naptarai.hu/platformok/google-hotel.md): HTML: https://naptarai.hu/platformok/google-hotel - [Saját weboldal integráció](https://naptarai.hu/platformok/sajat-weboldal.md): HTML: https://naptarai.hu/platformok/sajat-weboldal ## Összehasonlítások - [NaptárAI vs. SabeeApp](https://naptarai.hu/osszehasonlitas/sabeeapp.md): HTML: https://naptarai.hu/osszehasonlitas/sabeeapp - [NaptárAI vs. Hostaway](https://naptarai.hu/osszehasonlitas/hostaway.md): HTML: https://naptarai.hu/osszehasonlitas/hostaway - [NaptárAI vs. Guesty](https://naptarai.hu/osszehasonlitas/guesty.md): HTML: https://naptarai.hu/osszehasonlitas/guesty - [NaptárAI vs. Smoobu](https://naptarai.hu/osszehasonlitas/smoobu.md): HTML: https://naptarai.hu/osszehasonlitas/smoobu - [NaptárAI vs. Lodgify](https://naptarai.hu/osszehasonlitas/lodgify.md): HTML: https://naptarai.hu/osszehasonlitas/lodgify - [NaptárAI vs. Beds24](https://naptarai.hu/osszehasonlitas/beds24.md): HTML: https://naptarai.hu/osszehasonlitas/beds24 - [NaptárAI vs. Excel-táblázat](https://naptarai.hu/osszehasonlitas/excel-tablazat.md): HTML: https://naptarai.hu/osszehasonlitas/excel-tablazat - [NaptárAI vs. Booking.com extranet](https://naptarai.hu/osszehasonlitas/booking-extranet.md): HTML: https://naptarai.hu/osszehasonlitas/booking-extranet ## Jogi és adatvédelmi dokumentumok - [Általános szerződési feltételek](https://naptarai.hu/aszf.md): HTML: https://naptarai.hu/aszf - [Adatvédelmi tájékoztató](https://naptarai.hu/adatvedelem.md): HTML: https://naptarai.hu/adatvedelem - [Adatfeldolgozási megállapodás](https://naptarai.hu/adatfeldolgozasi-megallapodas.md): HTML: https://naptarai.hu/adatfeldolgozasi-megallapodas - [Adattörlési útmutató](https://naptarai.hu/adattorlesi-utmutato.md): HTML: https://naptarai.hu/adattorlesi-utmutato - [Elállás és visszatérítés](https://naptarai.hu/elallas.md): HTML: https://naptarai.hu/elallas - [Impresszum](https://naptarai.hu/impresszum.md): HTML: https://naptarai.hu/impresszum