Jak propojit FAPI a Codex

Jak propojit FAPI s Codexem přes MCP server

Jak připojit FAPI k Codexu pomocí MCP serveru. Po propojení může AI agent v Codexu pracovat s daty ve FAPI, například vyhledat poslední vystavené faktury, vytvářet formuláře, produkty nebo připravovat přehledy podle dostupných funkcí MCP serveru.

Co budete potřebovat

Před začátkem si připravte:

• přístup do Codexu,
• přístup do svého účtu FAPI,
• možnost vytvořit API klíč ve FAPI,
• MCP URL adresu:

https://mcp.fapi.cz/mcp  

Rychlý přehled nastavení

V Codexu přidáte nový MCP server a nastavíte:

Typ připojení: Streamované HTTP URL: https://mcp.fapi.cz/mcp  

Potom přidáte dvě HTTP hlavičky:

x-fapi-username  

x-fapi-token  

Po uložení je potřeba Codex restartovat nebo obnovit, aby si nově přidaný MCP server načetl.

1. Otevření nastavení v Codexu

1. Přihlaste se do Codexu.
2. Otevřete nastavení.
3. V levém menu najděte sekci Servery MCP.
4. Klikněte na Servery MCP.

Pokud už máte některé MCP servery přidané, uvidíte je v seznamu. Pro FAPI přidejte nový server.

2. Přidání MCP serveru

1. Klikněte na Přidat server.
2. Vyplňte název serveru.

Doporučený název:

fapi-codex  

Pokud máte více FAPI účtů nebo prostředí, zvolte název, podle kterého propojení později snadno poznáte, například:

fapi-jirka fapi-restartujem  

V názvu raději nepoužívejte mezery. Vhodnější jsou pomlčky nebo podtržítka.

3. Nastavení URL adresy

V nastavení serveru zvolte typ připojení:

Streamované HTTP  

Nepoužívejte typ STDIO  .

Do pole URL vložte:

https://mcp.fapi.cz/mcp  

Důležité je, aby URL končila částí:

/mcp  

Bez této části nemusí propojení fungovat.

4. Přidání přihlašovacích hlaviček

Aby Codex mohl komunikovat s vaším FAPI účtem, musí MCP serveru předávat přihlašovací údaje. Ty se nastavují jako HTTP hlavičky.

Přidejte dvě hlavičky:

x-fapi-username  - e-mailová adresa vašeho účtu FAPI

x-fapi-token  - API klíč vytvořený ve FAPI

5. Vytvoření API klíče ve FAPI

1. Přihlaste se do FAPI.
2. Otevřete Můj účet.
3. Přejděte do sekce API klíče.
4. Klikněte na Nový API klíč.
5. API klíč si pojmenujte podle toho, kde ho budete používat.

Doporučený název:

Codex  

Název klíče je důležitý hlavně pro pozdější správu. Když budete vědět, že konkrétní klíč používá Codex, můžete ho v případě potřeby rychle zrušit, aniž byste ovlivnili jiné integrace.

Po vytvoření FAPI zobrazí:

• uživatelské jméno, obvykle e-mailovou adresu,
• heslo/API klíč.

API klíč si zkopírujte a nikde ho veřejně neukazujte.

6. Vložení přístupových údajů do Codexu

Vraťte se do nastavení MCP serveru v Codexu a vyplňte hodnoty hlaviček:

x-fapi-username = e-mailová adresa z FAPI

x-fapi-token = API klíč z FAPI  

7. Uložení a restart Codexu

1. Zkontrolujte název serveru, URL a obě hlavičky.
2. Klikněte na Uložit.
3. Restartujte nebo obnovte Codex.

Codex si po restartu znovu načte dostupné MCP servery. Pokud je v rozhraní tlačítko Restartovat, použijte ho.

8. Ověření propojení

Po restartu otevřete nový chat v Codexu a zeptejte se, jestli má přístup k FAPI přes nově přidaný MCP server.

Příklad dotazu:

Máš přístup do FAPI účtu skrze MCP? Dej mi seznam posledních 5 zaplacených faktur.  

Správně nastavené propojení poznáte tak, že Codex vrátí data z FAPI, například seznam posledních faktur.

Bezpečnostní doporučení

• API klíč nikdy nezveřejňujte.
• API klíč neposílejte e-mailem ani přes chat, pokud to není bezpečné prostředí.
• Pro Codex vytvořte samostatný API klíč.
• API klíč pojmenujte tak, abyste později poznali, k čemu slouží.
• Pokud máte podezření, že se klíč dostal k někomu cizímu, zrušte ho a vytvořte nový.
• Dávejte pozor na to, jaké akce AI agentovi zadáváte. Přes MCP může pracovat s daty ve FAPI podle dostupných oprávnění.

Řešení častých problémů

Codex nevidí MCP server

Zkontrolujte, že jste po uložení serveru Codex restartovali nebo obnovili. Nově přidaný MCP server se nemusí načíst okamžitě.

Propojení nefunguje

Zkontrolujte:

• že je vybraný typ připojení Streamované HTTP,
• že URL je přesně https://mcp.fapi.cz/mcp  ,
• že URL obsahuje koncové /mcp  ,
• že máte vyplněné obě hlavičky x-fapi-username   a x-fapi-token  ,
• že e-mail a API klíč jsou vložené jako hodnoty hlaviček, ne jako jejich názvy.

Příklad dotazu pro Codex

Po nastavení můžete v Codexu použít například:

Použij MCP server fapi-codex a vypiš mi posledních 5 vystavených faktur ve FAPI.  

Další příklady:

Použij MCP server fapi-codex a zjisti, jaké produkty mám ve FAPI.  

Použij MCP server fapi-codex a připrav mi přehled posledních objednávek.  

Použij MCP server fapi-codex a navrhni, jaké statistiky z účtu FAPI by dávalo smysl sledovat.