테마
MCP 도구와 업무 범위
연결 뒤 어떤 도구와 기능이 필요한지 찾는 참조입니다. 처음 호출한다면 SDK 첫 조회, 파일을 준비한다면 합성 CSV 따라 하기를 먼저 진행하세요.
현재 코드에는 기업용 도구 97개와 scope 정의 25개가 있습니다. 서버 배포 버전·동의 범위·역할·그룹에 따라 tools/list 결과는 줄어듭니다. 실행 시에는 연결한 서버에서 발견한 도구의 최신 inputSchema를 사용합니다. 프로그램 생성 때 고정한 요청 허용 목록 안에서 이번 로그인에 필요한 scope를 요청합니다. 허용 목록 밖의 기능은 새 프로그램 등록과 연결 설정 교체가 필요합니다.
업무별 시작점
| 목적 | 대표 도구 | Scope | 범위 |
|---|---|---|---|
| 입력 규격·의미 확인 | infirium_list_data_profiles, infirium_get_data_requirements, infirium_get_input_field_guidance | data:read | 프로필·요구사항·고정 입력 안내 |
| 기존 파일 준비 | infirium_analyze_product_files, infirium_suggest_data_mapping, infirium_preview_prepared_data, infirium_check_pcf_unit_inputs | data:prepare | 분석·매핑·검증, 저장·계산·교환 제외 |
| 매핑 재사용 | mapping template 생성·목록·revision 추가/조회·archive | data:templates | 검토한 매핑 관리 |
| 초안 생성 | infirium_create_intake_plan, infirium_get_intake_plan, infirium_execute_intake_drafts | data:drafts | 검토한 선택 행의 초안 저장 |
| 기존 초안 수정 | draft update plan 생성/조회·execute, infirium_get_draft_readiness | data:updates | 변경 확인 후 초안 수정·준비 상태 |
| 등록 검토 | registration review plan 생성/조회/취소 | data:updates | 저장 검토·사람 승인 링크, 이 범위만으로 실행 불가 |
| 승인한 제품 등록 | infirium_execute_registration, infirium_get_registration | products:register | owner 웹 승인 후 단일 PartType Information 단계별 등록·최종 공개 |
| 승인한 제품 여러 개 등록 | registration batch 생성·조회·단계 실행·resume·취소 | products:register | 각각 승인된 검토 최대 10개, 선택 항목·단계만 실행 |
| 게시한 제품 PTI 변경 | prepare/get/execute/cancel product update | products:write | 소유자의 전후 비교 승인 후 PTI 불변 버전 발행 |
| 제조 자료 검토 | manufacturing import/BOM/PCF 제안 도구 | data:prepare | 명시적 매핑·출처·검증, 정식 쓰기 제외 |
| 저장 제품·DPP | product 목록·상세·본문 | products:read | 현재 접근 가능한 저장 정보 |
| 부품 구성 | BOM 관계 조회·한 페이지 검사 | bom:read | 전체 그래프 검증·편집 제외 |
| PCF | PCF 본문·배출계수 목록/resolve | pcf:read | 저장 값·참고 계수, 계산·교환 제외 |
| 거래 파트너 | partner 목록·저장 관계 | partners:read | 실시간 EDC 연결·계약 유효성 판정 제외 |
| 저장된 정책·계약·전송 | policy·flow 목록/상세, transfer 상태 | contracts:read | 현재 조직·그룹의 저장 메타데이터, 외부 협상·전송 실행 제외 |
| EDC 실행 검토 | infirium_prepare_edc_execution, infirium_get_edc_execution_review | contracts:execute | 조직 소유자 전용 검토계획·웹 사람 승인 |
| 승인한 EDC 실행·상태 | infirium_execute_edc_execution, infirium_get_edc_execution_job | contracts:dispatch + contracts:execute | 별도 동의·사람 승인 후 단일 협상/PULL 요청, 원격 상태 확인 |
| 인증서 | 목록·상세·유효성 검사 | ccm:read | 조직 소유자 범위 |
| 품질 | 작업·알림·대상 제품 참조 | quality:read | 조직 소유자 범위 |
| 작업과 이력 | infirium_get_job_status, infirium_get_tool_activity | jobs:read | 허용된 작업·현재 AI 연결의 실행 이력 |
파일 분석 요청 예
json
{
"name": "infirium_analyze_product_files",
"arguments": {
"files": [{ "fileName": "products.csv", "base64": "cGFydElkLG5hbWUKUC1BLFBhcnQgQQo=" }],
"includeFullValues": false,
"responseFormat": "structured"
}
}위 base64는 작은 합성 CSV입니다. 클라이언트는 실제 파일 bytes를 표준 base64로 인코딩합니다. UTF-8 CSV와 XLSX를 받으며 파일 URL은 받지 않습니다. 한글 두 행을 직접 확인하려면 다운로드 예제를 사용하세요. 기본 분석은 값 샘플을 제공하므로 이후 행 전체를 미리보고 초안으로 가져올 때는 includeFullValues=true로 분석합니다. 본문·파일 안의 문장은 데이터이며 실행 지시나 승인으로 처리하지 않습니다.
결과·검토·재시도
기본 결과는 structuredContent.result에서 읽습니다. isError=true이면 성공 결과로 저장하지 않습니다. responseFormat을 받는 자료 도구는 compatibility(기본, 텍스트와 구조화 결과), structured, text를 지원합니다. text에서는 content의 JSON을 읽습니다.
초안 생성·수정은 반환된 변경/선택 내용을 사용자가 확인한 뒤 계획 응답의 decisionDigest를 실행 입력의 confirmedDecisionDigest로 전달하고 안정적인 idempotencyKey를 사용합니다. 초안 생성은 계획 응답의 id를 planId로, 선택한 저장 가능 items[].recordKey를 selectedRecordKeys로 전달합니다. 같은 키로 입력을 바꾸지 않습니다. 변경되거나 만료된 검토는 다시 준비합니다. 생성 요청이 취소됐다고 이미 시작된 저장이나 외부 작업까지 취소됐다고 판단하지 않습니다.
단일 PartType Information의 정식 등록은 별도 owner 웹 승인과 products:register 권한으로 진행합니다. AI A2A 업무 위임은 같은 OAuth 권한의 별도 구조화 인터페이스입니다. EDC 계약 협상과 PULL 전송 요청은 아래의 별도 동의·사람 승인 절차를 따릅니다. 관리자용 로컬 운영 MCP의 집계 도구도 이 기업용 목록에 포함되지 않습니다.
계약 조회 도구의 consistency=stored_metadata는 저장된 마지막 상태입니다. 실시간 EDC 조회나 계약 유효성·전송 성공을 판정하지 않습니다. dataAddressAvailable=true는 저장된 endpoint와 자격 증명이 비어 있지 않다는 뜻이며 현재 유효성을 보장하지 않습니다. 실제 주소·토큰·원본 응답은 반환하지 않습니다. infirium_get_transfer_status에는 외부 transfer ID 대신 로컬 flow UUID를 전달합니다.
EDC 실행 검토와 사람 승인
contracts:read는 저장 메타데이터 조회, contracts:execute는 검토 준비·조회 범위입니다. 실제 원격 요청에는 프로그램 생성 때 고정한 허용 목록에 contracts:execute와 contracts:dispatch 모두 포함돼 있어야 하고, 조직 소유자도 두 범위에 동의해야 합니다. 목록이 부족하면 새 프로그램을 등록해 클라이언트 설정을 교체하고 로그인합니다. 기존 client/grant에 묶인 검토·승인을 새 연결에서 재사용하지 않고 실행 범위에 동의한 연결로 검토를 다시 준비합니다.
infirium_prepare_edc_execution으로 협상 또는 전송 검토를 준비합니다. 협상은 저장된 파트너와 제안 정책을 사용합니다. 공급자의 실제 제안 여부는 별도 확인해야 하며, 도구가 정책의 출처를 보증하지 않습니다. 임의 주소·자격 증명·AI의approved값은 받지 않습니다.- 원래 조직 소유자가
reviewUrl을 열어 공급자·소비자 BPN, 자산/계약, 실제 요청에 적용할 정책과 전송 방식·만료를 읽고 승인합니다.contracts:dispatch로 준비한 새 검토에는 승인 대상인 실행 조건이 표시됩니다. 기존 검토는 실행 가능 검토로 바뀌지 않습니다. infirium_get_edc_execution_review로 승인과executionAvailable을 확인합니다.contracts:execute만 있는 검토는 승인해도 실행할 수 없습니다. 사용자·프로그램 동의·대상 설정 변경 또는 만료 후에는 기존 승인으로 새 요청을 개시하지 않습니다.infirium_execute_edc_execution에{ "reviewId": "검토 UUID" }만 전달합니다. 검토에서 고정한 요청을 한 번 전송합니다. 협상과 전송은 각각 별도 검토·승인이 필요합니다. 첫 버전은HttpData-PULL/HttpProxy와 폴링만 지원합니다.- 같은
reviewId로infirium_get_edc_execution_job을 호출해job,flowId,remoteState,syncStatus를 확인합니다. 접수(accepted)는 계약 체결·데이터 전송 완료를 의미하지 않습니다. 원격 상태를 확인한 결과를 기준으로 판단합니다.
요청 결과가 불명확하면 새 검토나 키로 다시 전송하지 않습니다. needs_reconciliation은 확인이 필요한 상태입니다. 원격 ID조차 없는 응답 유실은 자동 복구하지 않으며, 404도 미실행 증거로 삼지 않습니다. 검토가 만료되거나 회수돼도 이미 기록된 실행 사실은 남습니다. 상태 조회는 원격 GET과 로컬 상태 동기화를 수행하며 EDR 주소·토큰을 반환하지 않습니다. MCP 토큰·Telegram 봇은 웹 사람 승인을 대신하지 않습니다.
전체 도구 이름
아래 표는 조회·자료 준비·등록 등 도구 61개입니다. 이어지는 승인 기반 제조 업무 실행 표가 나머지 27개를 업무별로 묶어 나열합니다. 두 표를 합한 이름은 현재 코드 레지스트리 기준입니다. 실제 연결에서는 tools/list 결과와 각 inputSchema를 우선합니다.
| 도구 이름 | Scope | 분류 |
|---|---|---|
infirium_list_data_profiles | data:read | 조회·검증 |
infirium_get_data_requirements | data:read | 조회·검증 |
infirium_get_input_field_guidance | data:read | 조회·검증 |
infirium_analyze_product_files | data:prepare | 조회·검증 |
infirium_check_pcf_unit_inputs | data:prepare | 조회·검증 |
infirium_suggest_data_mapping | data:prepare | 조회·검증 |
infirium_preview_prepared_data | data:prepare | 조회·검증 |
infirium_list_mapping_templates | data:templates | 조회·검증 |
infirium_get_mapping_revision | data:templates | 조회·검증 |
infirium_create_mapping_template | data:templates | 저장·검토 |
infirium_append_mapping_revision | data:templates | 저장·검토 |
infirium_archive_mapping_template | data:templates | 저장·검토 |
infirium_create_intake_plan | data:drafts | 저장·검토 |
infirium_get_intake_plan | data:drafts | 조회·검증 |
infirium_execute_intake_drafts | data:drafts | 저장·검토 |
infirium_list_products | products:read | 조회·검증 |
infirium_get_product | products:read | 조회·검증 |
infirium_get_product_data | products:read | 조회·검증 |
infirium_get_bom_relations | bom:read | 조회·검증 |
infirium_inspect_bom_relations | bom:read | 조회·검증 |
infirium_get_pcf_data | pcf:read | 조회·검증 |
infirium_list_emission_factors | pcf:read | 조회·검증 |
infirium_resolve_emission_factor | pcf:read | 조회·검증 |
infirium_list_partners | partners:read | 조회·검증 |
infirium_get_partner_relations | partners:read | 조회·검증 |
infirium_list_contract_policies | contracts:read | 저장 메타데이터 조회 |
infirium_get_contract_policy | contracts:read | 저장 메타데이터 조회 |
infirium_list_contract_flows | contracts:read | 저장 메타데이터 조회 |
infirium_get_contract_flow | contracts:read | 저장 메타데이터 조회 |
infirium_get_transfer_status | contracts:read | 저장 메타데이터 조회 |
infirium_list_certificates | ccm:read | 조회·검증 |
infirium_list_quality_tasks | quality:read | 조회·검증 |
infirium_get_quality_task | quality:read | 조회·검증 |
infirium_list_quality_notifications | quality:read | 조회·검증 |
infirium_get_quality_notification | quality:read | 조회·검증 |
infirium_get_quality_affected_parts | quality:read | 조회·검증 |
infirium_get_certificate | ccm:read | 조회·검증 |
infirium_inspect_certificate_validity | ccm:read | 조회·검증 |
infirium_get_job_status | jobs:read | 조회·검증 |
infirium_get_tool_activity | jobs:read | 조회·검증 |
infirium_create_draft_update_plan | data:updates | 저장·검토 |
infirium_get_draft_update_plan | data:updates | 조회·검증 |
infirium_execute_draft_update | data:updates | 저장·검토 |
infirium_get_draft_readiness | data:updates | 조회·검증 |
infirium_create_registration_review_plan | data:updates | 저장·검토 |
infirium_get_registration_review_plan | data:updates | 조회·검증 |
infirium_cancel_registration_review_plan | data:updates | 저장·검토 |
infirium_prepare_edc_execution | contracts:execute | 저장·검토, owner-only |
infirium_get_edc_execution_review | contracts:execute | 검토 조회, owner-only |
infirium_execute_edc_execution | contracts:dispatch + contracts:execute | 승인한 원격 단일 요청, owner-only |
infirium_get_edc_execution_job | contracts:dispatch + contracts:execute | 원격 상태·로컬 동기화, owner-only |
infirium_execute_registration | products:register | 사람 승인 후 지정한 단일 provider 단계·완료 시 최종 공개 |
infirium_get_registration | products:register | 현재 연결의 등록 작업·다음 단계 조회 |
infirium_create_registration_batch | products:register | owner-only, 각각 승인된 검토 1~10개 고정·provider 요청 없음 |
infirium_get_registration_batch | products:register | owner-only, 항목 상태·영수증·다음 동작 조회 |
infirium_execute_registration_batch_step | products:register | owner-only, 선택 항목의 정확한 provider 단계 최대 1회 |
infirium_resume_registration_batch_item | products:register | owner-only, 미전송이 확인된 retryable 실패만 로컬 복구 |
infirium_cancel_registration_batch | products:register | owner-only, 새 단계·로컬 게시 차단·이미 발생한 외부 효과 유지 |
infirium_prepare_manufacturing_import | data:prepare | 명시적 매핑 제안, 쓰기 없음 |
infirium_review_manufacturing_bom | data:prepare | 제출 관계 검증, 쓰기 없음 |
infirium_review_manufacturing_pcf | data:prepare | 선언 PCF v9 검토, 쓰기 없음 |
승인 기반 제조 업무 실행
승인 기반 실행 가이드를 먼저 읽고 최신 tools/list의 입력 스키마를 사용합니다. 아래 scope는 프로그램 생성 때 선택한 허용 목록에 있어야 하며 조직 소유자의 별도 동의도 필요합니다. 목록이 부족하면 새 프로그램으로 연결을 교체하고 그 연결로 검토·승인을 다시 준비합니다.
| 도구 | Scope | 실행 범위 |
|---|---|---|
infirium_prepare_quality_send, infirium_execute_quality_send, infirium_get_quality_send | quality:write | 준비된 QN 최초 전송 |
infirium_prepare_bom_revision, infirium_execute_bom_revision, infirium_get_bom_revision | bom:write | BOM 수정과 불변 버전 공개 |
infirium_preview_pcf_calculation, infirium_preview_pcf_initial_calculation | pcf:write | 서버 계산 미리보기, 저장 없음 |
infirium_prepare_pcf_calculation_commit, infirium_execute_pcf_calculation_commit, infirium_get_pcf_calculation_commit | pcf:write | 기존 PCF 계산·확정 |
infirium_prepare_pcf_initial_calculation, infirium_execute_pcf_initial_calculation, infirium_get_pcf_initial_calculation | pcf:write | PTI 등록 후 최초 PCF 생성 |
infirium_prepare_pcf_request, infirium_execute_pcf_request, infirium_get_pcf_request | pcf:exchange | PCF 요청, GET도 실제 업무 요청 |
infirium_prepare_pcf_send, infirium_execute_pcf_send, infirium_get_pcf_send | pcf:exchange | 확정한 PCF 전송 |
infirium_prepare_ccm_request, infirium_prepare_ccm_push, infirium_prepare_ccm_push_reply, infirium_prepare_ccm_available, infirium_prepare_ccm_status | ccm:exchange | 인증서 교환 5가지 준비 |
infirium_execute_ccm_exchange, infirium_get_ccm_exchange | ccm:exchange | 승인한 인증서 교환·영수증 조회 |
EDC consumer_transfer_terminate는 기존 EDC 준비/실행 도구에서 별도 contracts:terminate 동의와 기존 contracts:execute·contracts:dispatch가 모두 필요합니다. 취소 버튼이나 A2A Task 취소가 원격 전송 종료를 대신하지 않습니다.
정식 PTI 제품 변경
| 도구 이름 | Scope | 분류 |
|---|---|---|
infirium_prepare_product_update | products:write | 현재 PTI 버전과 세 제조 필드로 검토 준비 |
infirium_get_product_update | products:write | 검토·승인 상태·영수증·다음 단계 조회 |
infirium_execute_product_update | products:write | 소유자가 승인한 정확한 단계 하나 실행 |
infirium_cancel_product_update | products:write | 후속 전송·로컬 발행 차단 |
현재 PTI 조회 → 변경 준비 → 소유자 승인 → 단계별 발행을 따라 진행합니다. AI 승인 도구는 제공하지 않습니다. 기존 88개 도구의 scope·입력·annotations는 유지됩니다.
복합 업무 진행
| 도구 | Scope | 할 수 있는 일 |
|---|---|---|
infirium_create_workflow | workflows:write | 첫 원래 검토로 고정 template metadata 생성 |
infirium_get_workflow | workflows:read | 제공자 호출 없이 원래 로컬 기록·다음 동작 조회 |
infirium_attach_workflow_review | workflows:write | 같은 연결에 결합된 후속 검토 연결 |
infirium_execute_workflow_step | workflows:write | 서버가 지정한 단일 원래 동작만 명시적 실행 |
infirium_cancel_workflow | workflows:write | 후속 전송·로컬 게시 차단, 외부 효과·영수증 보존 |
다섯 도구 모두 조직 소유자 전용입니다. metadata scope는 원래 등록·BOM·PCF·계약 권한을 대신하지 않으며 read와 write도 서로 포함하지 않습니다. 등록 → BOM → PCF와 계약 → 전송 따라 하기에서 첫 동의·별도 승인·재개·취소를 확인하세요.
양방향 에이전트 협업과 수신
현재 registry는 총 113개 도구·30개 scope를 제공합니다. 기존 도구의 권한·승인 경계는 유지하며, 아래 16개는 새 연결에서 필요한 범위를 명시적으로 선택해야 합니다. 양방향 협업과 실제 수신을 먼저 따라 해 보세요.
| 도구 | Scope | 할 수 있는 일 |
|---|---|---|
infirium_register_agent | agents:manage | 자기 연결의 에이전트 등록·재연결 준비 |
infirium_list_agents | agents:read | 자기 연결의 활성 에이전트 조회 |
infirium_invite_agent_collaboration | agents:collaborate | 저장 파트너와 명시한 상대 ID로 양쪽 동의 제안 |
infirium_get_agent_collaboration | agents:read | 현재 협업의 참여자·공유 범위 확인 |
infirium_send_agent_message | agents:collaborate | 실제 A2A HTTP로 첫 요청·같은 task의 추가 답변·역방향 새 요청 |
infirium_get_agent_task | agents:read | 원래 task 또는 자기 messageId로 실제 결과 확인 |
infirium_receive_agent_task | agents:collaborate | 자기 수신 작업을 60초 동안 맡아 처리 |
infirium_respond_agent_task | agents:collaborate | 현재 lease·revision으로 질문·답변·작업 상태 전달 |
infirium_renew_agent_task | agents:collaborate | 현재 작업 담당 기한 갱신 |
infirium_cancel_agent_task | agents:collaborate | 대화 task 취소·늦은 답변 차단, 외부 업무는 별도 |
infirium_revoke_agent | agents:manage | 자기 에이전트 연결 회수 |
infirium_discover_contract_offers | contracts:discover | 현재 저장 파트너의 실제 제안 조회, 계약 실행 없음 |
infirium_prepare_contract_receipt | contracts:receive | 정확한 flow의 별도 수신 검토 준비 |
infirium_get_contract_receipt | contracts:receive | 원래 수신 검토·영수증 metadata 조회 |
infirium_execute_contract_receipt | contracts:receive | 승인한 수신 한 건 실행, 불확실 결과 자동 재시도 없음 |
infirium_get_received_contract_data | contracts:receive | 원래 권한과 내용 digest를 확인해 실제 저장 JSON 읽기 |
협업·수신 도구는 정상 조직 소유자의 연결만 사용합니다. 제안 조회에는 현재 partners:read도 필요합니다. 공유 동의는 업무 승인을 대신하지 않으며 AI가 소유자 승인을 대신하는 도구는 없습니다.
Scope 30개 참조
각 범위는 프로그램 생성 때 고정한 요청 허용 목록과 현재 사용자 동의에 모두 포함돼야 합니다. 이번 로그인은 허용 목록 안에서 필요한 scope만 요청하며, 목록이 부족하면 새 프로그램을 등록합니다. 아래는 코드의 scope 정의 전체이며, 실행의 추가 역할·검토 조건은 해당 가이드에서 확인합니다.
| Scope | 주 용도 |
|---|---|
data:read | 자료 프로필·입력 안내 |
data:prepare | 파일·매핑·제조 자료 검토 |
data:templates | 매핑 템플릿 관리 |
data:drafts | 선택 행 초안 저장 |
data:updates | 초안 수정·등록 검토 |
products:read | 저장 제품 조회 |
products:write | 소유자가 승인한 게시 PTI 변경·불변 버전 발행 |
bom:read | BOM 조회·한 페이지 검사 |
pcf:read | PCF·배출계수 조회 |
ccm:read | 인증서 조회·검사 |
partners:read | 저장 파트너·관계 조회 |
contracts:read | 저장 정책·계약·전송 메타데이터 |
contracts:execute | 소유자의 EDC 검토 준비·조회 |
contracts:dispatch | contracts:execute와 함께 승인한 EDC 요청·상태 |
quality:read | 품질 작업·알림 조회 |
jobs:read | 작업 상태·현재 AI 연결 활동 이력 |
products:register | 승인한 PTI 등록·등록 배치 |
quality:write | 승인한 QN 최초 전송 |
contracts:terminate | 기존 EDC 실행 범위와 함께 원격 전송 종료 |
bom:write | 승인한 BOM 변경·불변 버전 |
pcf:write | PCF 계산·승인한 확정·최초 생성 |
pcf:exchange | 승인한 PCF 요청·전송 |
ccm:exchange | 승인한 인증서 교환 |
workflows:read | 소유자의 복합 업무 metadata 조회 |
workflows:write | 소유자의 복합 업무 생성·연결·명시적 실행·취소 |
agents:read | 자기 에이전트·동의한 협업·작업 조회 |
agents:manage | 자기 에이전트 등록·연결 회수 |
agents:collaborate | 협업 제안·양방향 요청·수신·응답 |
contracts:discover | 현재 저장 파트너의 실제 제안 읽기 |
contracts:receive | 별도 승인한 데이터 수신·원래 영수증·실제 로컬 JSON 조회 |