테마
AI·MCP 빠른 시작
AI가 인피리움의 입력 규격을 읽고, 제품대장 파일을 분석해 검토할 초안을 준비하도록 연결합니다. 처음에는 규격 조회 → 합성 예제 파일 미리보기까지 진행해 결과를 확인하세요.
사용할 환경
현재 MCP·AI A2A는 연결이 허용된 개발 환경에서 사용합니다. 기본 MCP 주소는 https://dev-api.infirium.org/mcp입니다. 운영 환경에서는 차단되며 일반 EDC 간 데이터 교환은 별도입니다. 메뉴가 보이지 않으면 관리자에게 개발 환경의 활성화 여부를 확인합니다.
준비
| 내가 할 일 | 먼저 읽을 문서 | 준비물과 첫 결과 |
|---|---|---|
| 기업 자료를 준비하고 싶어요 | AI·프로그램 연결하기 | 기업 계정, 소유자의 프로그램 등록 → 승인한 연결 |
| Codex 등 AI 프로그램을 설정해요 | 클라이언트 연결 설정 | 공개 프로그램 ID, 정확한 HTTPS 콜백 → 규격 조회 도구 |
| 내 프로그램에서 MCP를 호출해요 | SDK로 첫 조회 | Node.js, MCP용 OAuth access token → 프로필 4종 |
| 연결을 마쳤고 파일이 있어요 | 예제 CSV로 자료 준비 | 합성 CSV와 열 매핑 확인 → 제품 2개의 미리보기 |
자료 준비에서 등록까지
- 연결
소유자가 프로그램을 등록하고 필요한 도구 사용에 동의합니다.
- 분석
예제 파일이나 준비한 자료의 열과 입력 규격을 확인합니다.
- 매핑
어떤 열을 어떤 입력 항목에 넣을지 확인하고 결과를 미리 봅니다.
- 초안
검토한 행을 선택해 초안으로 저장합니다.
- 사람 검토
조직 소유자가 웹에서 등록할 내용과 범위를 검토하고 승인합니다.
- 등록
승인한 범위의 등록을 요청하고 단계별 결과를 확인합니다.
첫 번째 요청
클라이언트 설정을 마친 AI에 다음을 요청합니다.
text
인피리움의 infirium_list_data_profiles를 catalogVersion 3으로 호출해 줘.
사용할 수 있는 자료 종류와 각 schemaVersion을 표로 알려 줘.
제품 생성이나 등록은 실행하지 말고 규격만 조회해 줘.예상 결과: part-type-information, digital-product-passport, battery-passport, pcf 네 프로필이 표시됩니다. 각 프로필의 필드·단위·조건을 확인할 수 있습니다. 이 단계는 회사의 제품 목록을 읽거나 초안을 저장하지 않습니다.
도구가 없다면 연결의 data:read 동의와 현재 계정 권한을 확인합니다. 연결 오류는 오류·제한·재시도, 도구별 권한은 도구와 업무 범위에서 찾습니다.
Codex 연결 안내
사전 등록한 공개 클라이언트와 정확한 HTTPS 콜백을 사용하는 Codex 수동 로그인 절차로 이동하세요. 인피리움의 HTTPS 콜백 정책과 클라이언트의 콜백 설정이 일치해야 합니다. 다른 AI 프로그램은 같은 요건의 지원 여부를 개별 확인합니다.
등록과 설정
공개 프로그램 ID와 정확한 HTTPS 콜백을 클라이언트 설정에 입력합니다.
수동 로그인
CLI의 --no-browser 로그인은 로컬 입력 절차를 따릅니다.
연결이 거절될 때
콜백·resource 중복·현재 scope를 오류 대응에서 점검합니다.
스키마를 확인하며 파일 준비하기
예제 파일 따라 하기에서 실제 입력 경로와 매핑 형식을 확인할 수 있습니다. 분석 결과의 source·region·layoutSignature를 유지하며 매핑 → 미리보기 → 선택 행 초안 순으로 진행합니다. 임의 엑셀의 자동 매핑 정확도나 정식 등록 완료를 약속하는 절차는 아닙니다.
다음에는 예제 CSV를 준비하거나, 프로그램을 직접 만드는 경우 SDK 첫 조회를 실행합니다. 초안 이후 업무는 정식 등록, 제조 자료는 매핑과 검토, 작업 인터페이스는 A2A를 참고하세요.
직접 구현할 때의 순서
1. 메타데이터 확인
연결 주소 발견에서 resource·issuer·OAuth endpoint를 확인합니다.
2. OAuth 인증
Authorization Code + PKCE로 사용자가 동의한 토큰을 받습니다.
3. 공식 MCP SDK로 읽기
설치·환경변수·실행 예제에서 프로필 조회를 실행합니다.
제품 조회 확인
제품 본문은 products:read 도구로 조회합니다. 입력 규격 조회와 별도 권한이며 현재 접근 가능한 저장 데이터만 읽습니다.
클라이언트 도구 동의와 업무 승인
AI 클라이언트의 도구 실행 허용과 인피리움 소유자의 업무 승인은 별도입니다.
다음 단계
예제 파일 준비로 진행하거나 도구 목록에서 필요한 업무를 찾으세요.
두 AI가 함께 일하게 하려면
양방향 에이전트 협업에서 별도 연결 → 각 에이전트 등록 → 양쪽 소유자 동의 → 요청·확인 질문·추가 답변을 따라 해 보세요. 계약과 전송 뒤에는 실제 데이터 수신까지 확인합니다.