すべての章 紹介

CHAPTER 11 / 12

共通のドメイン契約を軸に統合する

MCP、HTTP、CLIで情報源と利用側をつなぎ、身元、根拠、権限、再試行の意味を維持します。

SyncPierは情報源と、それを使うクライアントの間に位置します。会社のIMAPアカウント、電話のリレー、外部の調査プログラムが情報を取り込み、AIアシスタント、人向け画面、自動化クライアントが許可された資料を検索し、読み、議論します。プロトコルは接続の性質であり、情報の出自や所有者を定義し直すものではありません。

統合の開発者には、境界を越えてもこの意味を守ることが求められます。HTTPの成功は収集完了の証明ではなく、道具の呼び出しは権限付与ではなく、AIアシスタントの報告は独立検証された事実ではありません。公開契約に沿って小さく有用な仕事を作り、明確な根拠と失敗処理を加えて拡張します。

この章でわかること

  • MCP、HTTP、CLIから認証済みドメインサービスを使い、データベース直接書き込みで迂回しません。
  • 情報源の系譜、私的なワークスペース権限、道具の操作、メタデータの意味を分けます。
  • イベント配信、情報収集、外部実行を、それぞれ独立した再試行規則で扱います。
このページの内容
仕組みを説明する図アシスタントが共通の情報層を呼び出す
会社のメール
IMAP / プロバイダーAPI
SyncPier
MCP
Grok · Dots · Hermes

独自アプリはHTTP APIを使います。接続先への到達性、認証、許可したツールが利用範囲を決めます。

永続的な所有をドメインサービスに置く

デーモンは基準となる原文、安定した発生項目、権限、永続操作を管理します。提供元アダプターは実際のプロトコルを変換し、別のデータベース所有者にはなりません。メール、SMS、報告に検索、閲覧根拠、注記、議論、任意の分析を共通提供しても、すべての情報源がすべてのメール操作を支えると見せる必要はありません。

原本と読みやすい表現を区別します。正確な報告JSONと、そこから生成したメール状の表示は別の表現です。表示は共通の読み取りを可能にし、原本は出典や表示されないフィールドを保存します。表示の更新で原本を密かに置き換えたり、新しい発生項目を作ったり、見ていないフィールドを読んだと扱ったりしてはいけません。

呼び出す側に合わせてMCP、HTTP、CLIを選ぶ

AIアシスタントが発見可能な型付きの道具を必要とするなら、ネイティブMCPを使います。プログラムが要求と応答を明示的に扱うなら認証付きHTTP、文書化された管理やスクリプト作業にはCLIを選びます。どの経路も同じドメイン責任につながり、選択によって権限を広げたり別の保存経路を作ったりしてはいけません。

接続先のサーバーから実際の道具一覧を取得し、対応する契約を参照します。HTTPにはOpenAPIの形式と、運用手順のヘッドレスクライアント境界を使います。公開MCPのOAuth資格情報、私的デーモン資格情報、提供元トークンは目的が異なります。どれも認証に使うという理由で、ブラウザーセッションやGoogleトークンをデーモンbearerの代わりにはできません。

認証された文脈から権限を解決する

Tenantの系譜と個人のSP-Workspaceは別の概念です。認証文脈がユーザー、ワークスペース、アプリケーション、発行済みAIアシスタントの身元を必要に応じて固定します。表示名、モデル名、報告上の著者、要求ヘッダーで別の所有者を選ばせてはいけません。業務データの前に、文書化された身元・権限文脈の取得で、サービスが認識する呼び出し元を確認します。

実効アクセスは、現在のユーザー権限、ワークスペース割り当て、発行時の委任の共通範囲で、必要ならコレクション権限も含みます。トピック参加は追加の文脈であり、関連するすべての原文の閲覧許可ではありません。論理的なAIアシスタントごとに一つの発行済み身元を使い、私的な閲覧根拠と作業状態の主体を明確にします。新しい資格情報は身元を維持できますが、新しい表示名は連続性を証明しません。

操作、メタデータ、閲覧根拠を分ける

道具は検索、取得、議論、状態確認などの定義済み操作を行います。メタデータは記録を説明します。分類、タグ、表示状態、参考スコアには固有の意味と対象者があります。重要フラグの設定は外部操作の承認ではありません。道具を選ぶための説明メタデータも、サーバーの権限を上書きしたり書き込みを読み取りに変えたりはできません。

安定した情報源の参照と、何を提示したか分かる範囲情報を返します。要約、本文の一部、抽出添付は異なる根拠です。提示範囲の記録には契約の明示的な閲覧確認を使い、作業完了とは分けます。検索結果から全文閲覧を推測したり、一方のAIアシスタントの作業状態を別の身元へコピーしたりしないでください。

情報源の身元と受理済み原本を保つ

外部報告を送るプログラムは、文書化された受信専用の情報源として登録し、報告を開示してよいアカウントを送り先にします。所有者やMCPのトークンではなく、その情報源の資格情報を使います。再試行時は安定したイベント識別を維持し、内容の変更は適切な別識別を持つ訂正として扱います。モデル、著者、確信度の表示は認証ではなく、作成者が述べた内容です。

受領、原本保管、正規化、公開、索引の状態を分けます。受理されても未公開の資料が、一覧の不完全さを説明する場合があります。非公開の依頼結果をアカウントで読める資料にする前には、対象者に合う公開判断が必要です。非公開の注記で共有原本を非公開にはできません。生成された送信者やメール状の保存形式から機能を推測せず、対応操作を明示します。

ルーティングと再試行の担当を一つにする

イベント配信は出来事を知らせ、AIアシスタントの呼び出しは仕事を依頼し、結果収集は戻った内容を保存します。契約を分けて扱います。対応するイベントだけを設定し、現在の対象者で絞り、安定した配信識別を保ちます。受信側は重複を除き、追加取得や操作前に権限を確認します。

デーモンが永続スケジュール、待機、復旧を持ち、転送アダプターは限定した一回の試行結果を返します。結果が不明の外部実行を、失敗通知のように無条件で再実行してはいけません。コメントは注意を促せますが、継続には購読設定と受信クライアントの許可された動作も必要です。提供元固有のコールバック認証やイベント規則は、実際の提供元契約から得ます。

範囲を決めた一つの仕事を最後までつなぐ

まず情報源、対象者、利用者の成果を一つ決めます。制限した身元を発行し、返る文脈を確認し、既知の許可された検索を実行します。次に意図して除外した項目で境界を確認します。要約と必要な原文表現を取得し、参照を保存し、許可された議論の結果を一つ残します。設計概念のために汎用APIを発明せず、文書化された形式を使います。

続いてページ処理、情報源障害、資格情報の期限切れ、同じ要求の再送を試します。空の結果と完全性の証拠を区別し、秘密や不要な内容を記録せず安全な操作識別子を残します。手動の取得と議論が動いてから自動継続を追加します。これで検討可能な統合単位を作り、運用方針、モデル費用、重要な外部操作はそれぞれの管理に残せます。

使うときに知っておきたいこと

取り込みを速めるためSQLiteへ直接書けますか。

統合は文書化された情報源またはドメインのインターフェースを使います。直接書き込みは権限、不変原本、再試行識別、公開調整、イベントの意味を迂回します。オフライン保守ツールは別の運用責任であり、認証付き情報源契約の代わりではありません。

タグやモデルの点数で承認済み操作が起きますか。

許可された処理の判断材料にはなりますが、承認権限にはなりません。現在の権限と契約上のリビジョン確認の下で、参考結果、メタデータ更新、確認済み外部操作を分けます。

実行可能なAPIの正確な形式はどこにありますか。

対象の運用環境に合うOpenAPI契約、MCP道具リファレンス、運用例を使います。共通情報源の設計概念は責任を説明するもので、すべての概念がHTTPの接続先として存在するという約束ではありません。

身元と失敗の意味を保つ、一つの情報源から根拠までの仕事を作り、同じ契約で利用側と自動化を増やしてください。