Skip to content

zcloudcz/fakvio

v0.1.2

Invoicing for Czech and Slovak freelancers and small businesses: list, create and send invoices, clients, received invoices, payments, VAT reports and tax estimates.

GitHub

ChatGPT app package (OpenAI plugin submission)

Files for submitting the hosted MCP server (https://mcp.fakvio.cz/mcp) to platform.openai.com/plugins. Built from https://developers.openai.com/apps-sdk/deploy/submission and https://developers.openai.com/plugins/build/plugins (Agent Plugins format).

Domain verification

  1. In the OpenAI portal copy the challenge token.
  2. Set it as the App Service application setting FAKVIO_OPENAI_APPS_CHALLENGE_TOKEN on fakvio-mcp-web, then restart the app.
  3. Check: curl -i https://mcp.fakvio.cz/.well-known/openai-apps-challenge returns 200, text/plain, body = token only. Without the setting it returns 404.

Zip

Zip the contents of this folder (so plugin.json is at the zip root), from this folder:

Compress-Archive -Path plugin.json, mcp.json, assets -DestinationPath fakvio-plugin.zip

Upload the zip in the portal. Do not put credentials in it. The OAuth client is CIMD, so no client id or secret exists; the authorization server is https://api.fakvio.cz (PKCE S256, scopes read / write, no DCR).

TODO verify

  • TODO verify: category ("Productivity") is a guess from the docs example; pick the allowed value in the portal.
  • TODO verify: capabilities values Read / Write copied from the docs example.
  • TODO verify: supportURL is https://fakvio.cz because the docs say HTTPS only (no mailto:).
  • TODO verify: docs URL (https://fakvio.cz/ai-asistent.html) has no field in the schema; use it in the portal/reviewer notes.

Portal gotchas (2026-10-21)

  • The portal's Connect dialog ignores client.mode: "cimd" and keeps its form state at PREDEFINED, failing with "OAuth client ID is required when using pre-defined OAuth client credentials". Workaround used: set the react-hook-form value mcp.oauth_client_mode to CIMD from DevTools before clicking Connect.
  • The scan requires readOnlyHint, destructiveHint and openWorldHint to be explicit on every tool (see DEVGUIDE section 4.9).
  • Review info (5 test cases, 3 negative, release notes, demo video URL, reviewer credentials) is entered in the portal's "Add review information" dialog, not in the package (review-test-cases.md holds the text).