Pripojenie AI nástrojov cez MCP

Čo je MCP

Model Context Protocol (MCP) je otvorený štandard od Anthropic, ktorý umožňuje AI aplikáciám bezpečne pristupovať k vašim faktúram, klientom, výdavkom a štatistikám priamo z chatu — bez kopírovania údajov.

Náš MCP server podporuje Streamable HTTP transport (spec 2025-11-25) s OAuth 2.1 + Dynamic Client Registration + PKCE, alebo Bearer token autentifikáciou cez Personal Access Token (PAT). Väčšina klientov sa pripojí jedným klikom.

Server URL

Všetci klienti používajú túto endpoint URL:

https://mojefaktury.sk/api/mcp

Vytvorenie tokenu (PAT)

Pre klientov bez OAuth podpory (Hermes, OpenClaw, Continue.dev, NanoClaw) alebo pre rýchle nastavenie:

1. Otvorte Nastavenia → API kľúče
2. Kliknite + Nový kľúč
3. Zapnite checkbox „Použiť pre MCP"
4. Vyberte oprávnenie (len čítanie / čítanie a zápis)
5. Skopírujte token mf_xxx… — zobrazí sa len raz!

Claude.ai a Claude Code

Claude.ai (web / Desktop / mobile) — OAuth

1. Customize → Connectors → + Add custom connector
2. Vložte URL: https://mojefaktury.sk/api/mcp
3. Kliknite Connect → presmeruje vás na MojeFaktury login
4. Schválite consent screen → vrátite sa do Claude s aktívnym pripojením

OAuth flow je automatický. Token sa obnovuje každú hodinu, refresh trvá 30 dní.

Claude Code (CLI) — OAuth loopback

claude mcp add --transport http mojefaktury https://mojefaktury.sk/api/mcp

Claude Code otvorí lokálny webserver na náhodnom porte pre OAuth callback. Náš server podporuje port-agnostic loopback matching (RFC 8252).

ChatGPT (Apps SDK / Developer Mode)

1. Settings → Personalization → Custom Connectors (Plus / Pro / Team / Enterprise)
2. Vložte URL: https://mojefaktury.sk/api/mcp
3. ChatGPT spustí OAuth flow automaticky

Plus / Pro: iba read-only nástroje. Business a vyššie: aj write operácie. ChatGPT NEakceptuje Bearer headers — vyžaduje OAuth flow.

Cursor, VS Code, Windsurf, Zed

Cursor IDE — PAT v headers

// .cursor/mcp.json (projekt) alebo ~/.cursor/mcp.json
{
  "mcpServers": {
    "mojefaktury": {
      "url": "https://mojefaktury.sk/api/mcp",
      "headers": { "Authorization": "Bearer mf_VAS_TOKEN" }
    }
  }
}

Cursor nepodporuje Dynamic Client Registration — najjednoduchšie je PAT v Authorization header.

VS Code + GitHub Copilot — OAuth

// .vscode/mcp.json
{
  "servers": {
    "mojefaktury": { "type": "http", "url": "https://mojefaktury.sk/api/mcp" }
  }
}

Pozor: VS Code používa kľúč servers (nie mcpServers ako Cursor). Funguje len v Agent mode Copilot Chatu.

Windsurf (Codeium)

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mojefaktury": {
      "type": "streamable-http",
      "serverUrl": "https://mojefaktury.sk/api/mcp",
      "headers": { "Authorization": "Bearer mf_VAS_TOKEN" }
    }
  }
}

Zed editor — cez mcp-remote

// settings.json
"context_servers": {
  "mojefaktury": {
    "command": {
      "path": "npx",
      "args": ["-y", "mcp-remote", "https://mojefaktury.sk/api/mcp",
               "--header", "Authorization: Bearer mf_VAS_TOKEN"]
    }
  }
}

Gemini CLI, Continue.dev

Gemini CLI (Google) — OAuth auto-discovery

// ~/.gemini/settings.json
{
  "mcpServers": {
    "mojefaktury": { "url": "https://mojefaktury.sk/api/mcp" }
  }
}

Gemini CLI nájde OAuth metadata automaticky cez .well-known endpointy a otvorí browser pre prihlásenie.

Continue.dev — PAT

# ~/.continue/config.yaml
mcpServers:
  - name: mojefaktury
    type: streamable-http
    url: https://mojefaktury.sk/api/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MCP_TOKEN }}

Hermes, OpenClaw, Goose

Hermes Agent (NousResearch) — Bearer

{
  "mcp": {
    "servers": {
      "mojefaktury": {
        "url": "https://mojefaktury.sk/api/mcp",
        "headers": { "Authorization": "Bearer mf_VAS_TOKEN" }
      }
    }
  }
}

Hermes zatiaľ nepodporuje OAuth flow — použite PAT.

OpenClaw / NanoClaw — Bearer

Rovnaký config ako Hermes. OpenClaw OAuth podporu pripravuje — zatiaľ Bearer token v headers.

Goose (Block) — OAuth loopback

1. goose configure → Add Extension → Remote Extension
2. Vložte URL: https://mojefaktury.sk/api/mcp
3. Goose otvorí browser pre OAuth login

Open WebUI, LibreChat

Open WebUI (Ollama UI)

1. Admin Panel → Settings → Tools → MCP Servers
2. Pridajte URL: https://mojefaktury.sk/api/mcp
3. Vyberte „OAuth 2.1 (DCR)" alebo „Bearer Token"

Vyžaduje nastavený WEBUI_SECRET_KEY env var, inak OAuth tokeny neprežijú reštart.

LibreChat

# librechat.yaml
mcpServers:
  mojefaktury:
    type: streamable-http
    url: https://mojefaktury.sk/api/mcp
    headers:
      Authorization: "Bearer ${MCP_TOKEN}"

mcp-remote (stdio bridge pre staré klienty)

Pre Claude Desktop bez natívnej HTTP podpory, alebo iné stdio-only klienty:

{
  "mcpServers": {
    "mojefaktury": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mojefaktury.sk/api/mcp"]
    }
  }
}

mcp-remote sa stará o OAuth flow + ukladá refresh token lokálne. Použite verziu ≥ 0.1.16 (kvôli CVE-2025-6514).

Bezpečnosť

• Tokeny sú hashované (SHA-256), v databáze nikdy v čitateľnej forme
• OAuth flow používa PKCE (S256), refresh tokeny rotujú pri každom použití
• Mutating tools (vystavenie faktúry, odoslanie emailu) sú dostupné iba s oprávnením „čítanie a zápis"
• Pri read-only tokenoch sa write tools automaticky skryjú zo zoznamu
• DNS-rebind ochrana cez Origin header (Claude.ai, OpenAI, vlastný host vždy povolené)
• Pripojenie môžete kedykoľvek zrušiť v Nastaveniach → API kľúče
• Všetky volania sa logujú (audit) — superadmin vidí v Superadmin → MCP logy
• Limity: 100 requestov/min na token, max 5 min per request