Cursor, VS Code a doklad.ai: fakturace přes MCP v editoru

Cursor i VS Code s GitHub Copilotem podporují **MCP**, takže doklad.ai připojíte jedním záznamem v souboru mcp.json s adresou https://doklad.ai/mcp. Po přihlášení účtem doklad.ai agent v editoru vystaví fakturu, dohledá platbu nebo zapíše náklad — hodí se vývojářům a freelancerům, kteří fakturují přímo z rozdělané práce.

Co agent v editoru s doklad.ai zvládne

Přes MCP server doklad.ai AI vyhledá a vystaví faktury, upraví je, pošle e-mailem, zapíše úhradu, založí zákazníka, zapíše náklad a spočítá statistiky nebo cash flow — celkem 17 nástrojů. Zkuste třeba:

  • „Které faktury jsou po splatnosti a kolik mi dohromady dluží?“
  • „Vystav fakturu firmě Alfa s.r.o. za 12 hodin konzultací po 1 500 Kč bez DPH, splatnost 14 dní.“
  • „Jaký byl cash flow za září?“

Připojení v Cursoru

Nejrychleji tlačítkem Přidat do Cursoru na této stránce. Ručně do souboru ~/.cursor/mcp.json (všechny projekty) nebo .cursor/mcp.json (jeden projekt) přidejte:

{
  "mcpServers": {
    "doklad": {
      "url": "https://doklad.ai/mcp"
    }
  }
}

V Cursor Settings → Tools & MCP se u doklad.ai objeví výzva k přihlášení. Po kliknutí se otevře doklad.ai, kde vyberete firmu a povolíte přístup.

Připojení ve VS Code s GitHub Copilotem

Nejrychleji tlačítkem Přidat do VS Code na této stránce. Ručně do souboru .vscode/mcp.json v projektu (nebo přes příkaz MCP: Add Server) přidejte:

{
  "servers": {
    "doklad": {
      "type": "http",
      "url": "https://doklad.ai/mcp"
    }
  }
}

Při prvním spuštění serveru se VS Code zeptá na přihlášení do doklad.ai. Nástroje pak používá GitHub Copilot v chatu v režimu Agent. Potřebujete VS Code 1.99 nebo novější; v tarifech Copilot Business a Enterprise musí správce organizace povolit zásadu MCP servers in Copilot.

Bezpečnost a oprávnění

Přístup povolujete na stránce doklad.ai a vybíráte firmu; připojit AI smí jen vlastník nebo administrátor. Každé volání se zapisuje do auditního logu a připojení zrušíte v Integrace → API klíče a webhooky → Připojené aplikace. Více v kapitole o bezpečnosti.

Když připojení nefunguje

  • Server se nenačte: zkontrolujte, že je JSON platný (čárky, uvozovky) a adresa končí na /mcp.
  • Chcete API klíč místo přihlášení: přidejte k serveru "headers": { "Authorization": "Bearer dk_…" } s klíčem z Integrace → API klíče a webhooky.

Průvodce MCP serverem doklad.ai shrnuje připojení ve všech aplikacích na jedné stránce.

Časté dotazy

Kam v Cursoru patří konfigurace?

Do ~/.cursor/mcp.json pro všechny projekty, nebo do .cursor/mcp.json v konkrétním projektu.

Jak se ve VS Code přihlásím?

Po přidání serveru typu http s adresou https://doklad.ai/mcp se VS Code při prvním spuštění zeptá na přihlášení do doklad.ai.

Uvidí editor všechny moje firmy?

Ne. Přístup platí pro jednu firmu, kterou vyberete při povolení přístupu.

Související návody

Užitečné nástroje