Doklad.ai

Doklad.ai MCP サーバー

AI アシスタントをDoklad.aiに接続します。Doklad.aiは、フリーランス（OSVČ）や小規模企業向けのチェコの請求書ソフトウェアです。ホスト型のDoklad.ai MCP サーバーを使うと、Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、Gemini CLIなどのModel Context Protocolクライアントから、Doklad.aiアカウント内の請求書の作成・送信、顧客の管理、経費の記録、受領した支払いの記録、キャッシュフローの要約ができます。

エンドポイント	https://doklad.ai/mcp
トランスポート	Streamable HTTP
認証	OAuth 2.1（Doklad.aiアカウントでサインイン。PKCE、動的クライアント登録）またはAPIキー Authorization: Bearer dk_…
料金	Doklad.aiは現在無料です。MCPも含まれます
レート制限	会社あたり毎分60リクエスト
公式MCPレジストリ	ai.doklad/mcp
セットアップガイド（チェコ語）	https://doklad.ai/mcp-fakturace

このリポジトリにはドキュメントとクライアント設定のみが含まれています。MCP サーバーはDoklad.aiがホストして運用しているため、お使いの環境にインストールしたり実行したりする必要はありません。

対象ユーザー

• Doklad.aiで請求書を発行しており、AI アシスタントから請求書を扱いたいフリーランス（OSVČ）やチェコの小規模企業。
• 日常的な請求業務や支払いのフォローアップを自動化する会計士やバックオフィスチーム。
• チェコの請求書データを活用するエージェントを構築する開発者。

できること

• 「支払期限を過ぎた請求書はどれですか？未払いの合計はいくらですか？」
• 「Alfa s.r.o.宛てに、VAT抜きで1時間あたり1,500 CZKのコンサルティング12時間分の請求書を作成してください。支払期限は14日後です。」
• 「請求書2026-0142を顧客にメールで送信してください。」
• 「請求書2026-0137について、本日受領した18,150 CZKの支払いを記録してください。」
• 「9月の売上、経費、利益を表示してください。」

クライアントを接続する

どのクライアントでも同じURL https://doklad.ai/mcp を使用します。初回利用時には、クライアントがブラウザーでDoklad.aiを開きます。サインインして会社を選び、アクセスを許可してください。キーをコピーする必要はありません。会社のアクセスを許可できるのは、会社のオーナーまたは管理者のみです。

Claude（claude.ai、Claude Desktop、モバイル）

コネクターを追加するか、Customize → Connectors → Add custom connectorを開き、https://doklad.ai/mcpを入力してサインインします。コネクターはウェブ、Claude Desktop、モバイルアプリで利用できます。無料プランではカスタムコネクターを1つ利用できます。TeamとEnterpriseでは、オーナーがOrganization settings → Connectorsから追加します。

ChatGPT

Settings → Security and login → Developer modeを有効にし、chatgpt.com/pluginsを開いて**+をクリックします。https://doklad.ai/mcpを入力し、認証方式としてOAuth**を選択してサインインします。Developer modeはPlus、Pro、Business、Enterprise、Eduで利用できます。

Claude Code

claude mcp add --transport http --scope user doklad https://doklad.ai/mcp

次に/mcpを実行し、dokladを選択してAuthenticateを選びます。

Codex（CLI、IDE拡張機能、ChatGPTデスクトップアプリ）

codex mcp add doklad --url https://doklad.ai/mcp
codex mcp login doklad

Cursor

Cursorにインストールするか、~/.cursor/mcp.jsonに追加します。

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

VS Code（GitHub Copilotエージェントモード）

.vscode/mcp.jsonに追加します（VS Code 1.99以降）。

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

Gemini CLI

gemini mcp add --scope user --transport http doklad https://doklad.ai/mcp

次に/mcp auth dokladを実行します。このリポジトリはGemini CLI拡張機能（gemini-extension.json）でもあります。

APIキー（n8n、スクリプト、OAuth非対応のクライアント）

Doklad.aiのIntegrace → API klíče a webhooky → MCP serverからキーを作成し、Authorization: Bearer dk_…として送信します。

claude mcp add --transport http doklad https://doklad.ai/mcp --header "Authorization: Bearer $DOKLAD_API_KEY"

# ~/.codex/config.toml
[mcp_servers.doklad]
url = "https://doklad.ai/mcp"
bearer_token_env_var = "DOKLAD_API_KEY"

Claude Desktopのclaude_desktop_config.jsonではローカルサーバーしか実行できないため、mcp-remoteブリッジを使用します（Node.js 20.18以降）。

{
  "mcpServers": {
    "doklad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://doklad.ai/mcp", "--header", "Authorization:${DOKLAD_AUTH_HEADER}"],
      "env": { "DOKLAD_AUTH_HEADER": "Bearer dk_YOUR_KEY" }
    }
  }
}

ツール

ツール	機能	アクセス
list_invoices	ステータス、顧客、テキスト検索、日付範囲で絞り込んで請求書を一覧表示します	読み取り
get_invoice	明細項目と顧客の詳細を含む請求書を取得します	読み取り
create_invoice	顧客、明細項目（説明、数量、単価、VAT 税率）、支払期日を指定して請求書を作成します	書き込み
update_invoice	請求書を更新します。指定したフィールドのみが変更されます	書き込み
delete_invoice	請求書を削除します（下書きおよびキャンセル済みの請求書のみ）	破壊的
send_invoice_email	顧客に請求書をメールで送信します	書き込み、メール送信
get_invoice_pdf_url	請求書 PDF のダウンロード URL を取得します	読み取り
record_payment	請求書に対して受領済みの支払いを記録します（帳簿上の記入であり、資金は移動しません）	書き込み
list_customers	名前、IČO、メールアドレスで顧客を検索します	読み取り
get_customer	顧客を取得します	読み取り
create_customer	顧客を作成します	書き込み
update_customer	顧客を更新します	書き込み
list_expenses	経費を一覧表示します。ステータスで絞り込むこともできます	読み取り
get_expense	経費を取得します	読み取り
create_expense	経費を記録します	書き込み
get_invoice_stats	請求書の件数（合計、支払い済み、送信済み、期限超過、下書き）を取得します	読み取り
get_cash_flow_summary	指定期間の収益、経費、利益を取得します	読み取り

各ツールには MCP アノテーション（title、readOnlyHint、destructiveHint、openWorldHint）が付与されているため、クライアントはデータを変更するツールやメールを送信するツールを実行する前に確認を求めます。

セキュリティ

• PKCE（S256）を使用する OAuth 2.1、動的クライアント登録（RFC 7591）、再利用検出機能付きのリフレッシュトークンローテーション、RFC 9207 iss に対応しています。ディスカバリー：https://doklad.ai/.well-known/oauth-protected-resource/mcp。
• アクセス権は Doklad.ai の同意ページで会社ごとに付与されます。付与できるのはオーナーと管理者のみです。接続は Integrace → API klíče a webhooky → Připojené aplikace で確認および取り消しができます。
• すべてのツール呼び出しは会社の監査ログに記録されます。トークンと API キーはハッシュとしてのみ保存されます。
• 会社ごとに毎分 60 リクエストまでです。

チェコ語

チェコ語での接続ガイド：**https://doklad.ai/mcp-fakturace**（Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、Gemini CLI、n8n）。

サポート

[email protected] · https://doklad.ai

ライセンス

このリポジトリ内のドキュメントおよび設定ファイルは MIT ライセンスで提供されています。Doklad.ai サービスには、利用規約およびプライバシーポリシーが適用されます。