Servicialo — Open Protocol for AI-Coordinated Services
ローカルServicialo — Open Protocol for AI-Coordinated Services について
Servicialoは、AIエージェントによるプロフェッショナルサービスの調整プラットフォームを構築する開発者向けのオープンプロトコルです。互換プラットフォーム間で、予約、本人確認、提供証拠、決済、需要シグナルの共通モデルを定義します。
主な機能
- 01複数者間の予約調整と例外処理
- 02提供者の本人確認と資格情報
- 03提供証拠と検証
- 04請求と決済
- 05集約された需要シグナル
活用シーン
- 01互換サービスプラットフォームの構築
- 02複数の提供者にまたがる予約調整
- 03完了したサービスの証拠管理
- 04請求と支払いフローのモデル化
MCP 対応
READMEではMCP Serverに言及していますが、その機能やMCPクライアントに公開する内容は説明されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
15掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| vertical | string | いいえ | サービスの業種です。一般的な値:tecnologia、consultoria、kinesiologia、psicologia、dental、nutricion、fonoaudiologia、terapia-ocupacional、medicina、veterinaria、educacion、fitness、legal、belleza、hogar。省略すると、すべての業種を検索します。 |
| location | string | いいえ | 絞り込みに使用する市区町村または地区(例:"santiago"、"providencia")。省略すると、国全体の検索結果が返されます。 |
| country | string | いいえ | ISO 3166-1 alpha-2 国コード(例:"cl"、"mx"、"ar")。デフォルト:"cl" |
| limit | number | いいえ | 返す結果の最大数(1~100)。デフォルト:10 |
詳細
Servicialo
AI エージェント時代のサービス経済を支えるオーケストレーション層
専門サービスのスケジュール調整、本人確認、提供完了の検証
および金融決済のためのオープンプロトコルです。
Protocolo abierto Legible por máquinas Agent-native Apache-2.0
ウェブサイト ・ 仕様 ・ ガバナンス ・ MCP サーバー ・ npm
Servicialo を初めてお使いですか?こちらから → SPEC.md
仕様の完全版(クローラー対応):https://servicialo.com/spec
プロトコル仕様
アーキテクチャ、メッセージフロー、データモデルの正式な説明については、以下をご覧ください。
- ホワイトペーパー v0.9 — プロトコルの正式な仕様
- プロトコルリポジトリ — スキーマ、RFC、参考資料
- PROTOCOL.md — このリポジトリ内の完全な仕様
プロトコル単位
このプロトコルでは、イベントプリミティブ(SC、CAC)と課金モデル(SC、CAC、RAC)を区別します。完全な定義については、GLOSSARY.mdをご覧ください。
どこから始めればよいですか?
サービス事業者で、AI エージェントに自分のサービスを見つけてもらい、予約してもらいたい → このリポジトリではなく、プロトコルに準拠したプラットフォームが必要です。Coordinaloはリファレンス実装です。プロトコルの成熟に伴い、準拠するプラットフォームがさらに増えることを期待しています。
プロトコルに準拠したプラットフォームを構築したい開発者
→ このままお読みください。IMPLEMENTING.mdから始めましょう。
課題
標準プロトコルがなければ、サービスプラットフォームごとに独自の言語を使うことになります。診療予約、自宅修理の完了確認、法律相談の料金回収を行いたいAI エージェントには、それぞれ個別の連携が必要です。データはサイロ化し、相互運用にはカスタム連携が必要となり、サービス提供に関する集合知も形成されません。
Servicialo は共通プロトコルです。 追加の連携を必要とせず、あらゆるAI エージェントが、準拠するあらゆるプラットフォーム上で、あらゆる専門サービスを調整できるよう、実用最小限のスキーマを定義します。
プロトコルのプリミティブ
Servicialo は、4 つの調整プリミティブを定義します。これらを組み合わせることで、専門サービス提供のバリューチェーン全体をカバーします。
| プリミティブ | 解決する課題 | プロトコルの範囲 |
|---|---|---|
| スケジュール調整 | 複数当事者(プロバイダー、クライアント、リソース)の空き状況の照合と例外処理 | 6+3 のライフサイクル、6 つの例外フロー、3 変数のスケジューラー |
| 本人確認 | プロバイダーの認証情報、信頼スコア、クライアントと支払者の分離 | プロバイダー認証情報、trust_score、payer_id の分離 |
| 金融決済 | 紛争解決を伴う請求、回収、決済、収益分配 | 課金の次元、サービスオーダー台帳、payment_schedule |
| 需要シグナル | ネットワークノード間で匿名化・集計された運用テレメトリー | テレメトリー拡張(貢献してアクセスするモデル) |
各プリミティブは独立して仕様化されています。実装者は必要なものを採用できます。
サービスとは
サービスとは、特定の時と場所で提供される、変化をもたらす約束です。
製品とは異なり、サービスは保管、転売、返品ができません。提供された瞬間に消費されます。その点で根本的に異なるため、独自のプロトコルが必要です。
サービスは、次の3つの源から生まれます。
| 起源 | 主な問い | 例 |
|---|---|---|
| 資産から | 他の人が必要としている、あなたが持っているものは何ですか? | 空室のアパート → 一時的な宿泊 |
| 強みから | 他の人が知らない、あなたの知識は何ですか? | キネシオロジーの認定資格 → スポーツリハビリテーション |
| あなたの時間から | 他の人がしたくない、またはできないことで、あなたにできることは何ですか? | 空いている時間 → プロによる清掃 |
8つの次元
キネシオロジーの施術から税務監査まで、あらゆるプロフェッショナルサービスは、同じ8つの次元でモデル化されます。
| 次元 | 記録する内容 | 例 | |
|---|---|---|---|
| 1 | 何を | 提供する活動または成果 | キネシオロジーの施術、電気設備の修理 |
| 2 | 誰が提供するか | 資格情報を含むサービス提供者 | 認定キネシオロジスト、SEC認定電気技師 |
| 3 | 誰が受けるか | クライアント — 支払者は明示的に分けて記録 | 患者(FONASAが支払う)、従業員(会社が支払う) |
| 4 | いつ | 合意した時間枠 | 2026-02-10の10:00から10:45まで |
| 5 | どこで | 物理的または仮想的な場所。物理的リソース(3.5b:部屋、診察室、椅子、設備)を参照する任意のresource_idを含みます | クリニックの3号室、自宅、ビデオ通話 |
| 6 | サイクル | 状態の次元(提供、証拠、承認、精算)における現在の位置 | 完了 · 証拠を記録済み · 請求待ち |
| 7 | 証拠 | サービスが実施されたことを裏付ける方法 | GPS + 所要時間 + クライアントの署名 |
| 8 | 請求 | サイクルとは独立した金銭の精算 | $35.000 CLP · 請求済み · 前払いパッケージ |
支払者がクライアントとは限りません。 医療では保険会社が支払います。企業向けサービスでは会社が支払います。教育では保護者が支払います。実際にはほとんどの場合、同一人物ではないため、プロトコルではクライアントと支払者を明示的に分けています。
ライフサイクル:必須の6つの状態 + 任意の3つの金銭関連状態
このプロトコルでは、調整のライフサイクル全体を把握するため、互いに独立した状態を定義しています。以下の9つの節目は標準的な成功ルート、つまり最も一般的な運用経路であり、必須の一律な順序ではありません。最初の6つは必須で、金銭関連の3つは任意の拡張です。提供、証拠、承認、精算はそれぞれ独立して進行します(PROTOCOL.md §6.0):
Solicitado → Agendado → Confirmado → En Curso → Completado → Documentado → (opcional) Facturado → Cobrado → Verificado
| # | 状態 | 内容 |
|---|---|---|
| 1 | 依頼済み | クライアントまたはそのエージェントが、必要な内容、日時、場所を定義します |
| 2 | 予約済み | 時間、提供者、場所が割り当てられます。時間枠が確保されます |
| 3 | 確認済み | 双方が約束を確認します |
| 4 | 進行中 | チェックインが検出されます。サービスが提供されています |
| 5 | 完了 | 提供者がサービスの提供完了を記録します |
| 6 | 文書化済み | 診療記録、報告書、議事録などの正式な記録が作成されます |
| 7 | 請求書発行済み | 税務書類が発行されます |
| 8 | 入金済み | 支払いが受領され、確認されます |
| 9 | 検証済み | クライアントが確認します — サイクルの終了 |
検証済みが終了状態です。 クライアントは、文書化された証拠、発行された請求書、適用された支払いがそろうまで検証できません。早すぎる検証を求めると、正式な記録がまだない内容をクライアントに確認させることになります。
例外は当たり前です
例外はまれなケースではありません。**予約の15~30%**で発生します。適切に設計されたサービスでは、計画どおりに進まなかった場合の対応を定義します。
| 例外 | 遷移 | 発生すること |
|---|---|---|
| 顧客の無断キャンセル | 確定 → キャンセル | 違約金が適用され、提供者の時間枠が解放されます |
| 提供者の無断キャンセル | 確定 → 再割り当て中 → 予約済み | 代替の提供者が自動的に探されます |
| キャンセル | 引き渡し前の任意の状態 → キャンセル | 合意済みのキャンセルポリシーが適用されます |
| 品質に関する異議申し立て | 完了 → 異議申し立て中 | 請求が保留され、証拠が求められます |
| 予約変更 | 予約済み/確定 → 変更中 → 予約済み | 可能であれば同じ提供者が維持されます。リソースの競合(二重予約、リソースの利用不可)も含まれます |
| 一部引き渡し | 進行中 → 一部完了 | 引き渡した内容が記録され、請求額が調整されます |
サービスとサービスオーダー
このプロトコルは、2つのオブジェクトとその関係に基づいて構築されています。
Organización
└── Orden de Servicio ← acuerdo comercial (opcional)
├── alcance qué servicios, cuántos, de qué tipo
├── precio cómo se calcula el valor
├── esquema de pagos cuándo se mueve el dinero
└── Servicios ← unidades atómicas de entrega
└── 8 dimensiones cada uno
サービス提供は、実行されたアトミックな単位、つまり実際に起きたことを表します。現在のワイヤ形式では、Serviceオブジェクト(互換性維持のため名称はそのまま)で表されます。サービスオーダーは、範囲、価格、支払い方法に基づいて複数の提供をまとめる商業上の合意です。単独の「サービス」はドメイン全般を指す用語であり、4つ目のオブジェクトではありません。
サービスがサービスオーダーに属している場合、その請求額は参考情報です。経済的価値を記録しますが、請求書は発行しません。請求処理はサービスオーダーのみが担います。
同じ構造は、あらゆる業種で機能します。
| 業種 | 例 | 範囲 | 支払い |
|---|---|---|---|
| 医療 | 理学療法プラン | 12回のセッション | セッションごと |
| コンサルティング | 時間契約 | 法律相談40時間 | 利用量に応じて毎月 |
| プロジェクト | 3段階の事前監査 | 定義済みのマイルストーン | 承認済みのマイルストーンごと |
業種別の証拠
各業種では、ポリシーに基づいて、提供の証明となる証拠を定めます。以下のプロファイルは設定可能な例であり、プロトコル共通の要件ではありません。契約ごとに異なる証拠を求めることができ、プライバシー、比例性、規制によって、収集すべき情報の範囲が制限されます。証明は、適用されたポリシーとその確実性のレベルのもとで有効となるものであり、それだけでサービスの品質や個々の主張の絶対的な真実性を判断するものではありません。曖昧さをなくすため、認証可能なサービス証明を作成するための要件を、事前に明示して合意します。
医療 — 4種類の証拠
| 証拠 | 説明 | 取得方法 |
|---|---|---|
| 入室記録 | 到着時のタイムスタンプ、および該当する場合は位置情報 | 自動 |
| 退室記録 | 退出時のタイムスタンプ、および該当する場合は位置情報 | 自動 |
| 署名済み診療記録 | 適用されるポリシーで求められる場合に、提供に関連付けられた文書または証明 | 手動 |
| 計画の遵守状況 | 実施した治療計画のチェックリスト | 手動 |
認証ルールの例: このポリシーが求める証拠(入室/退室記録および署名済み診療記録)がそろっており、有効である場合 → このポリシーのもと、その確実性のレベルで提供が認証されます。診療記録または署名がない場合 → エスカレーションします。
家庭 — 4種類の証拠
| 証拠 | 説明 | 取得方法 |
|---|---|---|
| 作業前の写真 | タイムスタンプと GPS を含む初期状態の写真 | 手動 |
| 作業後の写真 | タイムスタンプと GPS を含む最終結果の写真 | 手動 |
| チェックリスト | 合意した作業を完了済みとして記録 | 手動 |
| 顧客の署名 | 受領を確認する顧客のデジタル署名 | 手動 |
認証ルールの例: 作業前後の写真が有効なメタデータ付きで存在し、チェックリストがすべて完了している場合 → このポリシーのもと、その確実性のレベルで提供が認証されます。顧客の署名がない場合 → エスカレーションします。
法律 — 3種類の証拠
| 証拠 | 説明 | 取得方法 |
|---|---|---|
| 会議議事録 | 協議および合意内容の記録 | 手動 |
| 書類の納品 | 作成した書類の納品確認 | 手動 |
| 作業時間記録 | 請求対象の時間と作業内容の説明 | 手動 |
認証ルールの例: 議事録があり、記録された作業時間が合意した範囲内である場合 → このポリシーのもと、その確実性のレベルで提供が認証されます。作業時間が正当な理由なく合意した範囲を超える場合 → エスカレーションします。
教育 — 3種類の証拠
| 証拠 | 説明 | 取得方法 |
|---|---|---|
| 出席記録 | 生徒と教師の出席確認 | 自動 |
| 教材の提供 | 生徒に提供した教材または課題 | 手動 |
| 評価 | セッションの評価またはフィードバック | 手動 |
認証ルールの例: 出席が記録され、教材が提供されている場合 → このポリシーのもと、その確実性のレベルで提供が認証されます。契約で評価が求められているにもかかわらず、評価がない場合 → エスカレーションします。
紛争解決 — 設計中の拡張機能
紛争モジュール(Servicialo/Disputas)は設計中です。以下のフローは目標とする設計を示すものであり、運用中の機能ではありません。
1. 申立て — いずれの当事者も、定められた期間内に紛争を申し立てます。請求は自動的に凍結されます。
2. 証拠の確認 — 両当事者に追加の証拠を求めます。システムは、記録された証拠を契約と照合します。
3. 解決 — プロバイダーが勝った場合:請求済み → 検証済み。クライアントが勝った場合:キャンセルされ、残高が復元されます。
設計目標: 契約で事前に合意されたルールを証拠が満たすケースの解決を自動化します。証拠だけでは解決できないケースは、人による確認にエスカレーションされます。同じ業種のピアによる仲裁は研究中の取り組みであり、導入済みの仕組みではありません。
MCP サーバー
Servicialo はツールを MCP サーバーとして公開し、AI エージェントが専門サービスをネイティブに検出し、連携できるようにします。
クイックスタート
@servicialo/mcp-server パッケージは、Servicialo 互換プラットフォームの HTTP API に接続するシンクライアントです。デフォルトでは Coordinalo(servicialo.com)を参照します。独自のバックエンドを構築している場合は、SERVICIALO_BASE_URL を使って自身のバックエンドを指定してください。組織の利用者(クリニック、コンサルティング会社など)の場合、認証情報は利用するプラットフォームから取得できます。このパッケージを直接インストールする必要はありません。
npx -y @servicialo/mcp-server
これで、エージェントは認証情報なしで組織を検索し、空き状況を確認し、サービスを一覧表示できます。
認証済みモード
予約、サービス提供の検証、請求までの全サイクルを実行するには:
{
"mcpServers": {
"servicialo": {
"command": "npx",
"args": ["-y", "@servicialo/mcp-server"],
"env": {
"SERVICIALO_API_KEY": "tu_api_key",
"SERVICIALO_ORG_ID": "tu_org_id"
}
}
}
}
認証情報は、各組織が利用する Servicialo 互換プラットフォームから取得します。
エージェントのフェーズ — 40 個のツール
適切に設計されたエージェントは、次の順序で処理します。
| # | フェーズ | 解決すること | ツール |
|---|---|---|---|
| 0 | 解決 | エンドポイントの場所 | resolve.lookup · resolve.search · trust.get_score |
| 1 | 発見 | 利用できるもの | registry.search · registry.get_organization · registry.manifest · scheduling.check_availability · services.list · a2a.get_agent_card |
| 2 | 理解 | サービスの特性とルール | service.get · contract.get |
| 3 | 確約 | クライアントの本人確認と予約 | clients.get_or_create · scheduling.book · scheduling.confirm |
| 4 | 管理 | 状態と遷移 | lifecycle.get_state · lifecycle.transition · scheduling.reschedule · scheduling.cancel |
| 5 | 検証 | 実施されたことの証拠 | delivery.checkin · delivery.checkout · delivery.record_evidence |
| 6 | 完了 | 書類作成と支払い | documentation.create · payments.create_sale · payments.record_payment · payments.get_status |
| — | リソース | 物理的なスペースと設備 | resource.list · resource.get · resource.create · resource.update · resource.delete · resource.get_availability |
| — | 管理者向け解決 | ポータビリティとテレメトリ | resolve.register · resolve.update_endpoint · telemetry.heartbeat |
| — | ネットワークインテリジェンス | 匿名化された市場ベンチマーク | market.list_segments · market.get_benchmark |
| — | 探索(コールドスタート) | 事前知識なしで把握できる分類体系 — どの業種、地域、イベント種別が存在するか | registry.list_verticals · registry.list_regions · registry.list_event_types |
サーバーは、プロトコルの統計情報を収集するため、起動時に匿名のテレメトリを送信します。SERVICIALO_TELEMETRY=false で無効にできます。また、認証済みのサーバーは、ネットワークベンチマーク用の運用テレメトリをバケット化して送信します。SERVICIALO_OPERATIONAL_TELEMETRY=false でオプトアウトできます。詳しくは docs/telemetry-operational.md をご覧ください。
このプロトコルにより、どのエージェントでも、互換性のある任意の実装を使って一連の処理を最初から最後まで完了できます。
完全な例
キネシオロジーの施術 — 医療分野。GPS によるチェックイン、署名済み診療記録、銀行振込での支払い。
電気設備の修理 — 住宅分野。訪問サービス、作業前後の写真、チェックリスト、クライアントの署名、現金払い。
A2A 対応
Servicialo は、A2A(Agent-to-Agent) をオプションの拡張機能としてサポートしています。これにより、外部エージェント(Salesforce Agentforce、Google ADK など)が、MCP を介さずにサービスを検索して予約できます。
詳しいガイド:docs/a2a-interoperability.md
ネットワークインテリジェンス — 市場ベンチマーク
認証済み MCP サーバーを実行する各ノードは、値をバケット化した匿名の運用イベント(booking_created、service_completed、dispute_opened、payment_settled)を送信します(価格は価格帯、期間は範囲、地域は国レベル、スラッグの代わりにフィンガープリントを使用)。レジストリはこれらのイベントを集約し、次の2つの厳格なルールに基づいて(業種 × 地域 × イベント)ごとの分布を公開します。
- k-匿名性 ≥ 5 — 異なる5つ以上の組織がデータを提供したセグメントのみ公開されます。
- アクセスするには貢献が必要 — テレメトリーを提供しないノードには90日遅れでデータが表示されます。積極的に貢献しているノードにはリアルタイムで表示されます。有料プランはありません。
利用方法は2つあります。
- プル —
GET /api/benchmarksとGET /api/benchmarks/segments、または MCP ツールmarket.get_benchmark/market.list_segmentsを使用します。 - プッシュ — Webhooks API 経由でイベント
benchmark.weekly_snapshotを購読します。レジストリは毎週月曜日の 00:00 UTC に、HMAC 署名付きペイロードでスナップショットを送信します。
詳細:docs/benchmarks.md · docs/telemetry-operational.md · GOVERNANCE.md · WEBHOOKS.md
7つの原則
| # | 原則 | |
|---|---|---|
| 1 | すべてのサービスにはライフサイクルがあります | マッサージでも監査でも関係ありません。プロトコルは、提供、証拠、受け入れ、決済という全サイクルを観測するための独立した状態を定義します。 |
| 2 | 提供は検証可能でなければなりません | 十分な証拠がなければ、必要な確実性をもって提供が証明されたとはみなせません。プロトコルは、有効な証拠を構成するものを定義し、人間と AI エージェントがそれを信頼できるようにします。 |
| 3 | 支払者が常に顧客とは限りません | 医療では保険会社が支払います。法人向けサービスでは企業が支払います。教育では保護者が支払います。プロトコルは顧客と支払者を明確に分けます。 |
| 4 | 例外こそが常態です | 無断欠席、キャンセル、日程変更、紛争。優れたサービス設計では、計画どおりに進まなかった場合の対応を定義します。 |
| 5 | サービスは機械が読み取れる製品です | 名前、価格、期間、要件、期待される成果があります。このように定義することで、あらゆる AI エージェントが人間と同じ信頼性でサービスを発見し、調整し、完了できます。 |
| 6 | 合意と提供は別のものです | サービス注文は合意内容を定義します。アトミックサービスは提供された内容を定義します。これらはそれぞれ異なるライフサイクルを持つ、別個の2つのオブジェクトです。 |
| 7 | 集合知はプロトコルの共有財産です | プロトコルを実装する各ノードは運用データに貢献します。集約されたインテリジェンスはすべてのノードを向上させます。各ドライバーが貢献し、全員の移動がよりスムーズになる Waze のようなものです。ネットワークのデータを所有する実装はありません。 |
レイヤーアーキテクチャ
必要なものだけを採用してください。Core は提供サイクル全体をカバーします。拡張機能は、専門的な運用に必要な機能を追加します。
Servicialo Core — estable
専門サービスを最初から最後までモデル化するために必要なすべての機能を備えています。
提供の約束を交わす2者がいて、何が起きたかを検証可能な形で記録する必要がある、あらゆるプラットフォーム向けです。心理士の組合から、複数の顧客アカウント、チーム、スタッフを持つ清掃会社まで対応します。
含まれるもの:8つのディメンション · 6+3のライフサイクル(コア状態6つ + オプションの財務状態3つ) · 6つの例外フロー · 7つの基本原則 · リソース管理 · サービス注文 · 提供証明 · MCP プロトコル(40ツール) · ディスカバリーリゾルバー(DNS に相当し、HTTP 上で動作) · A2A 相互運用性 · ネットワークインテリジェンス(k-匿名性 ≥5 および貢献によるアクセスを備えたバケット化ベンチマーク) · プッシュ配信用 Webhook · 事前知識なしでのタクソノミー検出(コールドスタート)
Servicialo/Finanzas — en diseño
専門家、組織、インフラ間の支払いを、明確な精算ルールに基づいて分配します。
顧客と専門家の間で支払いを仲介するプラットフォームや、手数料を徴収するプラットフォーム向けです。
Servicialo/Disputas — en diseño
正式な紛争解決です。設計目標は、あらかじめ合意したルールを証拠が満たすケースを自動化することです。同じ分野のピアによる仲裁は、研究課題の一つです。
十分な取引量があるプラットフォームや、サービスごとの金額によって紛争が経済的に重要となるプラットフォーム向けです。
スキーマ
自動検証用のJSON Schema:schema/service.schema.json と schema/service-order.schema.json
# ─────────────────────────────────────────────
# SERVICIALO v0.9
# Dos entidades: Orden + Servicios atómicos
# ─────────────────────────────────────────────
orden_de_servicio:
id: texto # Identificador único
alcance: texto # Qué se acuerda entregar
precio: número # Precio total acordado
esquema_pagos: texto # prepago | por_sesión | mensual
currency: texto # ISO 4217
servicios[]: # Cada servicio atómico — 8 dimensiones
servicio:
id: texto
orden_de_servicio_id: texto # Referencia a la Orden padre
tipo: texto # Categoría del servicio
vertical: texto # salud | legal | hogar | educación | ...
nombre: texto # Nombre legible
duración_minutos: entero
visibilidad: texto # public | unlisted | private
proveedor:
id: texto
credenciales: texto[] # Certificaciones requeridas
puntaje_confianza: número # 0-100 calculado por historial
organización_id: texto
cliente:
id: texto
pagador_id: texto # Puede diferir del cliente
agenda:
solicitado_en: fecha_hora
agendado_para: fecha_hora
duración_esperada: minutos
ubicación:
tipo: presencial | virtual | domicilio
dirección: texto
recurso_id: texto # Opcional — referencia a recurso físico
ciclo_de_vida:
estado_actual: enum # 6 core + 3 financieros opcionales + excepciones
transiciones: transición[]
excepciones: excepción[]
prueba_de_entrega:
entrada: fecha_hora
salida: fecha_hora
duración_real: minutos
evidencia: evidencia[] # GPS, firma, fotos, documentos
cobro:
orden_de_servicio_id: texto # Referencia a la Orden padre
monto:
valor: número
moneda: texto # ISO 4217
pagador: referencia
estado: pendiente | cobrado | facturado | pagado | disputado
cobrado_en: fecha_hora
documento_tributario: referencia # Boleta/factura si se emitió
mandato: # Delegación explícita a agente IA
mandato_id: texto # UUID único
principal_id: texto # Humano u organización
agente_id: texto # Agente que recibe la delegación
alcances: texto[] # resource:action (e.g. schedule:write)
estado: activo | expirado | revocado | suspendido
# Ledger: proyección calculada desde entregas + términos comerciales +
# eventos de liquidación — nunca un saldo editable a mano
実装
どのプラットフォームでもServicialoを実装できます。掲載されるには、8つの次元をモデル化し、6つのコア状態を実装し(3つの財務状態は任意)、6つの例外フローのうち少なくとも3つに対応し、7つの基本原則を遵守し、コアプロファイル(HTTP、MCP、A2A、または同等のもの)を実装するマシン間バインディングを少なくとも1つ公開する必要があります。HTTPのみの実装もMCPなしで適合します。エージェントにはMCPを推奨します。現在、検証は手動です(PR+チームによるレビュー)。自動認定スイートはロードマップの一部です。
| プラットフォーム | 分野 | 対応状況 | 状態 |
|---|---|---|---|
| Coordinalo | 医療 | 8/8次元 · 6+3の完全なサイクル · 6/6例外 · 7/7原則 | 稼働中 |
Coordinaloは参照実装であり、プロトコルそのものではありません。2つ目のノードは、誰にでも開かれた機会です。詳しくは
IMPLEMENTORS.mdをご覧ください。
実装者向け
互換性のあるプラットフォームをゼロから構築するためのステップごとのガイドです。全8ステップで、最初のステップは20分で完了します。
こちらから始めてください:IMPLEMENTING.md (English)
関連資料:
schema/evidence/— 分野別の証拠スキーマ(医療、住宅、法律、教育、コンサルティング)ERRORS.md— プロトコルのエラーコードWEBHOOKS.md— 状態変更の非同期通知(v0.2 — レジストリイベントは安定版)
このリポジトリの内容
servicialo/
├── app/ # servicialo.com — sitio del protocolo (Next.js)
├── components/ # Componentes del sitio
├── examples/ # Conversaciones agente-servidor
├── lib/ # Datos del protocolo
├── packages/
│ └── mcp-server/ # @servicialo/mcp-server — servidor MCP (npm)
├── schema/ # JSON Schemas para validación
│ ├── evidence/ # Schemas de evidencia por vertical
│ │ ├── base.schema.json # Envelope compartido
│ │ ├── health.schema.json # Salud
│ │ ├── home.schema.json # Hogar
│ │ ├── legal.schema.json # Legal
│ │ ├── education.schema.json # Educación
│ │ └── consulting.schema.json # Consultoría
│ ├── service.schema.json
│ ├── service-order.schema.json
│ └── ...
├── protocol/
│ └── manifest.yaml # Fuente única de verdad: versión, tools, estados, extensiones
├── SPEC.md # Quick spec — referencia autocontenida para evaluadores
├── PROTOCOL.md # Especificación completa
├── ERRORS.md # Códigos de error del protocolo
├── WEBHOOKS.md # Especificación de webhooks (v0.2)
├── IMPLEMENTORS.md # Guía para construir una implementación
├── GOVERNANCE.md # Gobernanza de red y política de datos
└── README.md
| バージョン | 状態 | |
|---|---|---|
| プロトコル | 0.10 | 草案 |
| @servicialo/mcp-server | 0.9.13 | npm |
エコシステム
- ネットワークテレメトリー — テレメトリーで報告されたMCPサーバーのインストール数(採用された実装数とは異なります)
- 実装者 — 検証済みのプロトコル実装
- Servicialoを利用していますか?掲載をご希望の場合は、issueを作成してください。
ライセンス
Apache-2.0 — Servicialoはオープンプロトコルです。誰でも実装できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。