Pohoda MCP Server

MCP server pro účetní software Pohoda od Stormware. Komunikuje s Pohodou přes mServer XML API.

Propojte svého AI asistenta přímo s účetnictvím. Ptejte se na faktury, procházejte adresář, kontrolujte zásoby, vytvářejte nové doklady nebo si nechte vytisknout fakturu do PDF. Stačí napsat, co potřebujete, a MCP server se postará o komunikaci s Pohodou.

Požadavky

• PHP 8.1+
• ext-curl, ext-dom, ext-simplexml
• Pohoda s aktivním mServerem

Nastavení mServeru v Pohodě

Před použitím MCP serveru je potřeba v Pohodě zapnout a nakonfigurovat mServer.

1. Otevření správy mServeru

V programu Pohoda otevřete agendu Účetní jednotky, v menu zvolte Databáze > POHODA mServer.

2. Správa konfigurací

Otevře se dialogové okno se seznamem konfigurací mServeru. Pro každou konfiguraci je uveden název, port, stav spuštění, host a PID.

3. Vytvoření nové instance

Klikněte na Nový a na záložce Základní nastavte:

• Název mServeru
• Účetní jednotku, se kterou bude mServer komunikovat
• Port pro komunikaci (výchozí 444)

Na záložce HTTPS lze zapnout zabezpečenou komunikaci:

Na záložce Monitoring lze zapnout logování komunikace:

4. Spuštění

Vyberte konfiguraci a klikněte na Spustit (nebo dvakrát klikněte na záznam). mServer začne naslouchat na nastaveném portu.

Podrobnosti viz dokumentace Stormware.

Instalace MCP serveru

git clone https://github.com/dg/pohoda-mcp.git
cd pohoda-mcp
composer install

Konfigurace

Server se konfiguruje přes proměnné prostředí:

| Proměnná | Popis | Výchozí | |--------------------|--------------------------------|------------------------| | POHODA_URL | URL mServeru | http://localhost:444 | | POHODA_ICO | ICO účetní jednotky | | | POHODA_USERNAME | Uživatelské jméno pro mServer | | | POHODA_PASSWORD | Heslo | |

Použití v agentech (např. Claude Code)

Přidejte do .mcp.json nebo do project settings:

{
	"mcpServers": {
		"pohoda": {
			"command": "php",
			"args": ["/cesta/k/pohoda-mcp/server.php"],
			"env": {
				"POHODA_URL": "http://localhost:444",
				"POHODA_ICO": "12345678",
				"POHODA_USERNAME": "Admin",
				"POHODA_PASSWORD": ""
			}
		}
	}
}

Dostupné nástroje

pohoda_status

Ověří, jestli mServer běží a odpovídá.

pohoda_list

Hlavní nástroj pro čtení dat. Vrací záznamy z libovolné agendy s možností filtrování.

Podporované agendy:

| Agenda | Popis | | Agenda | Popis | |---|---|---|---|---| | invoice | faktury* | | prijemka | příjemky | | order | objednávky | | vydejka | výdejky | | addressbook | adresář | | prodejka | prodejky | | stock | zásoby | | prevodka | převodky | | voucher | pokladní doklady | | vyroba | výroba | | bank | banka | | accountancy | účetní deník | | contract | zakázky | | store | sklady | | intDoc | interní doklady | | bankAccount | bankovní účty | | offer | nabídky | | cashRegister | pokladny | | enquiry | poptávky | | numericalSeries | číselné řady | | | | | centre | střediska | | | | | activity | činnosti |

* Agenda invoice vyžaduje parametr invoiceType: issuedInvoice nebo receivedInvoice.

Filtry pro doklady:

| Parametr | Popis | |

... View full README on GitHub