---
title: "Tervezett MCP-eszközök | NaptárAI"
description: "Olvasó és író domaineszközök a properties.list művelettől a message.send műveletig."
canonical: https://naptarai.hu/dokumentacio/mcp/eszkozok
source: https://naptarai.hu/dokumentacio/mcp/eszkozok.md
---

MCP-szerver

# Tervezett MCP-eszközök

Olvasó és író domaineszközök a properties.list művelettől a message.send műveletig.

Fejlesztési dokumentáció

A termék fejlesztés alatt áll. Az oldal a tervezett működést írja le; kész harmadik fél-integrációt csak külön, egyértelmű státusz alapján tekints elérhetőnek.

## Olvasó eszközök

Ezek az eszközök semmit nem módosítanak, és minden érvényes MCP-kapcsolat hívhatja őket.

- properties\_list, properties\_get, units\_list, szálláshelyek és kiadható egységek
- calendar\_get, éjszakánként és egységenként eladható szoba, foglalások, zárolások
- availability\_get, szabad éjszakák és összefüggő szabad időszakok
- rates\_get, éjszakai árak és tartózkodási korlátozások
- reservations\_list, reservations\_get, foglalások szűrve, illetve tételesen
- guests\_get, egy vendég azonosító alapján vagy keresés név, e-mail szerint
- channels\_status, az OTA-kapcsolatok állapota, utolsó szinkron, utolsó hiba
- analytics\_summary, mai érkezések, havi kihasználtság, bevétel, direkt/OTA arány
- website\_get, a saját foglalási weboldal állapota és tartalma

## Író eszközök

Az író eszközökhöz a kapcsolatnak pms:write hatókörre van szüksége. Ez alapértelmezetten nincs megadva: egy frissen létrehozott MCP-kulcs csak olvasni tud, amíg a munkaterület tulajdonosa külön meg nem adja az írási jogot. Írási jog nélkül a hívás elutasításra kerül, és semmi nem változik.

- calendar\_block, calendar\_unblock, éjszakák kivétele és visszaengedése az értékesítésbe
- rates\_set, egy ár beállítása időszakra
- rates\_adjust, meglévő árak mozgatása százalékkal vagy fix összeggel, legfeljebb ±50%
- restrictions\_set, minimum és maximum éjszaka, érkezés- és távozászárás, értékesítés leállítása
- reservation\_create, direkt vagy kézi foglalás rögzítése
- reservation\_cancel, foglalás lemondása
- message\_draft, vendégüzenet előkészítése; nem küld el semmit

## Védőkorlátok

Néhány szabály magában az eszközben van kikényszerítve, nem csak leírva.

- Megerősített vagy bejelentkezett foglalás csak a konkrét foglalás kifejezett megerősítésével mondható le.
- Saját használatra zárolt éjszakák csak külön megerősítéssel nyithatók vissza.
- Egyetlen ár sem mozdítható 50%-nál nagyobb mértékben egyik irányba sem.
- OTA-ról érkezett foglalás nem rögzíthető kézzel: az a csatornán keresztül érkezik meg.
- A message\_draft nem küld és nem tárol üzenetet, a szöveget a szállásadó küldi el a NaptárAI postaládájából.

## Még nem elérhető

A PRD §22 további eszközöket is felsorol. Ezek szándékosan nem léteznek, nem pedig hibát adnak vissza: egy létező, de mindig elutasító eszközre az AI hiába tervez.

- payments.list
- availability.set, reservation.modify
- message.send, website.update
- task.create, tasks.list, promo.create

## Státusz

A ténylegesen kiadott szerver önleíró eszközlistája a végleges szerződés. A fenti nevek a /.well-known/mcp.json manifesztben is szerepelnek, és egy build-teszt tartja őket szinkronban a szerver saját eszközregiszterével.

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@naptarai.hu](mailto:norbert@naptarai.hu) címre, vagy használd a [Segítség](https://naptarai.hu/segitseg) oldal űrlapját.