MCP & AI integrace

RenoTrack podporuje Model Context Protocol (MCP) — otevřený standard pro propojení AI asistentů s externími systémy. Díky MCP může váš AI asistent (Claude Desktop, Cursor, ChatGPT…) přímo pracovat s vašimi projekty.

Co je MCP?

Model Context Protocol (MCP) je protokol vyvinutý Anthropicem, který umožňuje AI asistentům bezpečně komunikovat s externími aplikacemi a databázemi. Místo copy-paste dat do chatu AI asistent přímo „vidí" a „píše" do RenoTracku — v reálném čase, s vaší autorizací.

Příklad: Řeknete Claude Desktop: „Přidej do deníku projektu Baba záznam, že dnes přišla nabídka od firmy Topení s.r.o." — a Claude to udělá přímo v RenoTracku bez toho, abyste otevírali prohlížeč.

Dostupnost

MCP integrace je dostupná pouze v plánu Business.

Po aktivaci Business plánu najdete správu API klíčů na stránce projektu v záložce API klíče (ikona klíče v pravém horním rohu projektu).

Jak propojit RenoTrack s AI asistentem

Vygenerujte API klíč

Na stránce projektu → záložka „API klíče" klikněte na „Vytvořit nový klíč". Klíč zkopírujte — zobrazí se pouze jednou. Každý klíč je vázán na konkrétní projekt a má omezený scope.

Přidejte MCP server do konfigurace

Otevřete konfigurační soubor vašeho AI asistenta a přidejte RenoTrack jako MCP server.

Claude Desktop(~/.config/claude/claude_desktop_config.json)

{
  "mcpServers": {
    "renotrack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "https://renotrack.cz/api/mcp"
      ],
      "env": {
        "MCP_API_KEY": "rt_váš_api_klíč"
      }
    }
  }
}

stdio transport (lokální server)

{
  "mcpServers": {
    "renotrack": {
      "command": "npx",
      "args": ["tsx", "/cesta/k/renotrack/mcp-server.ts"],
      "env": {
        "MCP_API_KEY": "rt_váš_api_klíč",
        "DATABASE_URL": "postgresql://..."
      }
    }
  }
}

Restartujte asistenta a začněte

Po restartu Claude Desktop uvidí v dostupných nástrojích RenoTrack server. Nástroje se zobrazí jako ikona zásuvky (🔌) v rozhraní chatu.

Dostupné MCP nástroje

AI asistent má k dispozici následující nástroje pro čtení i zápis dat:

Nástroj	Popis
list_projects	Výpis všech projektů s počty oblastí a dodavatelů
get_project	Detaily projektu: oblasti, dodavatelé, statistiky
get_trade_area	Oblast s objekty, parametry a hodnotami
create_trade_area	Vytvoření nové oblasti prací
set_trade_area_value	Nastavení hodnoty parametru oblasti
create_supplier	Přidání dodavatele k oblasti
update_supplier_status	Změna stavu dodavatele (vybrán, odmítnut…)
import_offer	AI analýza dokumentu nabídky + uložení do DB
add_diary_entry	Přidání záznamu do deníku projektu
list_contacts	Výpis kontaktní matice projektu
get_project_budget	Souhrn rozpočtu: celkový, utraceno, zbývá
add_project_expense	Přidání nákladu do rozpočtu

Příklady příkazů pro AI asistenta

"Ukaž mi přehled všech projektů a kolik mají oblastí."

"Přidej do deníku projektu Baba záznam: dnes dorazila nabídka od firmy ABC."

"Jaký je aktuální stav rozpočtu projektu? Kolik zbývá?"

"Analyzuj tuto nabídku (přiložím PDF) a ulož hodnoty k dodavateli Topení Plus."

"Porovnej nabídky dodavatelů v oblasti Topení — kdo nabídl nejvyšší výkon?"

"Změň stav dodavatele XYZ na Vybrán."

"Vytvoř novou oblast prací Elektroinstalace v projektu Baba."

Bezpečnost

Každý API klíč je vázán na konkrétní projekt — klíč nemá přístup k jiným projektům.
Klíče lze kdykoliv revokovat ze záložky API klíče na stránce projektu.
Komunikace probíhá přes HTTPS — data jsou šifrována při přenosu.
AI asistent vidí pouze data, na která má klíč oprávnění — žádná jiná data RenoTracku.

Objekty a parametry ← Zpět na přehled