전체 목차 소개

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 비서 호출은 일을 요청하며, 결과 수집은 돌아온 내용을 보존합니다. 각각의 계약을 나누세요. 지원 이벤트만 설정하고 현재 공개 범위로 거르며 안정적인 전달 신원을 유지합니다. 수신자는 중복을 제거하고 추가 자료 조회나 실행 전에 권한을 다시 확인해야 합니다.

데몬은 영속 일정, 대기 시간, 복구를 소유하고 전송 어댑터는 제한된 시도 한 번의 결과를 반환합니다. 외부 호출 결과를 모를 때 실패한 알림처럼 무작정 재실행하면 안 됩니다. 댓글은 주의를 요청할 수 있지만 이어서 실행하려면 구독 설정과 클라이언트 권한이 필요합니다. 제공사별 콜백 인증과 이벤트 규칙은 실제 제공사 계약에서 가져와야 합니다.

범위를 정한 업무 하나를 끝까지 연결합니다

먼저 원천, 의도한 공개 대상, 사용자 결과 하나를 정합니다. 제한된 신원을 발급하고 반환 문맥을 확인한 뒤 익숙한 허용 검색을 실행합니다. 이어 의도적으로 제외한 항목으로 경계를 확인하세요. 요약과 필요한 원문 표현을 조회하고 참조를 보존하며 허용된 논의 결과 하나를 남깁니다. 설계 개념을 위해 범용 주소를 만들어내지 말고 문서화된 형식을 사용합니다.

그다음 페이지 처리, 원천 장애, 만료 자격증명, 반복 요청을 살펴보세요. 빈 결과와 완전성 증명을 구분하고 비밀이나 불필요한 내용을 로그에 남기지 않으면서 안전한 작업 식별자를 보존합니다. 수동 조회와 논의가 작동한 뒤 자동 재개를 추가하세요. 이렇게 하면 검토 가능한 통합 단위가 생기며 배포 정책, 모델 지출, 중요한 외부 효과는 각자 통제 아래 남습니다.

사용하면서 궁금해지는 점

가져오기를 빠르게 하려고 SQLite에 직접 써도 되나요?

통합은 문서화된 원천 또는 도메인 인터페이스를 사용해야 합니다. 직접 쓰기는 권한, 불변 원문, 재시도 신원, 게시 조정, 이벤트 의미를 우회합니다. 오프라인 유지보수 도구는 별도 운영 책임이며 인증된 원천 계약의 대체물이 아닙니다.

태그나 모델 점수가 승인된 실행을 일으키나요?

허용된 절차의 입력 정보는 될 수 있지만 승인 권한을 주지는 않습니다. 현재 권한과 계약의 리비전 검사 아래 참고 결과, 메타데이터 변경, 검토된 외부 효과를 구분해야 합니다.

정확히 실행 가능한 API 형식은 어디서 보나요?

선택한 배포의 OpenAPI 계약, MCP 도구 참조, 운영 예제를 사용하세요. 아키텍처의 공통 원천 개념은 책임을 설명합니다. 모든 개념 기록이 HTTP 주소로 제공된다는 약속은 아닙니다.

신원과 실패의 의미를 지키는 원천부터 근거까지의 업무 하나를 만들고 같은 계약으로 소비자와 자동화를 더하세요.