MCPサーバー v1.2: リソース、プロンプト、構造化された出力

Frihet MCPサーバーのバージョン1.2.1は、単なるツールの追加ではありません。インテリジェンスを追加しました。エージェントが質問することなく税務コンテキストを持てるようにリソースを、介入なしに完全なフローを実行できるようにプロンプトを、そして各応答が決定論的にパースできるように構造化された出力を提供します。

このアップデートにより、MCPサーバーはCRUD操作のブリッジから、AIエージェントのための包括的なビジネス管理インターフェースへと進化します。

リソース：常時利用可能な参照データ

MCPリソースは、エージェントがFrihet APIに呼び出しを行うことなく、いつでも読み取ることができる静的データです。これらは割り当てを消費せず、追加の認証を必要とせず、サーバーが接続された瞬間から利用可能です。

v1.2では、5つのリソースが導入されました。

frihet://api/schema

利用可能なすべてのエンドポイント、認証方法、レート制限の概要です。エージェントがFrihetで何ができるかを知る必要があるとき、試行錯誤で発見するのではなく、このリソースを参照します。

frihet://tax/rates

スペインで適用される税率：標準IVA（21%）、軽減IVA（10%）、超軽減IVA（4%）。カナリア諸島IGIC（7%、3%、0%）。IRPF源泉徴収。エージェントは、請求書を作成したり経費を登録したりする前に、このコンテキストを持っています。あなたのビジネスがどこで運営されているかを知っていれば、どのIVAを適用すべきかを尋ねる必要はありません。

frihet://tax/calendar

四半期ごとの申告書の提出期限：モデル303（IVA）、モデル130（IRPF）、モデル420（IGIC）。エージェントが四半期決算の準備をする際、各義務の期日がいつであるかを正確に把握しています。

frihet://config/expense-categories

控除ルールを含む8つの経費カテゴリ。事務用品、消耗品、交通費、日当、研修費、保険料、専門サービス、その他。各カテゴリには、控除率と適用される条件が含まれます。

frihet://config/invoice-statuses

請求書のステータスフロー：下書き、発行済み、送信済み、回収済み、期限切れ、キャンセル済み。各ステータスには、許可される遷移とトリガー（webhooks、通知）が含まれます。エージェントは、いつでもどの行動が有効であるかを知っています。

プロンプト：ガイド付きワークフロー

ツールは一つの操作を実行します。プロンプトは、複数の操作を一貫したフローでオーケストレーションします。その違いは、「この経費を作成する」から「これら15枚の経費チケットを処理し、分類し、適切な税金を適用し、作成する前に確認する」へと移行するようなものです。

v1.2には5つのプロンプトが含まれています。

monthly-close

ガイド付き月次決算。エージェントは、未回収の請求書を確認し、未割り当ての経費を分類し、期間の納税義務がカバーされていることを確認し、概要を生成します。通常1時間の手動レビューがかかるフローが、会話の中で実行されます。

onboard-client

新規顧客のオンボーディング。顧客の所在地に基づいて税率を決定し（本土IVA、カナリア諸島IGIC、EU域内）、正しい税務データで登録を作成し、ウェルカム見積もりを生成します。すべて一連のシーケンスで。

quarterly-tax-prep

四半期税務準備。期間内のすべての請求書を収集し、IVAまたはIGICの課税標準を計算し、IRPF源泉徴収を適用し、モデル303または130のプレビューを生成します。エージェントが作業を行い、あなたまたはあなたの会計士が結果を検証します。

overdue-followup

期限切れ請求書のフォローアップ。期限切れのすべての請求書を特定し、顧客ごとにグループ化し、各顧客ごとの未払い合計額を計算し、パーソナライズされた回収メッセージを作成します。「誰が私に何を借りているか確認する必要がある」から「ここに送信準備のできた下書きがある」へと。

expense-batch

経費の一括処理。経費リストを受け取り、設定されたルールに従って分類し、該当する税金を適用し、それぞれの控除可能性を確認し、事前の確認を経て作成します。1週間分または旅行で溜まったチケットを処理するのに理想的です。

構造化された出力：パース可能な応答

これまで、MCPサーバーの応答は整形されたテキストでした。人間が読むには便利でしたが、エージェントがプログラム的な意思決定を行うには構造化されたデータが必要です。

v1.2では、各ツールにoutputSchemaとstructuredContentが追加されました。各応答には、返されるデータの構造を正確に記述するJSONスキーマが含まれています。エージェントは、呼び出す前にどのフィールドを受け取るか、それらがどのようなタイプであるか、そしてオプションであるかを把握しています。

これにより、quarterly-tax-prepのようなプロンプトが4つの操作を確実に連結できるようになります。各ステップは既知の構造を持つデータを生成し、次のステップは曖昧さなくそれらを消費できます。

MCPサーバー上に統合を構築する開発者にとって、これは自由形式のテキストをパースする必要性を排除します。応答は常に同じ形式になります。

セキュリティ注釈

MCPサーバーの各ツールには、操作が読み取り専用であるか破壊的であるかを示す注釈が含まれるようになりました。list-invoicesは読み取りとしてマークされます。delete-expenseは破壊的としてマークされます。

これにより、エージェントは確認ポリシーを実装できます。エージェントは尋ねることなく読み取り操作を実行できますが、データを削除または変更する前に明示的な確認を要求することができます。セキュリティはエージェントに依存せず、サーバーによって定義されます。

ユニバーサルインストール

サーバーは、互換性のある任意のエージェントに単一のコマンドでインストールできます。

npx @frihet/mcp-server

Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex、および任意のMCPクライアントで動作します。スキル経由のインストールをサポートするエージェントの場合：

npx skills add Frihet-io/frihet-mcp

どちらの方法でも、30以上のツール、5つのリソース、5つのプロンプト、および構造化された出力にアクセスできます。

Frihet-io下のリポジトリ

MCPサーバーはGitHubのFrihet-io組織に移管されました。リポジトリのURLは現在github.com/Frihet-io/frihet-mcpです。以前のリンクは自動的にリダイレクトされます。

npmパッケージは引き続き@frihet/mcp-serverです。インストールに変更はありません。

このアップデートの対象者

MCPサーバーをすでに使用しているプロフェッショナルは、自動税務コンテキストとしてのリソースと、以前は手動でステップバイステップで実行していたフローとしてのプロンプトを利用できるようになります。

Frihet上に構築する開発者は、決定論的な統合のための構造化された出力と、確認ポリシーのためのセキュリティ注釈を利用できるようになります。

会計事務所や税理士は、月次決算、四半期準備、回収フォローアップなど、ワークフローに特化したプロンプトを利用できるようになります。

AIエージェントを使用するあらゆるビジネスは、単に操作を実行するだけでなく、実際のビジネスフローでそれらを連結する方法を知っているMCPサーバーを利用できるようになります。

更新方法

npx @frihet/mcp-serverを使用している場合、すでに最新バージョンがインストールされています。固定インストールを行っている場合：

npm update @frihet/mcp-server

破壊的な変更はありません。既存のすべてのツールはそのインターフェースを維持します。リソース、プロンプト、構造化された出力は純粋な追加機能です。

完全なドキュメントはdocs.frihet.io/desarrolladoresにあります。GitHubのソースコード（Frihet-io/frihet-mcp）。npmパッケージは@frihet/mcp-serverです。