Kema Invoice について
Kema Invoiceは、フリーランサーや企業向けに、AIエージェント経由で請求業務を管理するリモートMCPサーバーです。請求書、見積書、前受金を扱い、Factur-X請求書を認定プラットフォーム経由で送信します。
主な機能
- 01請求書の作成と追跡
- 02見積書と前受金の管理
- 03クレジットノートと訂正請求書の発行
- 04Factur-X請求書の生成
- 05OAuth 2.1認証
活用シーン
- 01顧客向け請求書の作成と送信
- 02請求書の支払い状況の追跡
- 03承認済み見積書から請求書を作成
MCP 対応
MCPクライアントに請求書、見積書、前受金の操作ツールを提供します。Streamable HTTPとOAuth 2.1を使用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.kema-studio.com/api/mcpclaude mcp add --transport http com-kema-studio-invoice https://mcp.kema-studio.com/api/mcp{"mcpServers":{"com-kema-studio-invoice":{"type":"http","url":"https://mcp.kema-studio.com/api/mcp"}}}Cursor で開く{"servers":{"com-kema-studio-invoice":{"type":"http","url":"https://mcp.kema-studio.com/api/mcp"}}}VS Code で開く{"mcpServers":{"com-kema-studio-invoice":{"type":"http","url":"https://mcp.kema-studio.com/api/mcp"}}}{"mcpServers":{"com-kema-studio-invoice":{"serverUrl":"https://mcp.kema-studio.com/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Kema Invoice MCP コネクター
Kema Invoice は、AI エージェントが Model Context Protocol を通じて操作できる、電子インボイス規制に準拠したソフトウェアです。 リモート MCP サーバーを Claude、Cursor、または任意の MCP クライアントに接続し、OAuth 2.1 で一度認証すれば、エージェントに自然な言葉でインボイス、見積書、前受金請求書の作成、発行、送信、追跡を指示できます。インボイスは Factur-X(EN 16931)形式で生成され、認定プラットフォームを通じて送信されます。インストールは不要です。サーバーは https://mcp.kema-studio.com/api/mcp で稼働しています。
ウェブサイト · ドキュメント · エージェントを接続する · MCP レジストリーのエントリー · フランス語版
このリポジトリについて
このコネクターはリモート MCP サーバーです(Streamable HTTP + OAuth 2.1)。インストールするパッケージはなく、サーバーのコードもここでは公開されていません。このリポジトリには、インテグレーターやディレクトリーに必要なものを収録しています。
| ファイル | 用途 |
|---|---|
tools.json | タイトル、説明、グループ、アクセスに関するヒントを含む 41 個のツール。サーバーコードから生成され、手動で編集されることはありません。 |
server.json | 公式 MCP レジストリー(com.kema-studio/invoice)に公開されている宣言。 |
examples/ | そのまま貼り付けて使えるクライアント設定とプロンプトの手引き。 |
scripts/verify-connection.ts | OAuth フローを実行してツールを一覧表示し、接続をエンドツーエンドで確認する、小規模なオープンソーススクリプト。 |
CHANGELOG.md | コネクターのバージョン。 |
2 分で接続
| クライアント | 方法 |
|---|---|
| claude.ai / Claude Desktop | 「Settings › Connectors › Add custom connector」を開き、https://mcp.kema-studio.com/api/mcp を貼り付けて、一度認証します。 |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | examples/cursor-mcp.json を .cursor/mcp.json に追加します。 |
| 任意の MCP クライアント | Streamable HTTP トランスポートを使用し、上記の URL を指定します。PKCE と動的クライアント登録(RFC 7591)を使用する OAuth 2.1 が必要です。認可サーバーのメタデータは /.well-known/oauth-protected-resource から検出されます。 |
最初の呼び出し時に、auth.kema-studio.com の同意ページが開きます。Kema Invoice アカウントでサインインして承認すると、クライアントにトークンが保存されます。アクセス権は、アプリまたはクライアントからいつでも取り消せます。
まだアカウントをお持ちでない場合は、アカウントを作成してください。10 件のインボイスを含む 14 日間のトライアルを、ユーザー 1 名、クレジットカード不要でご利用いただけます。その後は、すべての機能が含まれる月額 1 ユーザーあたり €10(税抜)の単一プランです。いつでも解約できます。
エージェントでできること
インボイス(16)
| ツール | 機能 | アクセス |
|---|---|---|
create_invoice | 明細項目を含む請求書を会社向けに作成します。この製品では、請求書の作成は発行を意味します。この呼び出しの後、ユーザーに短い概要(クライアント、明細、合計)を提示し、承認を得てから confirm:true を指定して issue_invoice を呼び出してください。ユーザーがアプリで先に確認または編集したいと明示的に希望した場合に限り、下書きのままにしてください。VAT は厳格なサーバー側の税務ルール(シナリオとデフォルト設定)に基づいて自動計算されます。VAT 率をユーザーに尋ねてはいけません。税務シナリオとクライアントのスナップショットは作成時に固定されます。スナップショットには会社の正式名称(legal_name)が含まれ、表示名と異なる場合でも、請求書には正式名称が印字されます。 | write |
issue_invoice | 下書きの請求書を発行します。これは請求書を作成する法的行為です(製品では「Créer la facture」と呼びます)。請求書は確定した法的文書(ステータスは Sent、表示は「Créée」)になります。フランス法の下では取り消し不能であり、クレジットノートによってのみ取り消せます。confirm:true を指定して呼び出す前に、必ず請求書の概要をユーザーに提示し、明示的な承認を得てください。確認を指定しない場合はプレビューが返されます。税務認証はこの呼び出しの内部処理として行われます。呼び出しが戻ったら、請求書が作成されたことだけをユーザーに伝えてください。このツールがエラーを返さない限り、認証、税務ステータス、不変性、処理についてユーザーに伝えてはいけません。 | write, destructive |
list_invoices | 認証済みテナントの請求書を新しい順に一覧表示します。ステータス、書類の種類、請求書番号またはクライアント名による全文検索で絞り込めるほか、ページネーションにも対応しています。 | read |
get_invoice | 指定された ID の請求書を、明細項目、クライアント、合計とともに取得します。呼び出し元に表示権限がない請求書の場合は、null 形式のエラーを返します。 | read |
get_invoice_pdf | 請求書の PDF をダウンロードするための、一時的な(1 時間有効の)署名付き URL を返します。呼び出し元が閲覧できるすべての書類で使用できます。インポートされた請求書の場合はアップロード済みファイルが返されます。Kema Invoice で(アプリまたはエージェントによって)発行された請求書は、ワークスペースのブランド設定を使用してサーバー側で生成され、認証後は Factur-X XML が埋め込まれます。下書きも生成されます(is_draft: true が設定されます)が、まだ法的文書ではありません。 | read |
update_invoice | 下書きの請求書のフィールド(日付、支払条件、備考、または会社の再割り当て)を更新します。変更できるのは下書きの請求書のみです。Sent/認証済みの請求書は変更できません。 | write |
delete_invoice | 下書きの請求書を論理削除します。ユーザーから見て取り消し不能です。実際に削除するには confirm:true を指定して呼び出してください。指定しない場合は、削除対象のプレビューが返されます。 | write, destructive |
cancel_invoice | 下書きの請求書をキャンセルします(ステータス → Cancelled)。取り消し不能です。発行済みの書類(Sent、Overdue、Paid)は税務記録であり、直接キャンセルできません。create_credit_note を使用すると、認証済みのクレジットノート(avoir)が発行され、元の請求書がキャンセルされます。実行するには confirm:true を指定して呼び出してください。指定しない場合はプレビューが返されます。 | write, destructive |
mark_invoice_paid | Sent または Overdue の請求書を Paid にします。任意で支払日を設定できます(デフォルトは現在の日付です)。 | write |
add_invoice_item | 下書きの請求書に明細項目を追加します。合計は自動的に再計算されます。 | write |
update_invoice_item | 下書きの請求書の明細項目を更新します。合計は自動的に再計算されます。項目 ID は get_invoice または add_invoice_item から取得します。 | write |
delete_invoice_item | 下書きの請求書から明細項目を削除します。合計は自動的に再計算されます。項目 ID は get_invoice または add_invoice_item から取得します。削除するには confirm:true を指定して呼び出してください。指定しない場合は、項目のプレビューが返されます。 | write, destructive |
reorder_invoice_items | 請求書の明細項目の表示順を設定します。希望する順序をすべて指定してください。各項目 ID と、0 から始まる display_order を渡します。項目 ID は get_invoice または add_invoice_item から取得します。 | write |
update_invoice_matter | 請求書に案件(dossier)を紐付ける、または紐付けを解除します。整理のみを目的とする操作のため、請求書が Sent になった後でも実行できますが、Cancelled の請求書には実行できません。紐付けを解除するには matter_id に null を渡します。 | write |
check_certification_status | メンテナンス用ツールです。発行済み書類の税務認証状態を認証プロバイダーから更新し、データベースと整合させます。issue_invoice の後に認証は内部処理として自動的に完了するため、先回りしてこのツールを呼び出してはいけません。また、認証についてユーザーに話題を持ち出してはいけません。ユーザーから認証について明示的に質問された場合、または issue_invoice が認証エラーを返した場合に限り使用してください。 | write |
create_credit_note | クレジットノート(avoir)を発行して Sent または Paid の請求書をキャンセルします。クレジットノートは法的な税務書類であり(元の請求書が認証済みの場合は税務認証されます)、作成後は変更できません。取り消し不能です。confirm:true を指定して呼び出す前に、必ずユーザーの明示的な承認を得てください。確認を指定しない場合はプレビューが返されます。 | write, destructive |
訂正とインポート(3)
| ツール | 説明 | アクセス |
|---|---|---|
rectify_invoice | 送信済みまたは支払い済みの請求書に対する訂正請求書(facture rectificative)を作成します。元の請求書をもとに入力済みの新しい下書き請求書(同じクライアント、上書きしない限り明細項目をコピー)を作成し、法的に元の請求書と紐付けます。訂正請求書が発行された場合に限り、元の請求書は「訂正済み」としてマークされます。confirm:true を指定して呼び出すと作成し、指定しない場合はプレビューを返します。 | 書き込み |
get_rectification_links | 1つの請求書について、訂正の連鎖を返します。訂正請求書の場合は差し替え元の請求書、訂正済みの場合は差し替えた訂正請求書を返します。請求書が連鎖の一部でない場合は、どちらも null です。 | 読み取り |
import_external_invoice | 過去または外部の請求書を、請求書番号(そのまま保持)、合計金額、ステータスとともにインポートします。明細項目はありません。Kema Invoice 以外で発行された過去の請求書の移行に使用してください。新しい請求書の作成には使用しないでください(create_invoice を使用してください)。 | 書き込み |
見積書(5)
| ツール | 説明 | アクセス |
|---|---|---|
create_quote | 会社宛ての下書き見積書(devis)を作成します。見積書は税務書類ではないため、認証は不要です。日付はサーバー側でデフォルト設定されます(発行日は本日、支払期限/有効期限は+30日)。見積書が属する案件 ID(dossier)が必要です。 | 書き込み |
send_quote | 下書き見積書を送信済み(クライアント向けの状態)に変更します。認証は不要です。見積書は商業書類です。テナントがフランスの場合、フランスの B2B 検証(SIREN/VAT)が適用されます。 | 書き込み、破壊的 |
accept_quote | 送信済みの見積書を、クライアントが承諾した状態にします。請求するには、続けて convert_quote_to_invoice を呼び出してください。 | 書き込み、破壊的 |
reject_quote | 送信済みの見積書を、クライアントが拒否した状態にします。これにより見積書のライフサイクルは終了します。適用するには confirm:true を指定して呼び出してください。指定しない場合はプレビューを返します。 | 書き込み、破壊的 |
convert_quote_to_invoice | 承諾済みの見積書から新しい下書き請求書を作成します(明細項目をコピーし、追跡可能性のために source_quote_id を設定します)。その後、請求書は通常のライフサイクルに従います(法的拘束力を持たせるには issue_invoice を使用します)。適用するには confirm:true を指定して呼び出してください。指定しない場合はプレビューを返します。 | 書き込み |
前受金(6)
| ツール | 機能 | アクセス |
|---|---|---|
create_provision | 会社の前受金書類(avance sur honoraires、リテーナー)を下書きステータスで作成します。必要に応じて案件に紐付けられます。発行も認証もされません。法的な発行には send_provision を使用してください。VAT はサーバー側の厳格な税務ルールに基づいて自動計算されるため、VAT 税率をユーザーに尋ねないでください。前受金には独自の PROV 番号体系が使用され、支払い後は最終請求書から差し引けるクライアントクレジットになります(apply_provisions_to_invoice)。 | 書き込み |
send_provision | 下書きの前受金を発行します。これは前受金を作成する法的行為です。前受金は確定した法的書類(ステータスは Sent、PROV 番号体系)となり、フランス法の下で取り消し不能かつ法的拘束力を持ちます。confirm:true を指定して呼び出す前に、必ず前受金の詳細をユーザーに提示し、明示的な承認を得てください。confirm を指定しない場合はプレビューが返されます。税務認証はこの呼び出しの内部処理として行われます。呼び出しが正常に戻ったら、前受金が作成されたことだけをユーザーに伝えてください。このツールがエラーを返さない限り、認証、税務ステータス、不変性、処理についてユーザーに決して言及しないでください。 | 書き込み、破壊的 |
mark_provision_paid | 発行済みの前受金(ステータスが Sent/Overdue)を Paid にします。支払い済みの前受金はクライアントクレジットとなり、apply_provisions_to_invoice を使用して、そのクライアントの最終請求書から差し引けます。 | 書き込み |
list_available_provisions | まだ最終請求書に適用されていない、支払い済みの前受金(avances sur honoraires、リテーナー)を一覧表示します。これは差し引き可能なクライアントクレジットです。matter_id を指定しない場合は、案件に紐付いていない独立したリテーナー(通常、Kema Invoice ではこちら)を一覧表示します。matter_id を指定した場合は、その案件のリテーナーを一覧表示します。apply_provisions_to_invoice の前に使用してください。 | 読み取り |
apply_provisions_to_invoice | 同じクライアントの(案件が紐付いている場合は同じ案件の)最終請求書の下書きから、1 件以上の支払い済み前受金を差し引きます。請求書の advances_total と amount_due を更新します。請求書がまだ下書きであれば取り消し可能です(remove_provision_from_invoice)。 | 書き込み |
remove_provision_from_invoice | 最終請求書の下書きから前受金を切り離し、advances_total/amount_due を再計算します。前受金は再びその案件で利用可能になります。 | 書き込み |
顧客(5)
| ツール | 機能 | アクセス |
|---|---|---|
list_companies | 認証済みテナントの顧客企業(名称、メールアドレス、VAT/税務 ID、国)を一覧表示します。他の検索に先立ち、会社 ID を特定するのに便利です。 | 読み取り |
get_company | 1 社の顧客企業について、請求に関係する情報一式(法人情報、VAT/SIREN、住所、連絡先、顧客プロフィールの分類)を取得します。 | 読み取り |
create_company | テナントに顧客企業を作成します。B2B として後で請求するには VAT/税務 ID が必要です。 | 書き込み |
update_company | 既存の顧客企業の項目(名称、連絡先情報、住所、VAT 番号、SIREN)を更新します。指定した項目のみが変更されます。この顧客の請求書を認証する前に、VAT 番号/SIREN/住所を修正する必要があることがよくあります。 | 書き込み |
delete_company | 顧客企業をソフト削除します。連絡先が紐付いている場合は実行できません。削除するには confirm:true を指定して呼び出してください。指定しない場合はプレビューが返されます。 | 書き込み、破壊的 |
顧客プロフィール(3)
| ツール | 機能 | アクセス |
|---|---|---|
get_invoice_client_profile | 会社ごとの請求デフォルト設定(支払条件、送付チャネル、カスタム請求書プレフィックス)を取得します。会社にプロフィールがない場合は {profile: null} を返します。プロフィールは必要になった時点で作成されます。 | 読み取り |
upsert_invoice_client_profile | 会社の請求デフォルト設定(支払条件、送付チャネル、請求書プレフィックス)を作成または更新します。この設定は、そのクライアントの今後の請求書に事前入力されます。 | 書き込み |
delete_invoice_client_profile | 会社の請求デフォルト設定を削除します(会社自体は変更されません)。実際に削除するには confirm:true を指定して呼び出してください。指定しない場合はプレビューが返されます。 | 書き込み、破壊的 |
レポート(3)
| ツール | 内容 | アクセス |
|---|---|---|
get_revenue_summary | 収益の数値を集計します。期間中の入金額(支払日ベース)、現在の未回収額と延滞額(特定時点の値)、期間中に発行した書類、下書きの件数、クレジットノートによる純影響を確認できます。デフォルトは当月です。 | 読み取り |
get_settings | テナントの請求設定を読み取り専用で取得します。法人情報、税務上の国と制度、既定のVAT率と支払条件、請求先メールアドレス、呼び出し元のUI言語が含まれます。設定を変更できるのはアプリからのみです。 | 読み取り |
list_mcp_activity | テナントの最近のエージェントアクティビティログです。MCP ツールの呼び出しが成功するたびに1件記録されます(ツール名、判明している場合は関連する請求書番号、タイムスタンプ)。新しい順に表示されます。 | 読み取り |
サーバーが従う設計ルール:各ツールのタイトルは1つ、読み取りには readOnlyHint、書き込みには明示的な destructiveHint を設定し、すべてのパラメーターに説明を付け、すべての結果に outputSchema と structuredContent を含めます。ツール名は固定されています。プロンプトや自動化は、バージョンが変わっても引き続き動作します。
アクティブなサブスクリプションがない場合やクォータに達した場合、拒否された呼び出しはトランスポートエラーではなく、モデル向けに記述されたツール結果として返されます。コネクターは接続を維持し、ツールの一覧も引き続き表示します。
お試しください
ご利用の言語でエージェントに指示してください。
- 「Dupont SARLに、1日あたり800ユーロで3日分のコンサルティング料を請求してください。」
- 「未払いの請求書を一覧表示し、FAC-2026-0412を支払済みにしてください。」
- 「見積書DEV-2026-0031を請求書に変換して送信してください。」
詳しくはexamples/prompts.mdをご覧ください。
コンプライアンスとデータ
- 請求書はFactur-X(EN 16931 XMLを埋め込んだPDF/A-3)として作成され、認定プラットフォームを通じて送信されます。フランスの電子請求書義務に対応しています。
- データは欧州連合内でホストされます(データベースと認証はAWS eu-north-1(ストックホルム)、エッジとストレージはEU内)。サブプロセッサーとデータ保持期間については、プライバシーポリシーをご覧ください。
- すべてのMCP呼び出しは、アプリ内のエージェントアクティビティに記録されるため、エージェントの実行内容をいつでも確認できます。
- 利用規約 · 法的通知
接続を確認する
git clone https://github.com/Kema-Studio/kema-invoice-mcp && cd kema-invoice-mcp
npm install
npm run verify # opens the consent page, then lists the tools
サポート
- アカウントや請求書に関するご質問:アプリ内のサポート(「Help」ボタン)、または[email protected]までお問い合わせください。
- コネクター自体の不具合(ツールのエラー、スキーマの問題):イシューを作成してください。
ライセンス
このリポジトリの内容(ドキュメント、サンプル、スクリプト)は、MITライセンスのもとで公開されています。Kema Invoiceサービスとそのサーバーは、Kema Studioのプロプライエタリーソフトウェアです。
フランス語版
Kema Invoiceは、AIエージェントがModel Context Protocolを通じて操作する、コンプライアンスに準拠した電子請求書ソフトウェアです。 リモートMCPサーバーをClaude、Cursor、または任意のMCPクライアントに接続し、OAuth 2.1で一度認証すれば、エージェントに自然言語で請求書、見積書、前払請求書の作成、発行、送信、追跡を指示できます。請求書はFactur-X(EN 16931)形式で作成され、認定プラットフォームを通じて送信されます。インストールは不要です。サーバーはhttps://mcp.kema-studio.com/api/mcpで応答します。
接続する
| クライアント | 方法 |
|---|---|
| claude.ai / Claude Desktop | 設定 › コネクター › カスタムコネクターを追加し、https://mcp.kema-studio.com/api/mcpを貼り付けて、一度だけ認証します。 |
| Claude Code | claude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp |
| Cursor | examples/cursor-mcp.jsonを.cursor/mcp.jsonに追加します。 |
| その他のMCPクライアント | Streamable HTTPトランスポート、PKCEを使用したOAuth 2.1、クライアントの動的登録(RFC 7591)。 |
まだアカウントをお持ちでない場合は、作成してください。14日間の無料トライアルには請求書10件、ユーザー1名分が含まれ、クレジットカードは不要です。その後は、全機能込みでユーザー1名あたり月額10 €(税別)のプランのみとなり、契約期間の縛りはありません。
エージェントでできること
請求書(16)
| ツール | 内容 | アクセス |
|---|---|---|
create_invoice | 明細項目を含む会社宛ての請求書を作成します。この製品では、請求書の作成は発行を意味します。この呼び出しの後、ユーザーに短い概要(クライアント、明細、合計)を提示し、承認を得てから confirm:true を指定して issue_invoice を呼び出してください。ユーザーがアプリで先に確認または編集したいと明示した場合に限り、下書きとして保存してください。VAT は厳格なサーバー側の税務ルール(シナリオ+デフォルト値)に基づいて自動計算されます。VAT 税率をユーザーに尋ねてはいけません。税務シナリオとクライアントのスナップショットは作成時に固定されます。スナップショットには会社の正式名称(legal_name)が含まれ、表示名と異なる場合でも、請求書には正式名称が印字されます。 | 書き込み |
issue_invoice | 下書きの請求書を発行します。これは請求書を作成する法的行為です(製品では「請求書を作成」と呼びます)。請求書は正式な法的文書(ステータスは「送信済み」、表示上は「作成済み」)となります。フランス法のもとでは取り消し不能で、取り消すにはクレジットノートのみが有効です。confirm:true を指定して呼び出す前に、必ず請求書の概要をユーザーに提示し、明示的な承認を得てください。確認なしの場合はプレビューを返します。税務認証はこの呼び出しの内部処理として行われます。呼び出しが完了したら、請求書が作成されたことだけをユーザーに伝えてください。このツールがエラーを返した場合を除き、認証、税務ステータス、不変性、処理についてユーザーに絶対に言及しないでください。 | 書き込み、破壊的 |
list_invoices | 認証済みテナントの請求書を新しい順に一覧表示します。ステータス、文書種別、請求書番号またはクライアント名を対象とするフリーテキスト検索による絞り込みに加え、ページネーションに対応しています。 | 読み取り |
get_invoice | ID を指定して、明細項目、クライアント、合計を含む単一の請求書を取得します。呼び出し元に表示権限がない請求書の場合は、null 形式のエラーを返します。 | 読み取り |
get_invoice_pdf | 請求書 PDF の一時的な署名付きダウンロード URL(有効期間 1 時間)を返します。呼び出し元に表示権限のあるすべての文書で利用できます。インポートした請求書の場合はアップロード済みファイルが返されます。Kema Invoice で(アプリまたはエージェントによって)発行された請求書は、ワークスペースのブランディングを適用してサーバー側でレンダリングされ、認証後は Factur-X XML が埋め込まれます。下書きもレンダリングされます(is_draft: true のフラグ付き)が、まだ法的文書ではありません。 | 読み取り |
update_invoice | 下書きの請求書のフィールド(日付、支払条件、メモ、会社の再割り当て)を更新します。変更できるのは下書きの請求書のみです。送信済み/認証済みの請求書は不変です。 | 書き込み |
delete_invoice | 下書きの請求書を論理削除します。ユーザーから見て元に戻せません。実際に削除するには confirm:true を指定して呼び出してください。指定しない場合は、削除対象のプレビューを返します。 | 書き込み、破壊的 |
cancel_invoice | 下書きの請求書を取り消します(ステータス → 取消済み)。元に戻せません。発行済みの文書(送信済み、期限超過、支払済み)は税務記録であり、そのまま取り消すことはできません。create_credit_note を使用して、認証済みクレジットノート(avoir)を発行し、元の請求書を取り消してください。実行するには confirm:true を指定して呼び出してください。指定しない場合はプレビューを返します。 | 書き込み、破壊的 |
mark_invoice_paid | 送信済みまたは期限超過の請求書を支払済みにします。任意で支払日を設定できます(デフォルトは現在日時です)。 | 書き込み |
add_invoice_item | 下書きの請求書に明細項目を追加します。合計は自動的に再計算されます。 | 書き込み |
update_invoice_item | 下書きの請求書の明細項目を更新します。合計は自動的に再計算されます。項目 ID は get_invoice または add_invoice_item から取得できます。 | 書き込み |
delete_invoice_item | 下書きの請求書から明細項目を削除します。合計は自動的に再計算されます。項目 ID は get_invoice または add_invoice_item から取得できます。削除するには confirm:true を指定して呼び出してください。指定しない場合は、項目のプレビューを返します。 | 書き込み、破壊的 |
reorder_invoice_items | 請求書の明細項目の表示順を設定します。希望する順序をすべて渡してください。各項目 ID と 0 始まりの display_order が必要です。項目 ID は get_invoice または add_invoice_item から取得できます。 | 書き込み |
update_invoice_matter | 請求書に案件(dossier)を関連付ける、または関連付けを解除します。整理目的のみの操作で、請求書が送信済みになった後でも可能ですが、取消済みの請求書には適用できません。関連付けを解除するには matter_id に null を渡してください。 | 書き込み |
check_certification_status | メンテナンスツール:認証プロバイダーから発行済み文書の税務認証状態を更新し、データベースに反映します。認証は issue_invoice の後に自動で完了する内部処理です。先回りして呼び出してはいけません。また、認証についてユーザーに言及してはいけません。ユーザーが認証について明示的に尋ねた場合、または issue_invoice が認証エラーを返した場合にのみ使用してください。 | 書き込み |
create_credit_note | クレジットノート(avoir)を発行して、送信済みまたは支払済みの請求書を取り消します。クレジットノートは法的な税務文書であり(元の請求書が認証済みの場合は税務認証されます)、作成後は不変です。取り消し不能です。confirm:true を指定して呼び出す前に、必ずユーザーの明示的な承認を得てください。確認なしの場合はプレビューを返します。 | 書き込み、破壊的 |
訂正およびインポート(3)
| ツール | 説明 | アクセス |
|---|---|---|
rectify_invoice | 送付済みまたは支払い済みの請求書に対する訂正請求書(facture rectificative)を作成します。元の請求書から事前入力された新規の下書き請求書で、同じクライアントが設定され、明細項目は上書きしない限り複製され、元の請求書と法的に紐付けられます。元の請求書が「訂正済み」になるのは、訂正請求書が発行されたときのみです。作成するには confirm:true を指定します。指定しない場合はプレビューが返されます。 | 書き込み |
get_rectification_links | 1件の請求書について、訂正の連鎖を返します。訂正請求書の場合は置き換え元の請求書を、訂正済みの場合は置き換えた訂正請求書を返します。請求書が連鎖に含まれない場合は、どちらも null です。 | 読み取り |
import_external_invoice | 過去または外部の請求書を、独自の請求書番号(そのまま保持)、合計額、ステータスとともにインポートします。明細項目は含まれません。Kema Invoice 外で発行された過去の請求書の移行に使用します。新しい請求書の作成には使用しないでください(create_invoice を使用してください)。 | 書き込み |
見積書(5)
| ツール | 説明 | アクセス |
|---|---|---|
create_quote | 会社の下書き見積書(devis)を作成します。見積書は税務書類ではないため、認証はありません。日付はサーバー側でデフォルト設定されます(発行日は当日、支払期限/有効期限は30日後)。見積書が属する案件(dossier)の ID が必要です。 | 書き込み |
send_quote | 下書き見積書を送付済みに変更します(クライアントに表示される状態です)。認証は不要です。見積書は商取引書類です。テナントがフランスの場合、フランスの B2B 検証(SIREN/VAT)が適用されます。 | 書き込み、破壊的 |
accept_quote | 送付済みの見積書を、クライアントが承認したものとしてマークします。請求するには、続けて convert_quote_to_invoice を使用してください。 | 書き込み、破壊的 |
reject_quote | 送付済みの見積書を、クライアントが却下したものとしてマークします。これにより見積書のライフサイクルが終了します。適用するには confirm:true を指定します。指定しない場合はプレビューが返されます。 | 書き込み、破壊的 |
convert_quote_to_invoice | 承認済みの見積書から新しい下書き請求書を作成します(明細項目が複製され、追跡可能性のために source_quote_id が設定されます)。その後、請求書は通常のライフサイクルに従います(法的拘束力を持たせるには issue_invoice を使用します)。適用するには confirm:true を指定します。指定しない場合はプレビューが返されます。 | 書き込み |
前払金(6)
| ツール | 内容 | アクセス |
|---|---|---|
create_provision | 会社向けの前払金書類(報酬の前払い、リテイナー)を下書きステータスで作成します。任意で案件に関連付けることもできます。発行や認証は行われません。法的に発行するには send_provision を使用してください。VAT は厳格なサーバー側の税務ルールに基づいて自動計算されます。VAT 税率をユーザーに尋ねてはいけません。前払金には専用の PROV 番号系列が使用され、支払い済みになると、最終請求書から差し引けるクライアントクレジットになります(apply_provisions_to_invoice)。 | 書き込み |
send_provision | 下書きの前払金を発行します。これは前払金を作成する法的行為です。前払金は確定的な法的文書(ステータスは Sent、PROV 番号系列)となり、フランス法の下で取り消し不能かつ法的拘束力を持ちます。confirm:true を指定して呼び出す前に、必ず前払金の詳細をユーザーに表示し、明示的な承認を得てください。confirm を指定しない場合はプレビューが返されます。税務上の認証はこの呼び出し内で行われる内部処理です。呼び出しが戻ったら、前払金が作成されたことだけをユーザーに伝えてください。このツールがエラーを返さない限り、認証、税務ステータス、不変性、処理についてユーザーに伝えてはいけません。 | 書き込み、破壊的 |
mark_provision_paid | 発行済みの前払金(ステータスが Sent/Overdue)を支払い済みにします。支払い済みの前払金はクライアントクレジットとなり、apply_provisions_to_invoice を使って、そのクライアントの最終請求書から差し引けます。 | 書き込み |
list_available_provisions | まだ最終請求書に適用されていない支払い済み前払金(報酬の前払い、リテイナー)、つまり差し引き可能なクライアントクレジットを一覧表示します。matter_id を指定しない場合は、案件に関連付けられていないリテイナー(通常のケース)を一覧表示します。指定した場合は、その案件のリテイナーを一覧表示します。apply_provisions_to_invoice の前に使用してください。 | 読み取り |
apply_provisions_to_invoice | 同じクライアントの下書き最終請求書から、1 件以上の支払い済み前払金を差し引きます(案件が関連付けられている場合は、同じ案件である必要があります)。請求書の advances_total と amount_due が更新されます。請求書がまだ下書きであれば元に戻せます(remove_provision_from_invoice)。 | 書き込み |
remove_provision_from_invoice | 下書き最終請求書から前払金を取り外し、advances_total/amount_due を再計算します。前払金は、その案件で再び利用可能になります。 | 書き込み |
クライアント(5)
| ツール | 内容 | アクセス |
|---|---|---|
list_companies | 認証済みテナントのクライアント企業(名称、メールアドレス、VAT/税務 ID、国)を一覧表示します。他の検索の前に会社 ID を特定する際に便利です。 | 読み取り |
get_company | 請求に関係する完全な情報(法的な法人情報、VAT/SIREN、住所、連絡先、クライアントプロファイルの分類)を含む顧客企業を 1 件取得します。 | 読み取り |
create_company | テナントに顧客企業を作成します。後で B2B として請求するには VAT/税務 ID が必要です。 | 書き込み |
update_company | 既存のクライアント企業の項目(名称、連絡先情報、住所、VAT 番号、SIREN)を更新します。指定した項目のみ変更されます。このクライアントへの請求書を認証する前に、VAT 番号/SIREN/住所を修正する必要がある場合がよくあります。 | 書き込み |
delete_company | クライアント企業をソフト削除します。連絡先がまだ関連付けられている場合は実行できません。削除するには confirm:true を指定して呼び出してください。指定しない場合はプレビューが返されます。 | 書き込み、破壊的 |
クライアントプロファイル(3)
| ツール | 内容 | アクセス |
|---|---|---|
get_invoice_client_profile | 会社ごとの請求書の既定値(支払条件、送付チャネル、カスタム請求書プレフィックス)を取得します。会社にプロファイルがない場合は {profile: null} を返します。プロファイルは必要に応じて作成されます。 | 読み取り |
upsert_invoice_client_profile | 会社の請求書の既定値(支払条件、送付チャネル、請求書プレフィックス)を作成または更新します。この既定値は、そのクライアント向けの今後の請求書にあらかじめ入力されます。 | 書き込み |
delete_invoice_client_profile | 会社の請求書の既定値を削除します(会社自体には影響しません)。実際に削除するには confirm:true を指定して呼び出してください。指定しない場合はプレビューが返されます。 | 書き込み、破壊的 |
運用管理(3)
| ツール | 機能 | アクセス |
|---|---|---|
get_revenue_summary | 収益の概要を集計します:期間中に回収した金額(支払日基準)、現在の未払い額と延滞額(特定時点の値)、期間中に発行した書類、下書きの件数、クレジットノートによる純影響額を表示します。デフォルトでは当月が対象です。 | 読み取り |
get_settings | テナントの請求設定の読み取り専用スナップショットを取得します:法的な事業者情報、税務上の国と制度、デフォルトのVAT税率と支払条件、請求先メールアドレス、呼び出し元のユーザーのUI言語を表示します。設定を変更できるのはアプリからのみです。 | 読み取り |
list_mcp_activity | テナントの最近のエージェントのアクティビティログを取得します:MCP ツール呼び出しが正常に完了するたびに1件記録されます(ツール名、判明している場合は関連する請求書番号、タイムスタンプ)。新しい順に表示されます。 | 読み取り |
コンプライアンスとデータ
Factur-X の請求書(XML EN 16931を含むPDF/A-3)は、認定プラットフォーム経由で送信されます。データは欧州連合内でホストされます(データベースと認証はAWS eu-north-1、ストックホルム)。すべてのMCP呼び出しはアプリのエージェントのアクティビティに記録されます。プライバシーポリシー · 利用規約 · 法的情報。
サポート
アカウントと請求書について:アプリ内(ヘルプボタン)または [email protected] からお問い合わせください。コネクターのバグ:イシューを作成してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。