다른 소프트웨어가 내 데이터를 읽도록 허용하는 것

API 스튜디오: 한 번에 하나의 화면을 게시하고, 키를 발급하고, 해당 키를 주소에 고정하고, 동일한 방식으로 AI 에이전트용 MCP 서버로 게시할 수 있습니다.

조만간 TRANXACT 외부에서 여러분의 데이터가 필요한 상황이 발생할 수 있습니다. 보고 도구, 파트너 시스템, 가격표가 필요한 웹사이트, 또는 여러분의 사업에 대한 질문을 받은 AI 에이전트 등이 그 예입니다. 플랫폼 메뉴의 API 스튜디오에서 화면 하나, 열 하나씩 데이터를 허용할지 여부를 결정할 수 있습니다.

누군가가 공개하기 전까지는 외부에서 접근할 수 있는 것이 아무것도 없습니다. 모든 것을 열어주는 설정도 없고, 모든 것에 접근할 수 있는 키도 없습니다. 완전히 새로 배포된 시스템은 API 인터페이스가 전혀 없으며, 이것이 바로 활성화되기를 기다리는 상태가 아니라 처음부터 갖춰야 할 올바른 시작점입니다.

네 가지 결정은 순서대로 다음과 같습니다.

화면 게시

1. Open Platform → API Studio를 선택하고 화면을 고르세요. 목록에는 콘솔에 있는 모든 화면이 제품 자체에서 읽어온 것이므로 이번 릴리스에 포함된 화면도 목록에 있습니다.
2. 전송될 수 있는 열에 체크 표시를 하세요. 체크 표시가 없는 항목은 절대 전송되지 않습니다. 목록에도, 개별 레코드에도, 쓰기 작업이 반환하는 최종 결과물에도 포함되지 않습니다. 애초에 모든 항목은 의도적으로 체크 표시가 되어 있지 않습니다.
3. 어떤 작업을 수행할지 결정하세요. 읽기는 기본적으로 활성화되어 있으며, 생성, 변경, 삭제는 각각 별개의 결정입니다. 왜냐하면 상대방 시스템이 내 품목 마스터를 읽도록 허용하는 것과 상대방 시스템이 품목 마스터를 삭제하도록 허용하는 것은 전혀 다른 작업이기 때문입니다.
4. 선택적으로 행을 제한할 수 있습니다. 예를 들어, 게시된 송장만 표시하거나 올해 송장만 표시할 수 있습니다. 이 필터는 모든 목록 화면에서 사용되는 동일한 필터이며, 모든 통화 시 서버에서 적용되므로 발신자가 보내는 어떤 정보로도 범위를 넓힐 수 없습니다.
5. 저장해 두세요. 이건 초안일 뿐이고, 초안은 아무런 성과도 가져오지 못합니다. 진심으로 원할 때 비로소 완성된 글을 만들어 보세요.
6. 키를 다른 사람에게 주기 전에 미리 보기를 누르세요. 파트너가 받게 될 내용과 제외된 열의 수를 정확하게 확인할 수 있습니다.

소프트웨어 등록

클라이언트는 소프트웨어에 대한 기록입니다. 소프트웨어의 이름, 기능, 문의 담당자, 그리고 가장 중요한 것은 어떤 사용자 계정으로 작동하는지에 대한 정보가 포함됩니다. 클라이언트 키가 수행하는 모든 호출은 해당 사용자 계정으로 이루어집니다. 해당 사용자가 할 수 없는 작업은 클라이언트 키도 할 수 없습니다.

열쇠는 발급 시 한 번만 표시되고 다시는 표시되지 않습니다. 새 열쇠를 발급하면 기존 열쇠는 즉시 작동을 멈춥니다. 열쇠는 고객 정보를 삭제하지 않고 회수할 수 있으므로, 등록 기록에는 누가 언제 열쇠를 회수했는지가 계속 기록됩니다.

열쇠가 사용될 수 있는 곳

허용된 주소가 없는 키로는 아무것도 할 수 없습니다. 주소가 지정되지 않은 경우, 아직 접근할 수 없다는 의미이며, 어디에서도 접근할 수 없다는 의미는 아닙니다. 유출된 키가 전 세계 모든 노트북에서 작동할 수 있다면 그것이 바로 위험의 전부이기 때문입니다. 접근 방식은 브라우저 출처, 참조 호스트, 단일 주소 또는 CIDR 형식의 네트워크 등 네 가지가 있습니다.

통합 작업을 하는 사람에게 무엇을 보내야 할까요?

스튜디오는 네 가지 주소를 출력합니다. 기본 주소는 /api/v1이고, 키는 Authorization: Bearer 헤더에 포함되며, /api/v1/resources에는 이 키를 사용하여 접근할 수 있는 리소스 목록이 있고, /api/v1/openapi.json은 OpenAPI 3.1 문서와 동일합니다.

이 두 가지 모두 요청하는 키로부터 생성됩니다. 파트너에게 호출할 수 없는 엔드포인트 40개가 나열된 문서가 제공되는 경우는 절대 없습니다. 파트너에게 제공되는 문서는 호출 가능한 엔드포인트만 정확하게 설명하며, 요청 처리기가 확인하는 동일한 행으로 구성되기 때문에 거부될 경로를 설명할 수 없습니다.

AI 에이전트에 대한 동일한 데이터

주소 /api/v1/mcp는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버에 연결하는 에이전트는 키가 수행할 수 있는 각 작업에 대한 도구만 제공받으며, 그 외의 다른 작업에는 사용할 수 없습니다. 즉, 아무도 공개하지 않은 데이터에 대한 도구나 아무도 권한을 부여하지 않은 동사에 대한 도구는 제공되지 않습니다. 이는 개발자가 아닌 모델을 위해 설명된 동일한 공개 정보이므로, 둘 사이에 불일치가 발생할 염려가 없습니다.

모든 통화에서 발생하는 일

게시된 호출은 데이터베이스에 대한 바로 가기가 아닙니다. 인증 절차를 거치고, 노출 및 권한 부여 여부를 확인한 후, 플랫폼 자체 API를 통해 사용자의 실행 계정으로 호출됩니다. 이는 콘솔에서 사용하는 것과 동일한 경로입니다. 회사 범위 지정, 사업부 범위 지정, 장소 제한, 마감 기간, 게시 규칙, 사용자 정의 필드, 사용자 정의 로직, 편집 가능성 및 감사 추적은 모두 동일한 코드가 실행되므로 동일하게 적용됩니다.

모든 호출은 허용 여부와 거부 사유와 함께 기록됩니다. 해당 로그는 플랫폼 → API 스튜디오 → API 호출 로그에서 확인할 수 있으며, 허용되지 않은 주소에서 키가 제시된 경우가 가장 흥미로운 부분입니다.

작동하지 않을 때